Versions

no-import-assign

Disallow assigning to imported bindings

Recommended

The "extends": "eslint:recommended" property in a configuration file enables this rule

ES 模块对导入的绑定的更新会导致运行时错误。

规则细节

这条规则对导入的绑定的分配、增量和减量发出警告。

使用此规则的错误示例:

Open in Playground
/*eslint no-import-assign: "error"*/

import mod, { named } from "./mod.mjs"
import * as mod_ns from "./mod.mjs"

mod = 1          // ERROR: 'mod' is readonly.
named = 2        // ERROR: 'named' is readonly.
mod_ns.named = 3 // ERROR: The members of 'mod_ns' are readonly.
mod_ns = {}   // ERROR: 'mod_ns' is readonly.
// Can't extend 'mod_ns'
Object.assign(mod_ns, { foo: "foo" }) // ERROR: The members of 'mod_ns' are readonly.

使用此规则的正确示例:

Open in Playground
/*eslint no-import-assign: "error"*/

import mod, { named } from "./mod.mjs"
import * as mod_ns from "./mod.mjs"

mod.prop = 1
named.prop = 2
mod_ns.named.prop = 3

// Known Limitation
function test(obj) {
    obj.named = 4 // Not errored because 'obj' is not namespace objects.
}
test(mod_ns) // Not errored because it doesn't know that 'test' updates the member of the argument.

何时不用

如果你不希望被通知修改导入的绑定,你可以禁用这个规则。

Version

This rule was introduced in ESLint v6.4.0.

Resources

更改语言