no-restricted-syntax

禁止指定的语法

JavaScript 具有许多语言特性，并非每个人都喜欢所有这些特性。因此，一些项目选择完全禁止使用某些语言特性。例如，您可能决定禁止使用try-catch或class，或者您可能决定禁止使用in运算符。

此规则允许您配置要限制使用的语法元素，而不是为要关闭的每个语言特性创建单独的规则。这些元素由其ESTree节点类型表示。例如，函数声明由FunctionDeclaration表示，而with语句由WithStatement表示。您可以在GitHub 上找到您可以使用的 AST 节点名称的完整列表，并使用AST Explorer和 espree 解析器查看您的代码由哪些类型的节点组成。

您还可以指定AST 选择器来限制，从而允许对语法模式进行更精确的控制。

规则详情

此规则禁止指定的（即用户定义的）语法。

选项

此规则采用字符串列表，其中每个字符串都是一个 AST 选择器

{
    "rules": {
        "no-restricted-syntax": ["error", "FunctionExpression", "WithStatement", "BinaryExpression[operator='in']"]
    }
}
1
2
3
4
5

或者，该规则也接受对象，其中指定了选择器和可选的自定义消息

{
    "rules": {
        "no-restricted-syntax": [
            "error",
            {
                "selector": "FunctionExpression",
                "message": "Function expressions are not allowed."
            },
            {
                "selector": "CallExpression[callee.name='setTimeout'][arguments.length!=2]",
                "message": "setTimeout must always be invoked with two arguments."
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

如果使用message属性指定了自定义消息，则 ESLint 将在报告selector属性中指定的语法的出现时使用该消息。

根据需要，可以在配置中自由混合字符串和对象格式。

使用"FunctionExpression", "WithStatement", BinaryExpression[operator='in']选项的此规则的错误代码示例

在游乐场中打开

/* eslint no-restricted-syntax: ["error", "FunctionExpression", "WithStatement", "BinaryExpression[operator='in']"] */

with (me) {
    dontMess();
}

var doSomething = function () {};

foo in bar;
1
2
3
4
5
6
7
8
9

使用"FunctionExpression", "WithStatement", BinaryExpression[operator='in']选项的此规则的正确代码示例

在游乐场中打开

/* eslint no-restricted-syntax: ["error", "FunctionExpression", "WithStatement", "BinaryExpression[operator='in']"] */

me.dontMess();

function doSomething() {};

foo instanceof bar;
1
2
3
4
5
6
7

何时不使用它

如果您不想限制代码使用任何 JavaScript 功能或语法，则不应使用此规则。

版本

此规则是在 ESLint v1.4.0 中引入的。

资源

编辑此页面

no-restricted-syntax

规则详情

选项

何时不使用它

相关规则

版本

资源