no-const-assign

禁止重新分配 const、using 和 await using 变量

常量绑定无法被修改。尝试修改常量绑定将引发运行时错误。

🌐 Constant bindings cannot be modified. An attempt to modify a constant binding will raise a runtime error.

规则详情

🌐 Rule Details

此规则旨在标记使用 const、using 或 await using 关键字声明的修改变量。

🌐 This rule is aimed to flag modifying variables that are declared using const, using, or await using keywords.

此规则的错误代码示例：

🌐 Examples of incorrect code for this rule:

/*eslint no-const-assign: "error"*/

const a = 0;
a = 1;
1
2
3
4

/*eslint no-const-assign: "error"*/

const a = 0;
a += 1;
1
2
3
4

/*eslint no-const-assign: "error"*/

const a = 0;
++a;
1
2
3
4

/*eslint no-const-assign: "error"*/

if (foo) {
	using a = getSomething();
	a = somethingElse;
}

if (bar) {
	await using a = getSomething();
	a = somethingElse;
}
1
2
3
4
5
6
7
8
9
10
11

符合此规则的正确代码示例：

🌐 Examples of correct code for this rule:

/*eslint no-const-assign: "error"*/

const a = 0;
console.log(a);
1
2
3
4

/*eslint no-const-assign: "error"*/

if (foo) {
	using a = getSomething();
	a.execute();
}

if (bar) {
	await using a = getSomething();
	a.execute();
}
1
2
3
4
5
6
7
8
9
10
11

/*eslint no-const-assign: "error"*/

for (const a in [1, 2, 3]) { // `a` is re-defined (not modified) on each loop step.
    console.log(a);
}
1
2
3
4
5

/*eslint no-const-assign: "error"*/

for (const a of [1, 2, 3]) { // `a` is re-defined (not modified) on each loop step.
    console.log(a);
}
1
2
3
4
5

选项

🌐 Options

此规则没有选项。

🌐 This rule has no options.

何时不使用

🌐 When Not To Use It

如果你不想收到关于修改使用 const、using 和 await using 关键字声明的变量的通知，你可以安全地禁用此规则。

🌐 If you don’t want to be notified about modifying variables that are declared using const, using, and await using keywords, you can safely disable this rule.

由 TypeScript 处理

使用 TypeScript 时禁用此规则是安全的，因为 TypeScript 的编译器强制执行此检查。

版本

此规则是在 ESLint v1.0.0-rc-1 中引入。

资源

• 规则源码
• 测试源码