国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

Javascript編碼規(guī)范

enda / 364人閱讀

摘要:原文鏈接命名規(guī)范標(biāo)準(zhǔn)變量采用駝峰式命名在變量名中全大寫常量全大寫,用下劃線連接構(gòu)造函數(shù),大寫第一個字母對象必須以開頭命名局部變量命名規(guī)范表示字符串。可執(zhí)行不可執(zhí)行判斷是否含有某個值,函數(shù)返回一個布爾值。

原文鏈接

命名規(guī)范

標(biāo)準(zhǔn)變量采用駝峰式命名

‘ID’在變量名中全大寫

常量全大寫,用下劃線連接構(gòu)造函數(shù),大寫第一個字母

jquery對象必須以’$’開頭命名

let thisIsMyName;
let goodID;
let reportURL;
let AndroidVersion;
let iOSVersion;
let MAX_COUNT = 10;
function Person(name) {
this.name = name;
}
// not good
let body = $("body");
// good
let $body = $("body");
局部變量命名規(guī)范

s:表示字符串。例如:sName,sHtml;

n:表示數(shù)字。例如:nPage,nTotal;

b:表示邏輯。例如:bChecked,bHasLogin;

a:表示數(shù)組。例如:aList,aGroup;

r:表示正則表達(dá)式。例如:rDomain,rEmail;

f:表示函數(shù)。例如:fGetHtml,fInit;

o:表示以上未涉及到的其他對象,例如:oButton,oDate;

函數(shù)命名
小駝峰命名法,可使用常見動詞約定:

can 判斷是否可執(zhí)行某個動作,函數(shù)返回一個布爾值。true:可執(zhí)行;false:不可執(zhí)行

has 判斷是否含有某個值, 函數(shù)返回一個布爾值。true:含有此值;false:不含有此值

is 判斷是否為某個值,函數(shù)返回一個布爾值。true:為某個值;false:不為某個值

get 獲取某個之,函數(shù)返回一個非布爾值

set 設(shè)置某個值,無返回值、返回是否設(shè)置成功或者返回鏈?zhǔn)綄ο髄oad 加載某些數(shù)據(jù),無返回值或者返回是否加載完成的結(jié)果

// 是否可閱讀
function canRead() {
 return true;
}
// 獲取名稱
function getName() {
 return this.name;
}
引用 References 對所有的引用使用?const?;不要使用?var。

eslint: prefer-const, no-const-assign

這可以確保你無法對引用重新分配,重新分配可能會導(dǎo)致 bug 和難以理解的代碼。
// bad
var a = 1;
var b = 2;
// good
const a = 1;
const b = 2;
如果你一定需要可變動的引用,使用?let?代替?var?。

eslint: no-var jscs: disallowVar

// bad
var count = 1;
if (true) {
count += 1;
}
// good, 使用 let.
let count = 1;
if (true) {
count += 1;
}
對象Objects 使用字面量語法創(chuàng)建對象。

eslint: no-new-object

// bad
const item = new Object();
// good
const item = {};
當(dāng)創(chuàng)建帶有動態(tài)屬性名稱的對象時使用計(jì)算的屬性名稱。

它們允許你在一個地方定義一個對象的所有屬性。

function getKey(k) {
 return `a key named k`;
}
// bad
const obj = {
id: 5,
name: "San Francisco",
};
obj[getKey("enabled")] = true;
// good
const obj = {
    id: 5,
    name: "San Francisco",
    [getKey("enabled")]: true,
};
使用對象方法速記語法。

eslint: object-shorthand jscs: requireEnhancedObjectLiterals

// bad
const atom = {
value: 1,
addValue: function (value) {
    return atom.value + value;
  },
};
// good
const atom = {
value: 1,
addValue(value) {
    return atom.value + value;
  },
};
使用對象屬性速記語法。

eslint: object-shorthand jscs: requireEnhancedObjectLiterals

const lukeSkywalker = "Luke Skywalker";
// bad
const obj = {
  lukeSkywalker: lukeSkywalker,
};
// good
const obj = {
  lukeSkywalker,
};
將速記屬性分組寫在對象聲明的開始處
更容易看出哪些屬性在使用速記語法
const anakinSkywalker = "Anakin Skywalker";
const lukeSkywalker = "Luke Skywalker";
// bad
const obj = {
episodeOne: 1,
twoJediWalkIntoACantina: 2,
lukeSkywalker,
episodeThree: 3,
mayTheFourth: 4,
anakinSkywalker,
};
// good
const obj = {
lukeSkywalker,
anakinSkywalker,
episodeOne: 1,
twoJediWalkIntoACantina: 2,
episodeThree: 3,
mayTheFourth: 4,
};
只用引號引無效標(biāo)識符的屬性。

eslint: quote-props jscs: disallowQuotedKeysInObjects

一般來說,我們認(rèn)為比較容易閱讀。它改進(jìn)了語法高亮顯示,并且更容易被許多JS引擎優(yōu)化。
// bad
const bad = {
"foo": 3,
"bar": 4,
"data-blah": 5,
};
// good
const good = {
foo: 3,
bar: 4,
"data-blah": 5,
};
數(shù)組 Arrays 使用字面量創(chuàng)建數(shù)組。

