strict

要求或禁止使用严格模式指令

严格模式指令是脚本或函数体开头处的 "use strict" 字面量。它启用严格模式语义。

当指令出现在全局作用域中时，严格模式适用于整个脚本。

"use strict";

// strict mode

function foo() {
    // strict mode
}
1
2
3
4
5
6
7

当指令出现在函数体开头时，严格模式仅适用于该函数，包括所有包含的函数。

function foo() {
    "use strict";
    // strict mode
}

function foo2() {
    // not strict mode
};

(function() {
    "use strict";
    function bar() {
        // strict mode
    }
}());
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

在 CommonJS 模块系统中，一个隐藏的函数包装每个模块，并限制“全局”严格模式指令的作用域。

在 ECMAScript 模块中，始终具有严格模式语义，这些指令是多余的。

规则详细信息

此规则要求或禁止使用严格模式指令。

无论指定哪个选项，此规则都禁止使用严格模式指令，如果 ESLint 配置将以下任何一项指定为 解析器选项

• "sourceType": "module"，即文件是 ECMAScript 模块
• ecmaFeatures 对象中的 "impliedStrict": true 属性

无论指定哪个选项，此规则在具有非简单参数列表的函数中（例如，具有默认参数值的参数列表）禁止使用严格模式指令，因为这是 ECMAScript 2016 及更高版本中的语法错误。请参阅 function 选项的示例。

无论指定哪个选项，此规则不适用于类静态块，因为类静态块没有指令。因此，类静态块中的 "use strict" 语句不是指令，将由 no-unused-expressions 规则报告。

命令行上的 --fix 选项不会插入新的 "use strict" 语句，而只会删除不需要的语句。

选项

此规则具有字符串选项

• "safe"（默认）对应以下任何一个选项
  • 如果 ESLint 认为文件是 CommonJS 模块，则为 "global"
  • 否则为 "function"
• "global" 要求在全局作用域中使用一个严格模式指令（并禁止任何其他严格模式指令）。
• "function" 要求在每个顶级函数声明或表达式中使用一个严格模式指令（并禁止任何其他严格模式指令）。
• "never" 禁止使用严格模式指令。

safe

如果 ESLint 认为文件是 Node.js 或 CommonJS 模块（因为配置指定了以下任何一项），则 "safe" 选项对应于 "global" 选项

• 解析器选项 的 ecmaFeatures 对象中的 "globalReturn": true 属性

否则，"safe" 选项对应于 "function" 选项。请注意，如果在配置中显式指定了 "globalReturn": false，则无论指定的环境如何，"safe" 选项都将对应于 "function" 选项。

global

此规则使用 "global" 选项的 不正确 代码示例

/*eslint strict: ["error", "global"]*/

function foo() {
}
1
2
3
4

/*eslint strict: ["error", "global"]*/

function foo() {
    "use strict";
}
1
2
3
4
5

/*eslint strict: ["error", "global"]*/

"use strict";

function foo() {
    "use strict";
}
1
2
3
4
5
6
7

此规则使用 "global" 选项的 正确 代码示例

/*eslint strict: ["error", "global"]*/

"use strict";

function foo() {
}
1
2
3
4
5
6

function

此选项确保所有函数体都是严格模式代码，而全局代码不是。特别是如果构建步骤连接多个脚本，则一个脚本中的全局代码中的严格模式指令可能会无意中在另一个并非旨在为严格模式代码的脚本中启用严格模式。

此规则使用 "function" 选项的 不正确 代码示例

/*eslint strict: ["error", "function"]*/

"use strict";

function foo() {
}
1
2
3
4
5
6

/*eslint strict: ["error", "function"]*/

function foo() {
}

(function() {
    function bar() {
        "use strict";
    }
}());
1
2
3
4
5
6
7
8
9
10

/*eslint strict: ["error", "function"]*/

// Illegal "use strict" directive in function with non-simple parameter list.
// This is a syntax error since ES2016.
function foo(a = 1) {
    "use strict";
}

// We cannot write "use strict" directive in this function.
// So we have to wrap this function with a function with "use strict" directive.
function foo(a = 1) {
}
1
2
3
4
5
6
7
8
9
10
11
12

此规则使用 "function" 选项的 正确 代码示例

/*eslint strict: ["error", "function"]*/

function foo() {
    "use strict";
}

(function() {
    "use strict";

    function bar() {
    }

    function baz(a = 1) {
    }
}());

var foo = (function() {
    "use strict";

    return function foo(a = 1) {
    };
}());
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

never

此规则使用 "never" 选项的 不正确 代码示例

/*eslint strict: ["error", "never"]*/

"use strict";

function foo() {
}
1
2
3
4
5
6

/*eslint strict: ["error", "never"]*/

function foo() {
    "use strict";
}
1
2
3
4
5

此规则使用 "never" 选项的 正确 代码示例

/*eslint strict: ["error", "never"]*/

function foo() {
}
1
2
3
4

更早的默认值（已删除）

（已删除）此规则的默认选项（即未指定字符串选项）已在 ESLint v1.0 中 删除。"function" 选项与已删除的选项最相似。

此选项确保所有函数都在严格模式下执行。严格模式指令必须存在于全局代码中，或者存在于每个顶级函数声明或表达式中。它不关心嵌套函数中不必要的严格模式指令（这些函数已经是严格模式的），也不关心同一级别上的多个严格模式指令。

此规则使用已删除的早期默认选项的 不正确 代码示例

// "strict": "error"

function foo() {
}
1
2
3
4

// "strict": "error"

(function() {
    function bar() {
        "use strict";
    }
}());
1
2
3
4
5
6
7

此规则使用已删除的早期默认选项的 正确 代码示例

// "strict": "error"

"use strict";

function foo() {
}
1
2
3
4
5
6

// "strict": "error"

function foo() {
    "use strict";
}
1
2
3
4
5

// "strict": "error"

(function() {
    "use strict";
    function bar() {
        "use strict";
    }
}());
1
2
3
4
5
6
7
8

何时不使用它

在既有严格代码又有非严格代码的代码库中，请关闭此规则，或在必要时 选择性地禁用它。例如，引用 arguments.callee 的函数在严格模式下无效。有关 严格模式差异的完整列表，请访问 MDN。

版本

此规则是在 ESLint v0.1.0 中引入的。

资源

• 规则源代码
• 测试源代码