id-match

要求識別符號符合指定的正規表示式

「在電腦科學中只有兩件難事：快取失效和命名事物。」— Phil Karlton

在專案中一致地命名事物是程式碼建立中經常被低估的一個方面。如果做得正確，它可以為您的團隊節省數小時不必要的絞盡腦汁和誤導。此規則可讓您精確定義並強制您的團隊應使用的變數和函式名稱。不再將自己限制於 camelCase、snake_case、PascalCase 或 HungarianNotation。Id-match 可以滿足您的所有需求！

規則詳情

此規則要求賦值和 function 定義中的識別符號符合指定的正規表示式。

選項

此規則有一個字串選項，用於指定正規表示式。

例如，要強制執行駝峰式命名慣例

{
    "id-match": ["error", "^[a-z]+([A-Z][a-z]+)*$"]
}
1
2
3

此規則使用 "^[a-z]+([A-Z][a-z]+)*$" 選項的不正確程式碼範例

在遊樂場中開啟

/*eslint id-match: ["error", "^[a-z]+([A-Z][a-z]+)*$"]*/

var my_favorite_color = "#112C85";
var _myFavoriteColor  = "#112C85";
var myFavoriteColor_  = "#112C85";
var MY_FAVORITE_COLOR = "#112C85";
function do_something() {
    // ...
}

class My_Class {}

class myClass {
    do_something() {}
}

class anotherClass {
    #do_something() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

此規則使用 "^[a-z]+([A-Z][a-z]+)*$" 選項的正確程式碼範例

在遊樂場中開啟

/*eslint id-match: ["error", "^[a-z]+([A-Z][a-z]+)*$"]*/

var myFavoriteColor   = "#112C85";
var foo = bar.baz_boom;
var foo = { qux: bar.baz_boom };
do_something();
var obj = {
    my_pref: 1
};

class myClass {}

class anotherClass {
    doSomething() {}
}

class oneMoreClass {
    #doSomething() {}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

此規則有一個物件選項

"properties": false (預設值) 不會檢查物件屬性
"properties": true 要求物件常值屬性和成員表達式賦值屬性符合指定的正規表示式
"classFields": false (預設值) 不會檢查類別欄位名稱
"classFields": true 要求類別欄位名稱符合指定的正規表示式
"onlyDeclarations": false (預設值) 要求所有變數名稱符合指定的正規表示式
"onlyDeclarations": true 僅要求 var、const、let、function 和 class 宣告符合指定的正規表示式
"ignoreDestructuring": false (預設值) 會對解構的識別符號強制執行 id-match
"ignoreDestructuring": true 不會檢查解構的識別符號

屬性

此規則使用 "^[a-z]+([A-Z][a-z]+)*$", { "properties": true } 選項的不正確程式碼範例

在遊樂場中開啟

/*eslint id-match: ["error", "^[a-z]+([A-Z][a-z]+)*$", { "properties": true }]*/

var obj = {
    my_pref: 1
};

obj.do_something = function() {
    // ...
};
1
2
3
4
5
6
7
8
9

類別欄位

此規則使用 "^[a-z]+([A-Z][a-z]+)*$", { "classFields": true } 選項的不正確程式碼範例

在遊樂場中開啟

/*eslint id-match: ["error", "^[a-z]+([A-Z][a-z]+)*$", { "classFields": true }]*/

class myClass {
    my_pref = 1;
}

class anotherClass {
    #my_pref = 1;
}
1
2
3
4
5
6
7
8
9

僅限宣告

此規則使用 "^[a-z]+([A-Z][a-z]+)*$", { "onlyDeclarations": true } 選項的正確程式碼範例

在遊樂場中開啟

/*eslint id-match: [2, "^[a-z]+([A-Z][a-z]+)*$", { "onlyDeclarations": true }]*/

foo = __dirname;
1
2
3

ignoreDestructuring: false

此規則使用預設值 "^[^_]+$", { "ignoreDestructuring": false } 選項的不正確程式碼範例

在遊樂場中開啟

/*eslint id-match: [2, "^[^_]+$", { "ignoreDestructuring": false }]*/

var { category_id } = query;

var { category_id = 1 } = query;

var { category_id: category_id } = query;

var { category_id: category_alias } = query;

var { category_id: categoryId, ...other_props } = query;
1
2
3
4
5
6
7
8
9
10
11

ignoreDestructuring: true

此規則使用 "^[^_]+$", { "ignoreDestructuring": true } 選項的不正確程式碼範例

在遊樂場中開啟

/*eslint id-match: [2, "^[^_]+$", { "ignoreDestructuring": true }]*/

var { category_id: category_alias } = query;

var { category_id, ...other_props } = query;
1
2
3
4
5

此規則使用 "^[^_]+$", { "ignoreDestructuring": true } 選項的正確程式碼範例

在遊樂場中開啟

/*eslint id-match: [2, "^[^_]+$", { "ignoreDestructuring": true }]*/

var { category_id } = query;

var { category_id = 1 } = query;

var { category_id: category_id } = query;
1
2
3
4
5
6
7

何時不應使用

如果您不想對所有識別符號強制執行任何特定的命名慣例，或者您的命名慣例過於複雜而無法透過設定此規則來強制執行，那麼您不應啟用此規則。

版本

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

資源

編輯此頁面