eslint: no-array-constructor

// bad
const items = new Array();
// good
const items = [];
使用數(shù)組展開操作符 … 復(fù)制數(shù)組。
// bad
const len = items.length;
const itemsCopy = [];
let i;
for (i = 0; i < len; i += 1) {
itemsCopy[i] = items[i];
}
// good
const itemsCopy = [...items];
使用展開操作符 … 代替?Array.from,來將一個類數(shù)組(array-like) 對象轉(zhuǎn)換成數(shù)組。
const foo = document.querySelectorAll(".foo");
// good
const nodes = Array.from(foo);
// best
const nodes = [...foo];
實(shí)用?Array.from?代替展開操作符 … 來映射迭代,因?yàn)樗苊饬藙?chuàng)建媒介數(shù)組。
// bad
const baz = [...foo].map(bar);
// good
const baz = Array.from(foo, bar);
解構(gòu) Destructuring 當(dāng)訪問和使用對象的多個屬性時,請使用對象解構(gòu)。

eslint: prefer-destructuring jscs: requireObjectDestructuring

// bad
function getFullName(user) {
  const firstName = user.firstName;
  const lastName = user.lastName;
  return `firstName lastName`;
}
// good
function getFullName(user) {
  const { firstName, lastName } = user;
  return `firstName lastName`;
}
// best
function getFullName({ firstName, lastName }) {
  return `firstName lastName`;
}
使用數(shù)組解構(gòu)。

eslint: prefer-destructuring jscs: requireArrayDestructuring

const arr = [1, 2, 3, 4];
// bad
const first = arr[0];
const second = arr[1];
// good
const [first, second] = arr;
使用對象解構(gòu)來實(shí)現(xiàn)多個返回值,而不是數(shù)組解構(gòu)。jscs: disallowArrayDestructuringReturn
您可以隨著時間的推移添加新的屬性或更改排序,而不會改變調(diào)用時的位置。
// bad
function processInput(input) {
  return [left, right, top, bottom];
}
// 調(diào)用者需要考慮返回?cái)?shù)據(jù)的順序
const [left, __, top] = processInput(input);
// good
function processInput(input) {
  return { left, right, top, bottom };
}
// 調(diào)用者只選擇他們需要的數(shù)據(jù)
const { left, top } = processInput(input);
字符串 Strings 字符串使用單引號 ‘’。

eslint: quotes jscs: validateQuoteMarks

// bad
const name = "Capt. Janeway";
// bad - 模板字面量應(yīng)該包含插值或換行符
const name = `Capt. Janeway`;
// good
const name = "Capt. Janeway";
以編程方式構(gòu)建字符串時,請使用模板字符串而不是字符串連接。

eslint: prefer-template template-curly-spacing jscs: requireTemplateStrings

// bad
function sayHi(name) {
    return "How are you, " + name + "?";
}
// bad
function sayHi(name) {
    return ["How are you, ", name, "?"].join();
}
// bad
function sayHi(name) {
    return `How are you, ${ name }?`;
}
// good
function sayHi(name) {
     return `How are you, ${name}?`;
}
永遠(yuǎn)不要在字符串上使用?eval()?,它會打開太多的漏洞。

eslint: no-eval

函數(shù) Functions 使用命名函數(shù)表達(dá)式而不是函數(shù)聲明。

eslint: func-style jscs: disallowFunctionDeclarations

函數(shù)聲明很容易被提升(Hoisting),這對可讀性和可維護(hù)性來說都是不利的;
/ bad
function foo() {
  // ...
}
// bad
const foo = function () {
  // ...
};
// good 
// 用明顯區(qū)別于變量引用調(diào)用的詞匯命名
const short = function longUniqueMoreDescriptiveLexicalFoo() {
  // ...
};
用圓括號包裹立即調(diào)用函數(shù)表達(dá)式 (IIFE)。

eslint: wrap-iife jscs: requireParenthesesAroundIIFE

一個立即調(diào)用函數(shù)表達(dá)式是一個多帶帶的單元 – 將函數(shù)表達(dá)式包裹在括號中,后面再跟一個調(diào)用括號,這看上去很緊湊。
// 立即調(diào)用函數(shù)表達(dá)式 (IIFE)
(function () {
console.log("Welcome to the Internet. Please follow me.");
}());
不要使用?arguments。可以選擇 rest 語法 … 替代。
使用 … 能明確你要傳入的參數(shù)。另外 rest(剩余)參數(shù)是一個真正的數(shù)組,而 arguments 是一個類數(shù)組(Array-like)。
// bad
function concatenateAll() {
  const args = Array.prototype.slice.call(arguments);
  return args.join("");
}
// good
function concatenateAll(...args) {
  return args.join("");
}
使用默認(rèn)參數(shù)語法,而不要使用一個變化的函數(shù)參數(shù)
// really bad
function handleThings(opts) {
  // 更加糟糕: 如果參數(shù) opts 是 falsy(假值) 的話,它將被設(shè)置為一個對象,
  // 這可能是你想要的,但它可以引起一些小的錯誤。
  opts = opts || {};
  // ...
}
// still bad
function handleThings(opts) {
  if (opts === void 0) {
  opts = {};
}
// ...
}
// good
function handleThings(opts = {}) {
  // ...
}
始終將默認(rèn)參數(shù)放在最后。
// bad
function handleThings(opts = {}, name) {
// ...
}
// good
function handleThings(name, opts = {}) {
// ...
}
隔開函數(shù)簽名,括號兩邊用空格隔開。
// bad
const f = function(){};
const g = function (){};
const h = function() {};
// good
const x = function () {};
const y = function a() {};
不要改變參數(shù)。

