no-use-before-define

禁止在变量定义之前使用它们

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

在 ES6 中，块级绑定 (let 和 const) 引入了“暂时死区”，在其中，任何尝试在变量声明之前访问该变量都会抛出 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;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

此规则的**正确**代码示例

在 Playground 中打开

/*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 };
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

选项

{
    "no-use-before-define": ["error", {
        "functions": true,
        "classes": true,
        "variables": true,
        "allowNamedExports": false
    }]
}
1
2
3
4
5
6
7
8

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": false } 选项的**正确**代码示例

在 Playground 中打开

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

f();
function f() {}
1
2
3
4

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

类

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

在 Playground 中打开

/*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 {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

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

在 Playground 中打开

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

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

class A {
}
1
2
3
4
5
6
7
8

变量

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

在 Playground 中打开

/*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;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

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

在 Playground 中打开

/*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;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

allowNamedExports

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

在 Playground 中打开

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

export { a, b, f, C };

const a = 1;

let b;

function f () {}

class C {}
1
2
3
4
5
6
7
8
9
10
11

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

在 Playground 中打开

/*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;
1
2
3
4
5
6
7
8
9
10
11
12

版本

此规则在 ESLint v0.0.9 中引入。

资源

编辑此页面