編程風格 · ECMAScript 6 入門

# 編程風格 1. [塊級作用域](http://es6.ruanyifeng.com/#docs/style#塊級作用域) 2. [字符串](http://es6.ruanyifeng.com/#docs/style#字符串) 3. [解構賦值](http://es6.ruanyifeng.com/#docs/style#解構賦值) 4. [對象](http://es6.ruanyifeng.com/#docs/style#對象) 5. [數組](http://es6.ruanyifeng.com/#docs/style#數組) 6. [函數](http://es6.ruanyifeng.com/#docs/style#函數) 7. [Map結構](http://es6.ruanyifeng.com/#docs/style#Map結構) 8. [Class](http://es6.ruanyifeng.com/#docs/style#Class) 9. [模塊](http://es6.ruanyifeng.com/#docs/style#模塊) 10. [ESLint的使用](http://es6.ruanyifeng.com/#docs/style#ESLint的使用) 本章探討如何將ES6的新語法，運用到編碼實踐之中，與傳統的JavaScript語法結合在一起，寫出合理的、易于閱讀和維護的代碼。多家公司和組織已經公開了它們的風格規范，具體可參閱[jscs.info](http://jscs.info/)，下面的內容主要參考了[Airbnb](https://github.com/airbnb/javascript)的JavaScript風格規范。 ## 塊級作用域 **（1）let取代var** ES6提出了兩個新的聲明變量的命令：`let`和`const`。其中，`let`完全可以取代`var`，因為兩者語義相同，而且`let`沒有副作用。 ~~~ 'use strict'; if (true) { let x = 'hello'; } for (let i = 0; i < 10; i++) { console.log(i); } ~~~ 上面代碼如果用`var`替代`let`，實際上就聲明了兩個全局變量，這顯然不是本意。變量應該只在其聲明的代碼塊內有效，`var`命令做不到這一點。 `var`命令存在變量提升效用，`let`命令沒有這個問題。 ~~~ 'use strict'; if(true) { console.log(x); // ReferenceError let x = 'hello'; } ~~~ 上面代碼如果使用`var`替代`let`，`console.log`那一行就不會報錯，而是會輸出`undefined`，因為變量聲明提升到代碼塊的頭部。這違反了變量先聲明后使用的原則。所以，建議不再使用`var`命令，而是使用`let`命令取代。 **（2）全局常量和線程安全** 在`let`和`const`之間，建議優先使用`const`，尤其是在全局環境，不應該設置變量，只應設置常量。這符合函數式編程思想，有利于將來的分布式運算。 ~~~ // bad var a = 1, b = 2, c = 3; // good const a = 1; const b = 2; const c = 3; // best const [a, b, c] = [1, 2, 3]; ~~~ `const`聲明常量還有兩個好處，一是閱讀代碼的人立刻會意識到不應該修改這個值，二是防止了無意間修改變量值所導致的錯誤。所有的函數都應該設置為常量。長遠來看，JavaScript可能會有多線程的實現（比如Intel的River Trail那一類的項目），這時`let`表示的變量，只應出現在單線程運行的代碼中，不能是多線程共享的，這樣有利于保證線程安全。 ## 字符串靜態字符串一律使用單引號或反引號，不使用雙引號。動態字符串使用反引號。 ~~~ // bad const a = "foobar"; const b = 'foo' + a + 'bar'; // acceptable const c = `foobar`; // good const a = 'foobar'; const b = `foo${a}bar`; const c = 'foobar'; ~~~ ## 解構賦值使用數組成員對變量賦值時，優先使用解構賦值。 ~~~ const arr = [1, 2, 3, 4]; // bad const first = arr[0]; const second = arr[1]; // good const [first, second] = arr; ~~~ 函數的參數如果是對象的成員，優先使用解構賦值。 ~~~ // bad function getFullName(user) { const firstName = user.firstName; const lastName = user.lastName; } // good function getFullName(obj) { const { firstName, lastName } = obj; } // best function getFullName({ firstName, lastName }) { } ~~~ 如果函數返回多個值，優先使用對象的解構賦值，而不是數組的解構賦值。這樣便于以后添加返回值，以及更改返回值的順序。 ~~~ // bad function processInput(input) { return [left, right, top, bottom]; } // good function processInput(input) { return { left, right, top, bottom }; } const { left, right } = processInput(input); ~~~ ## 對象單行定義的對象，最后一個成員不以逗號結尾。多行定義的對象，最后一個成員以逗號結尾。 ~~~ // bad const a = { k1: v1, k2: v2, }; const b = { k1: v1, k2: v2 }; // good const a = { k1: v1, k2: v2 }; const b = { k1: v1, k2: v2, }; ~~~ 對象盡量靜態化，一旦定義，就不得隨意添加新的屬性。如果添加屬性不可避免，要使用`Object.assign`方法。 ~~~ // bad const a = {}; a.x = 3; // if reshape unavoidable const a = {}; Object.assign(a, { x: 3 }); // good const a = { x: null }; a.x = 3; ~~~ 如果對象的屬性名是動態的，可以在創造對象的時候，使用屬性表達式定義。 ~~~ // bad const obj = { id: 5, name: 'San Francisco', }; obj[getKey('enabled')] = true; // good const obj = { id: 5, name: 'San Francisco', [getKey('enabled')]: true, }; ~~~ 上面代碼中，對象`obj`的最后一個屬性名，需要計算得到。這時最好采用屬性表達式，在新建`obj`的時候，將該屬性與其他屬性定義在一起。這樣一來，所有屬性就在一個地方定義了。另外，對象的屬性和方法，盡量采用簡潔表達法，這樣易于描述和書寫。 ~~~ var ref = 'some value'; // bad const atom = { ref: ref, value: 1, addValue: function (value) { return atom.value + value; }, }; // good const atom = { ref, value: 1, addValue(value) { return atom.value + value; }, }; ~~~ ## 數組使用擴展運算符（...）拷貝數組。 ~~~ // bad const len = items.length; const itemsCopy = []; let i; for (i = 0; i < len; i++) { itemsCopy[i] = items[i]; } // good const itemsCopy = [...items]; ~~~ 使用Array.from方法，將類似數組的對象轉為數組。 ~~~ const foo = document.querySelectorAll('.foo'); const nodes = Array.from(foo); ~~~ ## 函數立即執行函數可以寫成箭頭函數的形式。 ~~~ (() => { console.log('Welcome to the Internet.'); })(); ~~~ 那些需要使用函數表達式的場合，盡量用箭頭函數代替。因為這樣更簡潔，而且綁定了this。 ~~~ // bad [1, 2, 3].map(function (x) { return x * x; }); // good [1, 2, 3].map((x) => { return x * x; }); // best [1, 2, 3].map(x => x * x); ~~~ 箭頭函數取代`Function.prototype.bind`，不應再用self/_this/that綁定 this。 ~~~ // bad const self = this; const boundMethod = function(...params) { return method.apply(self, params); } // acceptable const boundMethod = method.bind(this); // best const boundMethod = (...params) => method.apply(this, params); ~~~ 簡單的、單行的、不會復用的函數，建議采用箭頭函數。如果函數體較為復雜，行數較多，還是應該采用傳統的函數寫法。所有配置項都應該集中在一個對象，放在最后一個參數，布爾值不可以直接作為參數。 ~~~ // bad function divide(a, b, option = false ) { } // good function divide(a, b, { option = false } = {}) { } ~~~ 不要在函數體內使用arguments變量，使用rest運算符（...）代替。因為rest運算符顯式表明你想要獲取參數，而且arguments是一個類似數組的對象，而rest運算符可以提供一個真正的數組。 ~~~ // bad function concatenateAll() { const args = Array.prototype.slice.call(arguments); return args.join(''); } // good function concatenateAll(...args) { return args.join(''); } ~~~ 使用默認值語法設置函數參數的默認值。 ~~~ // bad function handleThings(opts) { opts = opts || {}; } // good function handleThings(opts = {}) { // ... } ~~~ ## Map結構注意區分Object和Map，只有模擬現實世界的實體對象時，才使用Object。如果只是需要`key: value`的數據結構，使用Map結構。因為Map有內建的遍歷機制。 ~~~ let map = new Map(arr); for (let key of map.keys()) { console.log(key); } for (let value of map.values()) { console.log(value); } for (let item of map.entries()) { console.log(item[0], item[1]); } ~~~ ## Class 總是用Class，取代需要prototype的操作。因為Class的寫法更簡潔，更易于理解。 ~~~ // bad function Queue(contents = []) { this._queue = [...contents]; } Queue.prototype.pop = function() { const value = this._queue[0]; this._queue.splice(0, 1); return value; } // good class Queue { constructor(contents = []) { this._queue = [...contents]; } pop() { const value = this._queue[0]; this._queue.splice(0, 1); return value; } } ~~~ 使用`extends`實現繼承，因為這樣更簡單，不會有破壞`instanceof`運算的危險。 ~~~ // bad const inherits = require('inherits'); function PeekableQueue(contents) { Queue.apply(this, contents); } inherits(PeekableQueue, Queue); PeekableQueue.prototype.peek = function() { return this._queue[0]; } // good class PeekableQueue extends Queue { peek() { return this._queue[0]; } } ~~~ ## 模塊首先，Module語法是JavaScript模塊的標準寫法，堅持使用這種寫法。使用`import`取代`require`。 ~~~ // bad const moduleA = require('moduleA'); const func1 = moduleA.func1; const func2 = moduleA.func2; // good import { func1, func2 } from 'moduleA'; ~~~ 使用`export`取代`module.exports`。 ~~~ // commonJS的寫法 var React = require('react'); var Breadcrumbs = React.createClass({ render() { return <nav />; } }); module.exports = Breadcrumbs; // ES6的寫法 import React from 'react'; const Breadcrumbs = React.createClass({ render() { return <nav />; } }); export default Breadcrumbs ~~~ 如果模塊只有一個輸出值，就使用`export default`，如果模塊有多個輸出值，就不使用`export default`，不要`export default`與普通的`export`同時使用。不要在模塊輸入中使用通配符。因為這樣可以確保你的模塊之中，有一個默認輸出（export default）。 ~~~ // bad import * as myObject './importModule'; // good import myObject from './importModule'; ~~~ 如果模塊默認輸出一個函數，函數名的首字母應該小寫。 ~~~ function makeStyleGuide() { } export default makeStyleGuide; ~~~ 如果模塊默認輸出一個對象，對象名的首字母應該大寫。 ~~~ const StyleGuide = { es6: { } }; export default StyleGuide; ~~~ ## ESLint的使用 ESLint是一個語法規則和代碼風格的檢查工具，可以用來保證寫出語法正確、風格統一的代碼。首先，安裝ESLint。 ~~~ $ npm i -g eslint ~~~ 然后，安裝Airbnb語法規則。 ~~~ $ npm i -g eslint-config-airbnb ~~~ 最后，在項目的根目錄下新建一個`.eslintrc`文件，配置ESLint。 ~~~ { "extends": "eslint-config-airbnb" } ~~~ 現在就可以檢查，當前項目的代碼是否符合預設的規則。 `index.js`文件的代碼如下。 ~~~ var unusued = 'I have no purpose!'; function greet() { var message = 'Hello, World!'; alert(message); } greet(); ~~~ 使用ESLint檢查這個文件。 ~~~ $ eslint index.js index.js 1:5 error unusued is defined but never used no-unused-vars 4:5 error Expected indentation of 2 characters but found 4 indent 5:5 error Expected indentation of 2 characters but found 4 indent ? 3 problems (3 errors, 0 warnings) ~~~ 上面代碼說明，原文件有三個錯誤，一個是定義了變量，卻沒有使用，另外兩個是行首縮進為4個空格，而不是規定的2個空格。