eslint: no-param-reassign

操作作為參數(shù)傳入的對象,可能會在調(diào)用原始對象時造成不必要的變量副作用。(對象是引用類型)
// bad
function f1(obj) {
obj.key = 1;
}
// good
function f2(obj) {
  const key = Object.prototype.hasOwnProperty.call(obj, "key") ? obj.key : 1;
}
箭頭函數(shù) Arrow Functions 當(dāng)您必須使用匿名函數(shù)(如在傳遞一個內(nèi)聯(lián)回調(diào)時),請使用箭頭函數(shù)表示法。

eslint: prefer-arrow-callback, arrow-spacing jscs: requireArrowFunctions

它創(chuàng)建了一個在 this 上下文中執(zhí)行的函數(shù)的版本,這通常是你想要的,而且這樣的寫法更為簡潔。
// bad
[1, 2, 3].map(function (x) {
  const y = x + 1;
  return x * y;
});
// bad
[1, 2, 3].map( _ => {
  
  return 0;
});
// good
[1, 2, 3].map((x) => {
  const y = x + 1;
  return x * y;
});
// good
[1, 2, 3].map(() => {
  
  return 0;
});
如果函數(shù)體由一個返回?zé)o副作用(side effect)的expression(表達(dá)式)的單行語句組成,那么可以省略大括號并使用隱式返回。否則,保留大括號并使用 return 語句。
// bad
[1, 2, 3].map(number => {
const nextNumber = number + 1;
return `A string containing the nextNumber.`;
});
// good
[1, 2, 3].map(number => `A string containing the number.`);
如果表達(dá)式跨多行,將其包裹在括號中,可以提高可讀性。
// bad
["get", "post", "put"].map(httpMethod => Object.prototype.hasOwnProperty.call(
  httpMagicObjectWithAVeryLongName,
  httpMethod,
  )
);
// good
["get", "post", "put"].map(httpMethod => (
  Object.prototype.hasOwnProperty.call(
  httpMagicObjectWithAVeryLongName,
  httpMethod,
  )
));
如果你的函數(shù)只有一個參數(shù)并且不使用大括號,則可以省略參數(shù)括號。否則,為了清晰和一致性,總是給參數(shù)加上括號。
// bad
[1, 2, 3].map((x) => x * x);
// good
[1, 2, 3].map(x => x * x);
// good
[1, 2, 3].map(number => (
`A long string with the number. It’s so long that we don’t want it to take up space on the .map line!`
));
// 總是添加()
// bad
[1, 2, 3].map(x => {
  const y = x + 1;
  return x * y;
});
// good
[1, 2, 3].map((x) => {
  const y = x + 1;
  return x * y;
});
避免使用比較運(yùn)算符(< =, >=)時,混淆箭頭函數(shù)語法(=>)。
// bad
const itemHeight = item => item.height > 256 ? item.largeSize : item.smallSize;
// bad
const itemHeight = (item) => item.height > 256 ? item.largeSize : item.smallSize;
// good
const itemHeight = item => (item.height > 256 ? item.largeSize : item.smallSize);
// good
const itemHeight = (item) => {
  const { height, largeSize, smallSize } = item;
  return height > 256 ? largeSize : smallSize;
};
類 Classes & 構(gòu)造函數(shù) Constructors 總是使用?*class。避免直接操作?prototype?。
// 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 繼承。
因?yàn)?extends 是一個內(nèi)置的原型繼承方法并且不會破壞 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];
  }
}
如果沒有指定,類有一個默認(rèn)的構(gòu)造函數(shù)。一個空的構(gòu)造函數(shù)或者只是委托給父類則不是必須的。

eslint: no-useless-constructor

// bad
class Jedi {
  constructor() {}
  getName() {
    return this.name;
  }
}
// bad
class Rey extends Jedi {
  constructor(...args) {
    super(...args);
  }
}
// good
class Rey extends Jedi {
  constructor(...args) {
    super(...args);
    this.name = "Rey";
  }
}
避免重復(fù)類成員。

eslint: no-dupe-class-members

