no-useless-rename

不允許將 import、export 和解構賦值重新命名為相同的名稱

ES2015 允許在 import 和 export 陳述式以及解構賦值中重新命名參考。這為程式設計師提供了一個簡潔的語法來執行這些操作，同時重新命名這些參考

import { foo as bar } from "baz";
export { foo as bar };
let { foo: bar } = baz;
1
2
3

使用此語法，可以將參考重新命名為相同的名稱。這是一個完全多餘的操作，因為這與根本不重新命名相同。例如，這個

import { foo as foo } from "bar";
export { foo as foo };
let { foo: foo } = bar;
1
2
3

與這個相同

import { foo } from "bar";
export { foo };
let { foo } = bar;
1
2
3

規則詳情

此規則不允許將 import、export 和解構賦值重新命名為相同的名稱。

選項

此規則允許使用以下選項進行更精細的控制

• ignoreImport：當設定為 true 時，此規則不會檢查 import
• ignoreExport：當設定為 true 時，此規則不會檢查 export
• ignoreDestructuring：當設定為 true 時，此規則不會檢查解構賦值

預設情況下，所有選項都設定為 false

"no-useless-rename": ["error", {
    "ignoreDestructuring": false,
    "ignoreImport": false,
    "ignoreExport": false
}]
1
2
3
4
5

此規則預設情況下錯誤程式碼的範例

/*eslint no-useless-rename: "error"*/

import { foo1 as foo1 } from "bar";
import { "foo2" as foo2 } from "bar";
export { foo1 as foo1 };
export { foo2 as "foo2" };
export { foo3 as foo3 } from "bar";
export { "foo4" as "foo4" } from "bar";
let { foo3: foo3 } = bar;
let { 'foo4': foo4 } = bar;
function foo({ bar: bar }) {}
({ foo: foo }) => {}
1
2
3
4
5
6
7
8
9
10
11
12

此規則預設情況下正確程式碼的範例

/*eslint no-useless-rename: "error"*/

import * as foo1 from "foo";
import { foo2 } from "bar";
import { foo as bar1 } from "baz";
import { "foo" as bar2 } from "baz";

export { foo };
export { foo as bar1 };
export { foo as "bar2" };
export { foo as bar3 } from "foo";
export { "foo" as "bar4" } from "foo";

let { foo } = bar;
let { foo: bar } = baz;
let { [qux]: qux } = bar;

function foo3({ bar }) {}
function foo4({ bar: baz }) {}

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

使用 { ignoreImport: true } 時，此規則正確程式碼的範例

/*eslint no-useless-rename: ["error", { ignoreImport: true }]*/

import { foo as foo } from "bar";
1
2
3

使用 { ignoreExport: true } 時，此規則正確程式碼的範例

/*eslint no-useless-rename: ["error", { ignoreExport: true }]*/

const foo = 1;
export { foo as foo };
export { bar as bar } from "bar";
1
2
3
4
5

使用 { ignoreDestructuring: true } 時，此規則正確程式碼的範例

/*eslint no-useless-rename: ["error", { ignoreDestructuring: true }]*/

let { foo: foo } = bar;
function baz({ bar: bar }) {}
({ foo: foo }) => {}
1
2
3
4
5

何時不使用它

如果您不關心多餘的重新命名 import、export 和解構賦值，您可以安全地禁用此規則。

相容性

• JSCS: disallowIdenticalDestructuringNames

相關規則

• object-shorthand

版本

此規則是在 ESLint v2.11.0 中引入的。

資源

• 規則原始碼
• 測試原始碼