wrap-iife

要求在立即 function 呼叫周圍加上括號

您可以立即調用函式表達式，但不能調用函式宣告。建立立即調用函式表達式 (IIFE) 的常見技巧是用括號包住函式宣告。開頭的括號會使包含的函式被解析為表達式，而不是宣告。

// function expression could be unwrapped
var x = function () { return { y: 1 };}();

// function declaration must be wrapped
function () { /* side effects */ }(); // SyntaxError
1
2
3
4
5

規則詳情

此規則要求所有立即調用函式表達式都必須用括號包住。

選項

此規則有兩個選項，一個字串選項和一個物件選項。

字串選項

• "outside" 強制始終包住 *呼叫* 表達式。預設值為 "outside"。
• "inside" 強制始終包住 *函式* 表達式。
• "any" 強制始終包住，但允許任一種風格。

物件選項

• "functionPrototypeMethods": true 額外強制包住使用 .call 和 .apply 調用的函式表達式。預設值為 false。

outside

預設 "outside" 選項的 錯誤 程式碼範例

/*eslint wrap-iife: ["error", "outside"]*/

var x = function () { return { y: 1 };}(); // unwrapped
var x = (function () { return { y: 1 };})(); // wrapped function expression
1
2
3
4

預設 "outside" 選項的 正確 程式碼範例

/*eslint wrap-iife: ["error", "outside"]*/

var x = (function () { return { y: 1 };}()); // wrapped call expression
1
2
3

inside

"inside" 選項的 錯誤 程式碼範例

/*eslint wrap-iife: ["error", "inside"]*/

var x = function () { return { y: 1 };}(); // unwrapped
var x = (function () { return { y: 1 };}()); // wrapped call expression
1
2
3
4

"inside" 選項的 正確 程式碼範例

/*eslint wrap-iife: ["error", "inside"]*/

var x = (function () { return { y: 1 };})(); // wrapped function expression
1
2
3

any

"any" 選項的 錯誤 程式碼範例

/*eslint wrap-iife: ["error", "any"]*/

var x = function () { return { y: 1 };}(); // unwrapped
1
2
3

"any" 選項的 正確 程式碼範例

/*eslint wrap-iife: ["error", "any"]*/

var x = (function () { return { y: 1 };}()); // wrapped call expression
var x = (function () { return { y: 1 };})(); // wrapped function expression
1
2
3
4

functionPrototypeMethods

此規則搭配 "inside", { "functionPrototypeMethods": true } 選項的 錯誤 程式碼範例

/* eslint wrap-iife: [2, "inside", { functionPrototypeMethods: true }] */

var x = function(){ foo(); }()
var x = (function(){ foo(); }())
var x = function(){ foo(); }.call(bar)
var x = (function(){ foo(); }.call(bar))
1
2
3
4
5
6

此規則搭配 "inside", { "functionPrototypeMethods": true } 選項的 正確 程式碼範例

/* eslint wrap-iife: [2, "inside", { functionPrototypeMethods: true }] */

var x = (function(){ foo(); })()
var x = (function(){ foo(); }).call(bar)
1
2
3
4

版本

此規則在 ESLint v0.0.9 中引入。

資源

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