// bad
class Foo {
  bar() { return 1; }
  bar() { return 2; }
}
// good
class Foo {
  bar() { return 1; }
}
// good
class Foo {
  bar() { return 2; }
}
模塊 Modules 總是使用模塊 (import/export) 而不是其他非標(biāo)準(zhǔn)模塊系統(tǒng)。
// bad
const AirbnbStyleGuide = require("./AirbnbStyleGuide");
module.exports = AirbnbStyleGuide.es6;
// ok
import AirbnbStyleGuide from "./AirbnbStyleGuide";
export default AirbnbStyleGuide.es6;
// best
import { es6 } from "./AirbnbStyleGuide";
export default es6;
不要使用通配符 import(導(dǎo)入)。
這樣能確保你只有一個默認(rèn) export(導(dǎo)出)。
// bad
import * as AirbnbStyleGuide from "./AirbnbStyleGuide";
// good
import AirbnbStyleGuide from "./AirbnbStyleGuide";
不要從 import(導(dǎo)入) 中直接 export(導(dǎo)出)。
雖然一行代碼簡潔明了,但有一個明確的 import(導(dǎo)入) 方法和一個明確的 export(導(dǎo)出) 方法,使事情能保持一致。
// bad
// filename es6.js
export { es6 as default } from "./AirbnbStyleGuide";
// good
// filename es6.js
import { es6 } from "./AirbnbStyleGuide";
export default es6;
一個地方只在一個路徑中 import(導(dǎo)入) 。
// bad
import foo from "foo";
// … 其他一些 imports … //
import { named1, named2 } from "foo";
// good
import foo, { named1, named2 } from "foo";
// good
import foo, {
  named1,
  named2,
} from "foo";
不要 export(導(dǎo)出) 可變綁定。

eslint: import/no-mutable-exports

一般應(yīng)該避免可變性,特別是在導(dǎo)出可變綁定時。雖然一些特殊情況下,可能需要這種技術(shù),但是一般而言,只應(yīng)該導(dǎo)出常量引用。
// bad
let foo = 3;
export { foo };
// good
const foo = 3;
export { foo };
在只有單個導(dǎo)出的模塊中,默認(rèn) export(導(dǎo)出) 優(yōu)于命名 export(導(dǎo)出)。

eslint: import/prefer-default-export

為了鼓勵更多的文件只有一個 export(導(dǎo)出),這有利于模塊的可讀性和可維護(hù)性。
// bad
export function foo() {}
// good
export default function foo() {}
將所有 import 導(dǎo)入放在非導(dǎo)入語句的上面。

eslint: import/first

由于 import 被提升,保持他們在頂部,防止意外的行為。
// bad
import foo from "foo";
foo.init();
import bar from "bar";
// good
import foo from "foo";
import bar from "bar";
foo.init();
多行導(dǎo)入應(yīng)該像多行數(shù)組和對象字面量一樣進(jìn)行縮進(jìn)。
// bad
import {longNameA, longNameB, longNameC, longNameD, longNameE} from "path";
// good
import {
longNameA,
longNameB,
longNameC,
longNameD,
longNameE,
} from "path";
屬性 Properties 使用 點(diǎn)語法(.) 來訪問對象的屬性。

eslint: dot-notation jscs: requireDotNotation

const luke = {
jedi: true,
age: 28,
};
// bad
const isJedi = luke["jedi"];
// good
const isJedi = luke.jedi;
當(dāng)通過變量訪問屬性時使用中括號 []。
const luke = {
jedi: true,
age: 28,
};
function getProp(prop) {
return luke[prop];
}
const isJedi = getProp("jedi");
求冪時使用求冪運(yùn)算符 ** 。

eslint: no-restricted-properties.

// bad
const binary = Math.pow(2, 10);
// good
const binary = 2 ** 10;
變量 Variables 總是使用 const 或 let 來聲明變量。 不這樣做會導(dǎo)致產(chǎn)生全局變量。 我們希望避免污染全局命名空間。

eslint: no-undef prefer-const

// bad
superPower = new SuperPower();
// good
const superPower = new SuperPower();
將所有的 const 和 let 分組 。
當(dāng)你需要把已分配的變量分配給一個變量時非常有用
// bad
let i, len, dragonball,
items = getItems(),
goSportsTeam = true;
// bad
let i;
const items = getItems();
let dragonball;
const goSportsTeam = true;
let len;
// good
const goSportsTeam = true;
const items = getItems();
let dragonball;
let i;
let length;
變量不要鏈?zhǔn)劫x值。

eslint: no-multi-assign

鏈接變量賦值會創(chuàng)建隱式全局變量。
// bad
(function example() {
// JavaScript 將其解析為
// let a = ( b = ( c = 1 ) );
// let關(guān)鍵字只適用于變量a;
// 變量b和c變成了全局變量。
let a = b = c = 1;
}());
console.log(a); // 拋出 ReferenceError(引用錯誤)
console.log(b); // 1
console.log(c); // 1
// good
(function example() {
let a = 1;
let b = a;
let c = a;
}());
console.log(a); // 拋出 ReferenceError(引用錯誤)
console.log(b); // 拋出 ReferenceError(引用錯誤)
console.log(c); // 拋出 ReferenceError(引用錯誤)
// 同樣適用于 `const`
避免使用一元遞增和遞減運(yùn)算符(++, -–)。
根據(jù) eslint 文檔,一元遞增和遞減語句會受到自動插入分號的影響,并可能導(dǎo)致應(yīng)用程序中的值遞增或遞減,從而導(dǎo)致無提示錯誤。使用像 num += 1 而不是 num++ 或 num ++ 這樣的語句來改變你的值也更具有表現(xiàn)力。不允許一元遞增和遞減語句也會阻止您無意中預(yù)先遞增/遞減值,這也會導(dǎo)致程序中的意外行為。
// bad
const array = [1, 2, 3];
let num = 1;
num++;
--num;
let sum = 0;
let truthyCount = 0;
for (let i = 0; i < array.length; i++) { 
  let value = array[i]; 
  sum += value;
   if (value) {
      truthyCount++; 
    } 
 }
