29. ECMAScript 6 編碼樣式提示 #

本章列出一些與 ES6 編碼樣式相關的想法

• var 相對於 let 相對於 const（詳細說明請參閱變數章節）
  • 優先選擇 const。您可以將它用於所有值永遠不變的變數。
  • 否則，請使用 let – 對於值會變化的變數。
  • 避免使用 var。
• 每當函式符合單行時，箭頭函式是較佳的解決方案

    readFilePromisified(filename)
    .then(text => console.log(text))
  

  對於多行函式，傳統函式也能正常運作（但 this 不具字面意義）。

    readFilePromisified(filename)
    .then(function (text) {
        const obj = JSON.parse(text);
        console.log(JSON.stringify(obj, null, 4));
    });
  

  單行函式往往是拋棄式的。如果函式不是拋棄式的，傳統函式具有您可以為其命名的好處，這對於文件編寫和偵錯很有用。

• 物件文字中的屬性：一旦物件文字跨越多行，我便會在最後一個項目後加上逗號。這樣的尾隨逗號自 ES5 以來一直是合法的。它讓新增、移除和重新排列項目變得更簡單。因此，方法定義總是以 }, 結尾。

    const obj = {
        foo() {
        },
        bar() {
        },
    };
  

• 模組：不要混用預設匯出和命名匯出。您的模組應該專精於單一事物或匯出多個命名的東西。
  • 例外：具有預設匯出的模組，透過命名匯出公開一些內部結構（用於測試）。
  • 詳細說明請參閱模組章節。
• 格式化產生器如下

    // Generator function declaration
    function* genFunc() { ··· }
  
    // Generator function expression
    const genFunc = function* () { ··· };
  
    // Generator method definition in an object literal
    const obj = {
        * generatorMethod() {
            ···
        }
    };
  
    // Generator method definition in a class definition
    class MyClass {
        * generatorMethod() {
            ···
        }
    }
  

  詳細說明請參閱產生器章節。

• 參數處理章節有函式簽章的樣式提示

    // Mark optional parameters via the parameter default value `undefined`
    function foo(optional = undefined) { ··· }
  
    // Mark required parameters via a function that throws an exception
    function foo(required = throwException()) { ··· }
  
    // Enforcing a maximum arity (variant 1 of 2)
    function f(x, y, ...empty) { // max arity: 2
        if (empty.length > 0) {
            throw new Error();
        }
    }
    // Enforcing a maximum arity (variant 2 of 2)
    function f(x, y) { // max arity: 2
        if (arguments.length > 2) {
            throw new Error();
        }
    }
  

• 在可呼叫實體章節（傳統函式、箭頭函式、類別等）中，有一個章節提供建議（何時使用哪一個等）。

此外，「Speaking JavaScript」中的ES5 編碼樣式提示仍然適用於 ES6。