no-import-assign

不允許賦值給匯入的綁定

✅

在設定檔中使用來自 @eslint/js 的 recommended 設定會啟用此規則

ES Modules 對匯入綁定的更新會導致執行階段錯誤。

規則詳情

此規則會警告對匯入綁定的賦值、遞增和遞減。

此規則的不正確程式碼範例

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

此規則的正確程式碼範例

在遊樂場中開啟

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

何時不使用

如果您不希望收到修改匯入綁定的通知，您可以停用此規則。

由 TypeScript 處理

當使用 TypeScript 時，停用此規則是安全的，因為 TypeScript 的編譯器會強制執行此檢查。

請注意，編譯器不會捕捉 Object.assign() 的情況。因此，如果您在程式碼庫中使用 Object.assign()，此規則仍然會提供一些價值。

版本

此規則在 ESLint v6.4.0 中引入。

資源

編輯此頁面