// good 
const array = [1, 2, 3]; 
let num = 1; num += 1; num -= 1; 
const sum = array.reduce((a, b) => a + b, 0);
const truthyCount = array.filter(Boolean).length;
比較運(yùn)算符 Comparison Operators 和 等號 Equality 使用 === 和 !== 優(yōu)先于 == 和 !=。

eslint: eqeqeq

對于布爾值使用簡寫,但對于字符串和數(shù)字使用顯式比較。
// bad
if (isValid === true) {
// ...
}
// good
if (isValid) {
// ...
}
// bad
if (name) {
// ...
}
// good
if (name !== "") {
// ...
}
// bad
if (collection.length) {
// ...
}
// good
if (collection.length > 0) {
// ...
}
在 case 和 default 子句中,使用大括號來創(chuàng)建包含詞法聲明的語句塊(例如 let, const, function, 和 class).

eslint: no-case-declarations

// bad
switch (foo) {
  case 1:
    let x = 1;
  break;
  case 2:
    const y = 2;
  break;
  case 3:
    function f() {
      // ...
    }
  break;
default:
  class C {}
}
// good
switch (foo) {
  case 1: {
    let x = 1;
    break;
  }
  case 2: {
    const y = 2;
    break;
  }
  case 3: {
    function f() {
      // ...
    }
    break;
  }
  case 4:
    bar();
    break;
  default: {
    class C {}
  }
}
三元表達(dá)式不應(yīng)該嵌套,通常寫成單行表達(dá)式。

eslint: no-nested-ternary

// bad
const foo = maybe1 > maybe2
? "bar"
: value1 > value2 ? "baz" : null;
// 拆分成2個分離的三元表達(dá)式
const maybeNull = value1 > value2 ? "baz" : null;
// better
const foo = maybe1 > maybe2
? "bar"
: maybeNull;
// best
const foo = maybe1 > maybe2 ? "bar" : maybeNull;
避免不必要的三元表達(dá)式語句。

eslint: no-unneeded-ternary

/ bad
const foo = a ? a : b;
const bar = c ? true : false;
const baz = c ? false : true;
// good
const foo = a || b;
const bar = !!c;
const baz = !c;
當(dāng)運(yùn)算符混合在一個語句中時,請將其放在括號內(nèi)?;旌纤阈g(shù)運(yùn)算符時,不要將 *?和 % 與 + , -,,/ 混合在一起。

eslint: no-mixed-operators

這可以提高可讀性,并清晰展現(xiàn)開發(fā)者的意圖。
/ bad
const foo = a && b < 0 || c > 0 || d + 1 === 0;
// bad
const bar = a ** b - 5 % d;
// bad
if (a || b && c) {
return d;
}
// good
const foo = (a && b < 0) || c > 0 || (d + 1 === 0);
// good
const bar = (a ** b) - (5 % d);
// good
if ((a || b) && c) {
return d;
}
// good
const bar = a + b / c * d;
代碼塊 Blocks 使用大括號包裹所有的多行代碼塊。

eslint: nonblock-statement-body-position

// bad
if (test)
  return false;
// good
if (test) return false;
// good
if (test) {
  return false;
}
// bad
function foo() { return false; }
// good
function bar() {
  return false;
}
如果通過 if 和 else 使用多行代碼塊,把 else 放在 if 代碼塊閉合括號的同一行。

eslint: brace-style

// bad
if (test) {
  thing1();
  thing2();
}
else {
  thing3();
}
// good
if (test) {
  thing1();
  thing2();
} else {
  thing3();
}
如果一個 if 塊總是執(zhí)行一個 return 語句,后面的 else 塊是不必要的。在 else if 塊中的 return,可以分成多個 if 塊來 return 。

eslint: no-else-return

