JavaScript編程規(guī)范

1. 聲明(塊級作用域)

(1)let取代var

'use strict';

if (true) {
  let x = 'hello';
}

for (let i = 0; i < 10; i++) {
  console.log(i);
}
  • 上面代碼如果用var替代let杈抢,實際上就聲明了兩個全局變量,這顯然不是本意仑性。變量應該只在其聲明的代碼塊內(nèi)有效惶楼,var命令做不到這一點;var命令存在變量提升效用,let命令沒有這個問題
'use strict';

if (true) {
  console.log(x); // ReferenceError
  let x = 'hello';
}
  • 上面代碼如果使用var替代let歼捐,console.log那一行就不會報錯何陆,而是會輸出undefined,因為變量聲明提升到代碼塊的頭部豹储。這違反了變量先聲明后使用的原則。
  • 建議不再使用var命令剥扣,而是使用let命令取代

(2)全局常量和線程安全

  • const優(yōu)于let有幾個原因:
    • const可以提醒閱讀程序的人钠怯,這個變量不應該改變
    • const比較符合函數(shù)式編程思想呻疹,運算不改變值,只是新建值镊尺,而且這樣也有利于將來的分布式運算
    • JavaScript 編譯器會對const進行優(yōu)化并思,所以多使用const宋彼,有利于提高程序的運行效率,也就是說let和const的本質區(qū)別音婶,其實是編譯器內(nèi)部的處理不同
  • 所有的函數(shù)都應該設置為常量

2. 字符串

  • 靜態(tài)字符串一律使用單引號或反引號,不使用雙引號衣式。動態(tài)字符串使用反引號檐什。
// 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`;

3. 結構賦值

  • 使用數(shù)組成員對變量賦值時,優(yōu)先使用解構賦值住册。
const arr = [1, 2, 3, 4, 5];

// bad
const first = arr[0];
const second = arr[1];

// good
const [first, second] = arr;
  • 函數(shù)的參數(shù)如果是對象的成員荧飞,優(yōu)先使用解構賦值垢箕。
// 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}) {
    
}

4. 對象

  • 單行定義的對象条获,最后一個成員不以逗號結尾蒋歌。多行定義的對象堂油,最后一個成員以逗號結尾
// bed
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,
}
  • 對象盡量靜態(tài)化府框,一旦定義迫靖,就不得隨意添加新的屬性。如果添加屬性不可避免照激,要使用Object.assign方法俩垃。
// bad
const a = {};
a.x = 3;

// if reshape unavoidable
const a = {};
Object.assign(a, {x: 2});

// good
const a = {x: null};
a.x = 3;
  • 對象的屬性和方法口柳,盡量采用簡潔表達法有滑,這樣易于描述和書寫
let ref = 'some value';

// bad
const atom = {
    ref: ref,
    value: 1,
    addValue: function (value) {
        return atom.value + vlaue
    },
};

// good
const atom = {
    ref,
    
    value: 1,
    
    addValue(value) {
        return atom.value + value
    }
}

5. 數(shù)組

  • 使用擴展運算符(...)拷貝數(shù)組
// 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 方法俺孙,將類似數(shù)組的對象轉為數(shù)組
const foo = document.querySelectorAll('.foo');
const nodes = Array.from(foo);

6. 函數(shù)

  • 立即執(zhí)行函數(shù)可以寫成箭頭函數(shù)的形式
(() => {
    console.log('Welcome to the Internet.')
})();
  • 那些需要使用函數(shù)表達式的場合睛榄,盡量用箭頭函數(shù)代替。因為這樣更簡潔场靴,而且綁定了 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);
  • 箭頭函數(shù)取代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);
  • 所有配置項都應該集中在一個對象咧欣,放在最后一個參數(shù)魄咕,布爾值不可以直接作為參數(shù)
// bad
function divide(a, b, option = false ) {
}

// good
function divide(a, b, { option = false } = {}) {
}
  • 不要在函數(shù)體內(nèi)使用 arguments 變量哮兰,使用 rest 運算符(...)代替喝滞。因為 rest 運算符顯式表明你想要獲取參數(shù),而且 arguments 是一個類似數(shù)組的對象做盅,而 rest 運算符可以提供一個真正的數(shù)組
// bad
function concatenateAll() {
  const args = Array.prototype.slice.call(arguments);
  return args.join('');
}

// good
function concatenateAll(...args) {
  return args.join('');
}
  • 使用默認值語法設置函數(shù)參數(shù)的默認值吹榴。
// bad
function handleThings(opts) {
  opts = opts || {};
}

