no-useless-rename

禁止将导入、导出和解构赋值重命名为相同名称

ES2015 允许在导入和导出语句以及解构赋值中重命名引用。这为程序员提供了一种简洁的语法来执行这些操作，同时重命名这些引用。

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

规则详情

此规则禁止将导入、导出和解构赋值重命名为相同名称。

选项

此规则允许使用以下选项进行更细粒度的控制。

• ignoreImport：设置为 true 时，此规则不检查导入。
• ignoreExport：设置为 true 时，此规则不检查导出。
• 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

何时不使用它

如果您不关心冗余地重命名导入、导出和解构赋值，则可以安全地禁用此规则。

兼容性

• JSCS：disallowIdenticalDestructuringNames

相关规则

• object-shorthand

版本

此规则在 ESLint v2.11.0 中引入。

资源

• 规则源代码
• 测试源代码