// bad
function foo() {
  if (x) {
    return x;
  } else {
    return y;
  }
}
// bad
function cats() {
  if (x) {
    return x;
  } else if (y) {
    return y;
  }
}
// bad
function dogs() {
  if (x) {
    return x;
  } else {
  if (y) {
    return y;
  }
}
}
// good
function foo() {
  if (x) {
    return x;
  }
return y;
}
// good
function cats() {
  if (x) {
    return x;
  }
  if (y) {
    return y;
  }
}
//good
function dogs(x) {
  if (x) {
    if (z) {
      return y;
  }
} else {
  return z;
  }
}
控制語句 Control Statements 如果您的控制語句(if, while 的)太長或超過最大行長度,那么每個(分組)條件可以放多帶帶一行。邏輯運(yùn)算符應(yīng)該放在每行起始處。
// bad
if ((foo === 123 || bar === "abc") && doesItLookGoodWhenItBecomesThatLong() && isThisReallyHappening()) {
 thing1();
}
// bad
if (foo === 123 &&
  bar === "abc") {
  thing1();
}
// bad
if (foo === 123
  && bar === "abc") {
  thing1();
}
// bad
if (
  foo === 123 &&
  bar === "abc"
) {
  thing1();
}
// good
if (
  foo === 123
  && bar === "abc"
) {
  thing1();
}
// good
if (
  (foo === 123 || bar === "abc")
  && doesItLookGoodWhenItBecomesThatLong()
  && isThisReallyHappening()
) {
  thing1();
}
// good
if (foo === 123 && bar === "abc") {
  thing1();
}
注釋 Comments 多行注釋使用 /*?…?/。
/**
* @param {Grid} grid 需要合并的Grid
* @param {Array} cols 需要合并列的Index(序號)數(shù)組;從0開始計(jì)數(shù),序號也包含。
* @param {Boolean} isAllSome 是否2個tr的cols必須完成一樣才能進(jìn)行合并。true:完成一樣;false(默認(rèn)):不完全一樣
* @return void
* @author 單志永 2018/11/8
*/
function mergeCells(grid, cols, isAllSome) {
    // Do Something
}
單行注釋使用 // 。將單行注釋放在需注釋的語句上方。在注釋之前放置一個空行,除非它位于代碼塊的第一行。
// bad
const active = true;  // is current tab
// good
// is current tab
const active = true;
// bad
function getType() {
  console.log("fetching type...");
  // set the default type to "no type"
  const type = this.type || "no type";
  return type;
}
// good
function getType() {
  console.log("fetching type...");
  // set the default type to "no type"
  const type = this.type || "no type";
  return type;
}
// also good
function getType() {
  // set the default type to "no type"
  const type = this.type || "no type";
  return type;
}
所有注釋符和注釋內(nèi)容用一個空格隔開,讓它更容易閱讀。

eslint: spaced-comment

// bad
//is current tab
const active = true;
// good
// is current tab
const active = true;
// bad
/**
*make() returns a new element
*based on the passed-in tag name
*/
function make(tag) {
// ...
return element;
}
// good
/**
* make() returns a new element
* based on the passed-in tag name
*/
function make(tag) {
// ...
return element;
}
給注釋增加 FIXME 或 TODO 的前綴,可以幫助其他開發(fā)者快速了解這個是否是一個需要重新復(fù)查的問題,或是你正在為需要解決的問題提出解決方案。這將有別于常規(guī)注釋,因?yàn)樗鼈兪强刹僮鞯?。使?FIXME – need to figure this out 或者 TODO – need to implement。 使用 // FIXME: 來標(biāo)識需要修正的問題。注:如果代碼中有該標(biāo)識,說明標(biāo)識處代碼需要修正,甚至代碼是錯誤的,不能工作,需要修復(fù),如何修正會在說明中簡略說明。
lass Calculator extends Abacus {
  constructor() {
    super();
    // FIXME: shouldn’t use a global here
    total = 0;
  }
}
使用 // TODO: 來標(biāo)識需要實(shí)現(xiàn)的問題。注:如果代碼中有該標(biāo)識,說明在標(biāo)識處有功能代碼待編寫,待實(shí)現(xiàn)的功能在說明中會簡略說明。
class Calculator extends Abacus {
  constructor() {
    super();
    // TODO: total should be configurable by an options param
    this.total = 0;
  }
}
空格 Whitespace 使用 2 個空格作為縮進(jìn)
// bad
function foo() {
????let name;
}
// bad
function bar() {
?let name;
}
// good
function baz() {
??let name;
}
在大括號前放置 1 個空格。

eslint: space-before-blocks jscs: requireSpaceBeforeBlockStatements

// bad
function test(){
  console.log("test");
}
// good
function test() {
  console.log("test");
}
// bad
dog.set("attr",{
  age: "1 year",
  breed: "Bernese Mountain Dog",
});
// good
dog.set("attr", {
  age: "1 year",
  breed: "Bernese Mountain Dog",
});
在控制語句(if、while 等)的小括號前放一個空格。在函數(shù)調(diào)用及聲明中,不在函數(shù)的參數(shù)列表前加空格。

eslint: keyword-spacing jscs: requireSpaceAfterKeywords

// bad
if(isJedi) {
  fight ();
}
// good
if (isJedi) {
  fight();
}
// bad
function fight () {
  console.log ("Swooosh!");
}
// good
function fight() {
  console.log("Swooosh!");
}
使用空格把運(yùn)算符隔開。

eslint: space-infix-ops jscs: requireSpaceBeforeBinaryOperators, requireSpaceAfterBinaryOperators

// bad
const x=y+5;
// good
const x = y + 5;
在文件末尾插入一個空行。

eslint: eol-last

// bad
import { es6 } from "./AirbnbStyleGuide";
// ...
export default es6;

// bad
import { es6 } from "./AirbnbStyleGuide";
// ...
export default es6;