// good
function handleThings(opts = {}) {
  // ...
}

7. Map 結構

  • 注意區(qū)分 Object 和 Map宵距,只有模擬現(xiàn)實世界的實體對象時满哪,才使用 Object哨鸭。如果只是需要key: value的數(shù)據(jù)結構,使用 Map 結構像鸡。因為 Map 有內(nèi)建的遍歷機制活鹰。
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],itme[1])
}

8. 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實現(xiàn)繼承,因為這樣更簡單攻冷,不會有破壞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];
  }
}

9. 模塊

  • 首先,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';

class Breadcrumbs extends React.Component {
  render() {
    return <nav />;
  }
};

export default Breadcrumbs;
  • 如果模塊只有一個輸出值,就使用export default陪竿,如果模塊有多個輸出值弟灼,就不使用export default,export default與普通的export不要同時使用疏叨。
  • 不要在模塊輸入中使用通配符。因為這樣可以確保你的模塊之中昌粤,有一個默認輸出(export default)既绕。
// bad
import * as myObject from './importModule';

// good
import myObject from './importModule';
  • 如果模塊默認輸出一個函數(shù),函數(shù)名的首字母應該小寫涮坐。
function makeStyleGuide() {
}

export default makeStyleGuide;- ESLint 是一個語法規(guī)則和代碼風格的檢查工具,可以用來保證寫出語法正確、風格統(tǒng)一的代碼。
  • 如果模塊默認輸出一個對象,對象名的首字母應該大寫。
const StyleGuide = {
  es6: {
  }
};

export default StyleGuide;
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末屡谐,一起剝皮案震驚了整個濱河市籽前,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌众羡,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,126評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件蓖租,死亡現(xiàn)場離奇詭異粱侣,居然都是意外死亡羊壹,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評論 2 382
  • 文/潘曉璐 我一進店門齐婴,熙熙樓的掌柜王于貴愁眉苦臉地迎上來油猫,“玉大人,你說我怎么就攤上這事柠偶∏檠” “怎么了?”我有些...
    開封第一講書人閱讀 152,445評論 0 341
  • 文/不壞的土叔 我叫張陵诱担,是天一觀的道長毡证。 經(jīng)常有香客問我,道長蔫仙,這世上最難降的妖魔是什么料睛? 我笑而不...
    開封第一講書人閱讀 55,185評論 1 278
  • 正文 為了忘掉前任,我火速辦了婚禮摇邦,結果婚禮上秦效,老公的妹妹穿的比我還像新娘。我一直安慰自己涎嚼,他們只是感情好,可當我...
    茶點故事閱讀 64,178評論 5 371
  • 文/花漫 我一把揭開白布挑秉。 她就那樣靜靜地躺著法梯,像睡著了一般。 火紅的嫁衣襯著肌膚如雪犀概。 梳的紋絲不亂的頭發(fā)上立哑,一...
    開封第一講書人閱讀 48,970評論 1 284
  • 那天,我揣著相機與錄音姻灶,去河邊找鬼铛绰。 笑死,一個胖子當著我的面吹牛产喉,可吹牛的內(nèi)容都是我干的捂掰。 我是一名探鬼主播,決...
    沈念sama閱讀 38,276評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼曾沈,長吁一口氣:“原來是場噩夢啊……” “哼这嚣!你這毒婦竟也來了?” 一聲冷哼從身側響起塞俱,我...
    開封第一講書人閱讀 36,927評論 0 259
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎障涯,沒想到半個月后膳汪,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,400評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡遗嗽,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,883評論 2 323
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了颤霎。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 37,997評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡友酱,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出缔杉,到底是詐尸還是另有隱情,我是刑警寧澤或详,帶...
    沈念sama閱讀 33,646評論 4 322
  • 正文 年R本政府宣布系羞,位于F島的核電站霸琴,受9級特大地震影響,放射性物質發(fā)生泄漏梧乘。R本人自食惡果不足惜澎迎,卻給世界環(huán)境...
    茶點故事閱讀 39,213評論 3 307
  • 文/蒙蒙 一夹供、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧仁堪,春花似錦哮洽、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,204評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至莺葫,卻和暖如春剔桨,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背徙融。 一陣腳步聲響...
    開封第一講書人閱讀 31,423評論 1 260
  • 我被黑心中介騙來泰國打工洒缀, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 45,423評論 2 352
  • 正文 我出身青樓树绩,卻偏偏與公主長得像萨脑,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子饺饭,可洞房花燭夜當晚...
    茶點故事閱讀 42,722評論 2 345

推薦閱讀更多精彩內(nèi)容