id-length

強制執行最小和最大識別符號長度

像 e、x、_t 這樣非常短的識別符號名稱，或像 hashGeneratorResultOutputContainerObject 這樣非常長的名稱，可能會使程式碼更難閱讀，並可能降低可維護性。為了防止這種情況，可以強制執行最小和/或最大識別符號長度。

var x = 5; // too short; difficult to understand its purpose without context
1

規則詳情

此規則強制執行最小和/或最大識別符號長度慣例。

此規則計算字形群組，而不是使用 String length。

選項

使用預設選項時，此規則的不正確程式碼範例

在遊樂場中開啟

/*eslint id-length: "error"*/     // default is minimum 2-chars ({ "min": 2 })

var x = 5;
obj.e = document.body;
var foo = function (e) { };
try {
    dangerousStuff();
} catch (e) {
    // ignore as many do
}
var myObj = { a: 1 };
(a) => { a * a };
class y { }
class Foo { x() {} }
class Bar { #x() {} }
class Baz { x = 1 }
class Qux { #x = 1 }
function bar(...x) { }
function baz([x]) { }
var [x] = arr;
var { prop: [x]} = {};
function qux({x}) { }
var { x } = {};
var { prop: a} = {};
({ prop: obj.x } = {});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

使用預設選項時，此規則的正確程式碼範例

在遊樂場中開啟

/*eslint id-length: "error"*/     // default is minimum 2-chars ({ "min": 2 })

var num = 5;
function _f() { return 42; }
function _func() { return 42; }
obj.el = document.body;
var foo = function (evt) { /* do stuff */ };
try {
    dangerousStuff();
} catch (error) {
    // ignore as many do
}
var myObj = { apple: 1 };
(num) => { num * num };
function bar(num = 0) { }
class MyClass { }
class Foo { method() {} }
class Bar { #method() {} }
class Baz { field = 1 }
class Qux { #field = 1 }
function baz(...args) { }
function qux([longName]) { }
var { prop } = {};
var { prop: [longName] } = {};
var [longName] = arr;
function foobar({ prop }) { }
function foobaz({ a: prop }) { }
var { prop } = {};
var { a: prop } = {};
({ prop: obj.longName } = {});
var data = { "x": 1 };  // excused because of quotes
data["y"] = 3;  // excused because of calculated property access
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

此規則有一個物件選項

"min"（預設值：2）強制執行最小識別符號長度
"max"（預設值：Infinity）強制執行最大識別符號長度
"properties": always（預設）對屬性名稱強制執行識別符號長度慣例
"properties": never 忽略屬性名稱的識別符號長度慣例
"exceptions" 允許指定識別符號名稱的陣列
"exceptionPatterns" 字串陣列，表示正規表示式模式，允許符合任何模式的識別符號。

min

使用 { "min": 4 } 選項時，此規則的不正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "min": 4 }]*/

var val = 5;
obj.e = document.body;
function foo (e) { };
try {
    dangerousStuff();
} catch (e) {
    // ignore as many do
}
var myObj = { a: 1 };
(val) => { val * val };
class y { }
class Foo { x() {} }
function bar(...x) { }
var { x } = {};
var { prop: a} = {};
var [x] = arr;
var { prop: [x]} = {};
({ prop: obj.x } = {});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

使用 { "min": 4 } 選項時，此規則的正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "min": 4 }]*/

var value = 5;
function func() { return 42; }
object.element = document.body;
var foobar = function (event) { /* do stuff */ };
try {
    dangerousStuff();
} catch (error) {
    // ignore as many do
}
var myObj = { apple: 1 };
(value) => { value * value };
function foobaz(value = 0) { }
class MyClass { }
class Foobar { method() {} }
function barbaz(...args) { }
var { prop } = {};
var [longName] = foo;
var { a: [prop] } = {};
var { a: longName } = {};
({ prop: object.name } = {});
var data = { "x": 1 };  // excused because of quotes
data["y"] = 3;  // excused because of calculated property access
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

max

使用 { "max": 10 } 選項時，此規則的不正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "max": 10 }]*/

var reallyLongVarName = 5;
function reallyLongFuncName() { return 42; }
obj.reallyLongPropName = document.body;
var foo = function (reallyLongArgName) { /* do stuff */ };
try {
    dangerousStuff();
} catch (reallyLongErrorName) {
    // ignore as many do
}
(reallyLongArgName) => { return !reallyLongArgName; };
var [reallyLongFirstElementName] = arr;
1
2
3
4
5
6
7
8
9
10
11
12
13

使用 { "max": 10 } 選項時，此規則的正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "max": 10 }]*/

var varName = 5;
function funcName() { return 42; }
obj.propName = document.body;
var foo = function (arg) { /* do stuff */ };
try {
    dangerousStuff();
} catch (error) {
    // ignore as many do
}
(arg) => { return !arg; };
var [first] = arr;
1
2
3
4
5
6
7
8
9
10
11
12
13

properties

使用 { "properties": "never" } 選項時，此規則的正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "properties": "never" }]*/

var myObj = { a: 1 };
({ a: obj.x.y.z } = {});
({ prop: obj.i } = {});
1
2
3
4
5

exceptions

使用 { "exceptions": ["x", "y", "z", "ζ"] } 選項時，此規則的額外正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "exceptions": ["x", "y", "z", "ζ"] }]*/

var x = 5;
function y() { return 42; }
obj.x = document.body;
var foo = function (x) { /* do stuff */ };
try {
    dangerousStuff();
} catch (x) {
    // ignore as many do
}
(x) => { return x * x; };
var [x] = arr;
const { z } = foo;
const { a: ζ } = foo;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

exceptionPatterns

使用 { "exceptionPatterns": ["E|S", "[x-z]"] } 選項時，此規則的額外正確程式碼範例

在遊樂場中開啟

/*eslint id-length: ["error", { "exceptionPatterns": ["E|S", "[x-z]"] }]*/

var E = 5;
function S() { return 42; }
obj.x = document.body;
var foo = function (x) { /* do stuff */ };
try {
    dangerousStuff();
} catch (x) {
    // ignore as many do
}
(y) => {return  y * y};
var [E] = arr;
const { y } = foo;
const { a: z } = foo;
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

版本

此規則是在 ESLint v1.0.0 中引入的。

資源

編輯此頁面

id-length

規則詳情

選項

min

max

properties

exceptions

exceptionPatterns

相關規則

版本

資源