// good
import { es6 } from "./AirbnbStyleGuide";
// ...
export default es6;
長方法鏈?zhǔn)秸{(diào)用時使用縮進(jìn)(2個以上的方法鏈?zhǔn)秸{(diào)用)。使用一個點(diǎn) . 開頭,強(qiáng)調(diào)該行是一個方法調(diào)用,不是一個新的聲明。

eslint: newline-per-chained-call no-whitespace-before-property

// bad
$("#items").find(".selected").highlight().end().find(".open").updateCount();

// bad
$("#items").
find(".selected").
highlight().
end().
find(".open").
updateCount();

// good
$("#items")
.find(".selected")
.highlight()
.end()
.find(".open")
.updateCount();

// bad
const leds = stage.selectAll(".led").data(data).enter().append("svg:svg").classed("led", true)
.attr("width", (radius + margin) * 2).append("svg:g")
.attr("transform", `translate(${radius + margin},${radius + margin})`)
.call(tron.led);
// good
const leds = stage.selectAll(".led")
.data(data)
.enter().append("svg:svg")
.classed("led", true)
.attr("width", (radius + margin) * 2)
.append("svg:g")
.attr("transform", `translate(${radius + margin},${radius + margin})`)
.call(tron.led);

// good
const leds = stage.selectAll(".led").data(data);
不要在圓括號內(nèi)加空格。
// bad
function bar( foo ) {
  return foo;
}
// good
function bar(foo) {
  return foo;
}
// bad
if ( foo ) {
  console.log(foo);
}
// good
if (foo) {
  console.log(foo);
}
不要在中括號內(nèi)添加空格。

eslint: array-bracket-spacing jscs: disallowSpacesInsideArrayBrackets

// bad
const foo = [ 1, 2, 3 ];
console.log(foo[ 0 ]);
// good
const foo = [1, 2, 3];
console.log(foo[0]);
在大括號內(nèi)添加空格
// bad
const foo = {clark: "kent"};
// good
const foo = { clark: "kent" };
類型轉(zhuǎn)換 Type Casting & Coercion 在聲明語句的開始處就執(zhí)行強(qiáng)制類型轉(zhuǎn)換. 字符串:

eslint: no-new-wrappers

// => this.reviewScore = 9;
// bad
const totalScore = new String(this.reviewScore); // typeof totalScore 是 "object" 而不是 "string"
// bad
const totalScore = this.reviewScore + ""; // 調(diào)用 this.reviewScore.valueOf()
// bad
const totalScore = this.reviewScore.toString(); // 不能保證返回一個字符串
// good
const totalScore = String(this.reviewScore);
使數(shù)字: 使用 Number 進(jìn)行轉(zhuǎn)換,而 parseInt 則始終以基數(shù)解析字串。

eslint: radix no-new-wrappers

const inputValue = "4";
// bad
const val = new Number(inputValue);
// bad
const val = +inputValue;
// bad
const val = inputValue >> 0;
// bad
const val = parseInt(inputValue);
// good
const val = Number(inputValue);
// good
const val = parseInt(inputValue, 10);
布爾值:

eslint: no-new-wrappers

const age = 0;
// bad
const hasAge = new Boolean(age);
// good
const hasAge = Boolean(age);
// best
const hasAge = !!age;
命名規(guī)則 Naming Conventions 避免使用單字母名稱。使你的命名具有描述性。

eslint: id-length

// bad
function q() {
// ...
}
// good
function query() {
// ...
}
當(dāng)命名對象,函數(shù)和實(shí)例時使用駝峰式命名。

eslint: camelcase jscs: requireCamelCaseOrUpperCaseIdentifiers

// bad
const OBJEcttsssss = {};
const this_is_my_object = {};
function c() {}
// good
const thisIsMyObject = {};
function thisIsMyFunction() {}
當(dāng)命名構(gòu)造函數(shù)或類的時候使用 PascalCase 式命名,(注:即單詞首字母大寫)。

eslint: new-cap

// bad
function user(options) {
  this.name = options.name;
}
const bad = new user({
  name: "nope",
});
// good
class User {
  constructor(options) {
    this.name = options.name;
  }
}
const good = new User({
  name: "yup",
});
當(dāng) 導(dǎo)出(export) 一個默認(rèn)函數(shù)時使用駝峰式命名。你的文件名應(yīng)該和你的函數(shù)的名字一致。
function makeStyleGuide() {
// ...
}
export default makeStyleGuide;
當(dāng)導(dǎo)出一個 構(gòu)造函數(shù) / 類 / 單例 / 函數(shù)庫 / 純對象時使用 PascalCase 式命名,(愚人碼頭注:即單詞首字母大寫)。
const AirbnbStyleGuide = {
  es6: {
    },
};
export default AirbnbStyleGuide;
存取器 Accessors 屬性的存取器函數(shù)不是必須的。 別使用 JavaScript 的 getters/setters,因?yàn)樗鼈儠?dǎo)致意想不到的副作用,而且很難測試,維護(hù)和理解。相反,如果要使用存取器函數(shù),使用 getVal() 及 setVal(‘hello’)。
// bad
class Dragon {
  get age() {
    // ...
  }
  set age(value) {
    // ...
  }
}
// good
class Dragon {
  getAge() {
    // ...
  }
  setAge(value) {
    // ...
  }
}
如果屬性/方法是一個 boolean, 使用 isVal() 或 hasVal() 方法。
// bad
if (!dragon.age()) {
  return false;
}
// good
if (!dragon.hasAge()) {
  return false;
}

)

