# no-use-before-define

在定义之前禁止使用变量

在 JavaScript 中，在 ES6 之前，变量和函数声明被提升到作用域的顶部，因此可以在代码中的正式声明之前使用标识符。这可能会令人困惑，有些人认为最好在使用变量和函数之前始终声明它们。

在 ES6 中，块级绑定（let 和 const）引入了一个 "temporal dead zone"，其中一个 ReferenceError 将被抛出，任何尝试在声明之前访问该变量。

# 规则详情

当遇到对尚未声明的标识符的引用时，此规则将发出警告。

此规则的错误代码示例：

/*eslint no-use-before-define: "error"*/

alert(a);
var a = 10;

f();
function f() {}

function g() {
    return b;
}
var b = 1;

{
    alert(c);
    let c = 1;
}

{
    class C extends C {}
}

{
    class C {
        static x = "foo";
        [C.x]() {}
    }
}

{
    const C = class {
        static x = C;
    }
}

{
    const C = class {
        static {
            C.x = "foo";
        }
    }
}

export { foo };
const foo = 1;

此规则的正确代码示例：

/*eslint no-use-before-define: "error"*/

var a;
a = 10;
alert(a);

function f() {}
f(1);

var b = 1;
function g() {
    return b;
}

{
    let c;
    c++;
}

{
    class C {
        static x = C;
    }
}

{
    const C = class C {
        static x = C;
    }
}

{
    const C = class {
        x = C;
    }
}

{
    const C = class C {
        static {
            C.x = "foo";
        }
    }
}

const foo = 1;
export { foo };

# 选项

{
    "no-use-before-define": ["error", {
        "functions": true,
        "classes": true,
        "variables": true,
        "allowNamedExports": false
    }]
}

functions (boolean) - 显示此规则是否检查函数声明的标志。如果这是 true，则此规则会在函数声明之前警告对函数的每个引用。否则，忽略这些引用。函数声明被提升，所以它是安全的。默认为 true。
classes (boolean) - 显示此规则是否检查上层范围的类声明的标志。如果这是 true，则此规则会在类声明之前警告对类的每个引用。否则，如果声明在上层函数范围内，则忽略这些引用。类声明没有被提升，所以它可能是危险的。默认为 true。
variables (boolean) - 此标志确定规则是否检查上层范围内的变量声明。如果这是 true，则规则会在变量声明之前警告对变量的每个引用。否则，如果声明在上层范围内，则规则忽略引用，而如果引用与声明在同一范围内，则仍报告引用。默认为 true。
allowNamedExports (boolean) - 如果此标志设置为 true，则规则始终允许在 export {}; 声明中引用。即使稍后在代码中声明变量，这些引用也是安全的。默认为 false。

此规则接受 "nofunc" 字符串作为选项。"nofunc" 与 { "functions": false, "classes": true, "variables": true, "allowNamedExports": false } 相同。

# functions

{ "functions": false } 选项的正确代码示例：

/*eslint no-use-before-define: ["error", { "functions": false }]*/

f();
function f() {}

此选项允许引用函数声明。对于函数表达式和箭头函数，请参见 variables 选项。

# classes

{ "classes": false } 选项的错误代码示例：

/*eslint no-use-before-define: ["error", { "classes": false }]*/

new A();
class A {
}

{
    class C extends C {}
}

{
    class C extends D {}
    class D {}
}

{
    class C {
        static x = "foo";
        [C.x]() {}
    }
}

{
    class C {
        static {
            new D();
        }
    }
    class D {}
}

{ "classes": false } 选项的正确代码示例：

/*eslint no-use-before-define: ["error", { "classes": false }]*/

function foo() {
    return new A();
}

class A {
}

# variables

{ "variables": false } 选项的错误代码示例：

/*eslint no-use-before-define: ["error", { "variables": false }]*/

console.log(foo);
var foo = 1;

f();
const f = () => {};

g();
const g = function() {};

{
    const C = class {
        static x = C;
    }
}

{
    const C = class {
        static x = foo;
    }
    const foo = 1;
}

{
    class C {
        static {
            this.x = foo;
        }
    }
    const foo = 1;
}

{ "variables": false } 选项的正确代码示例：

/*eslint no-use-before-define: ["error", { "variables": false }]*/

function baz() {
    console.log(foo);
}
var foo = 1;

const a = () => f();
function b() { return f(); }
const c = function() { return f(); }
const f = () => {};

const e = function() { return g(); }
const g = function() {}

{
    const C = class {
        x = foo;
    }
    const foo = 1;
}

# allowNamedExports

{ "allowNamedExports": true } 选项的正确代码示例：

/*eslint no-use-before-define: ["error", { "allowNamedExports": true }]*/

export { a, b, f, C };

const a = 1;

let b;

function f () {}

class C {}

{ "allowNamedExports": true } 选项的错误代码示例：

/*eslint no-use-before-define: ["error", { "allowNamedExports": true }]*/

export default a;
const a = 1;

const b = c;
export const c = 1;

export function foo() {
    return d;
}
const d = 1;

← no-unused-vars no-useless-backreference →