更多前端資源請關(guān)注微信公眾號“前端陌上寒”

文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請注明本文地址:http://specialneedsforspecialkids.com/yun/102178.html

相關(guān)文章

  • JavaScript 編碼規(guī)范

    摘要:這樣的變量增加了代碼量,并且混淆讀者。錯誤代碼示例變量雖然聲明了,但沒被使用持續(xù)更新 JavaScript 編碼規(guī)范 一、命名規(guī)范 1. 變量 命名方法:小駝峰式命名法(由小寫字母開始,后續(xù)每個單詞首字母都大寫) 命名建議:語義化的名詞 特殊:布爾值變量建議添加符合其含義的前綴動詞 is:是否 can:能不能 has:有沒有 示例: // 頁面標(biāo)題 let pageT...

    wenshi11019 評論0 收藏0
  • HTML編碼規(guī)范

    摘要:當(dāng)然我們還可以引入框架,這些框架一般都自帶模板處理引擎,比如等語義化命名和語義化標(biāo)簽我們盡量多采用語義化來命名,并且采用語義化標(biāo)簽來書寫代碼,多用中新增的標(biāo)簽來書寫。 1.黃金法則(Golden rule) 不管有多少人參與同一個項(xiàng)目,一定要確保每一行代碼都像是同一個人編寫的。 Every line of code should appear to be written by a si...

    nifhlheimr 評論0 收藏0
  • 在 React-CRA 應(yīng)用中配合 VSCode 使用 ESLint 實(shí)踐前端代碼規(guī)范

    摘要:編碼規(guī)范是獨(dú)角獸公司內(nèi)部的編碼規(guī)范,該項(xiàng)目是上很受歡迎的一個開源項(xiàng)目,在前端開發(fā)中使用廣泛,本文的配置規(guī)則就是以編碼規(guī)范和編碼規(guī)范作為基礎(chǔ)的。 更新時間:2019-01-22React.js create-react-app 項(xiàng)目 + VSCode 編輯器 + ESLint 代碼檢查工具 + Airbnb 編碼規(guī)范 前言 為什么要使用 ESLint 在項(xiàng)目開發(fā)過程中,編寫符合團(tuán)隊(duì)編碼規(guī)...

    Hujiawei 評論0 收藏0
  • 編碼規(guī)范 —— 編寫靈活、穩(wěn)定、高質(zhì)量的 HTML 和 CSS 代碼的規(guī)范

    摘要:用兩個空格代替制表符這是唯一能保證在所有環(huán)境下獲得一致展現(xiàn)的方法。編輯器配置將你的編輯器按照下面的配置進(jìn)行設(shè)置,以免常見的代碼不一致和差異用兩個空格代替制表符保存文件時刪除尾部的空白符設(shè)置文件編碼為在文件結(jié)尾添加一個空白行。 黃金定律 永遠(yuǎn)遵循同一套編碼規(guī)范 - 可以是這里列出的,也可以是你自己總結(jié)的。如果發(fā)現(xiàn)規(guī)范中有任何錯誤,敬請指正。 HTML 語法 用兩個空格代替制表符 (ta...

    Karuru 評論0 收藏0
  • 編碼規(guī)范-html.md

    摘要:寫在前面對于不同的編程語言來說,具體的編碼規(guī)范各不相同,但是其宗旨都是一致的,就是保證代碼在高質(zhì)量完成需求的同時具備良好的可讀性可維護(hù)性。減少標(biāo)簽的數(shù)量編寫代碼時,盡量避免多余的父元素。 寫在前面 對于不同的編程語言來說,具體的編碼規(guī)范各不相同,但是其宗旨都是一致的,就是保證代碼在高質(zhì)量完成需求的同時具備良好的可讀性、可維護(hù)性。 本文大部分內(nèi)容來自網(wǎng)上,僅供個人參考學(xué)習(xí)! 網(wǎng)絡(luò)上的知...

    tomlingtm 評論0 收藏0
  • 編寫靈活、穩(wěn)定、高質(zhì)量的HTML代碼的規(guī)范

    摘要:六字符編碼通過明確聲明字符編碼,能夠確保瀏覽器快速并容易的判斷頁面內(nèi)容的渲染方式。十一減少標(biāo)簽的數(shù)量編寫代碼時,盡量避免多余的父元素。未完待續(xù)編寫靈活穩(wěn)定高質(zhì)量的代碼的規(guī)范閱讀更多 一、唯一定律 無論有多少人共同參與同一項(xiàng)目,一定要確保每一行代碼都像是唯一個人編寫的。 二、HTML 2.1 語法 (1)用兩個空格來代替制表符(tab) -- 這是唯一能保證在所有環(huán)境下獲得一致展現(xiàn)的方法...

    anquan 評論0 收藏0

發(fā)表評論

0條評論

最新活動
閱讀需要支付1元查看
<