欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

詳解一些適用于Node.js的命名約定

 更新時間:2019年12月08日 10:32:00   作者:Liutos  
這篇文章主要介紹了詳解一些適用于Node.js的命名約定,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

序言

There are only two hard things in Computer Science: cache invalidation and naming things.
-- Phil Karlton

我喬魯諾·喬巴拿有一個夢想,便是要成為程序員巨星。但如果你看過我寫的代碼,便知道我還遠遠夠不上“巨星”二字。我的代碼中有許多不一致的命名:

  1. 常量的命名時而是全大寫的(如WAIT_CONFIRM),時而是全小寫的;
  2. 某個項目大部分命名用的是camel case(如TaskController),但由于數(shù)據(jù)庫中的列名用了snake case(如context_id),導致項目中與數(shù)據(jù)庫列有關的代碼混用了camel case和snake case(如restricted_hours[new Date(timestamp * 1000).getHours()] = 1;);
  3. 同樣是構造復雜對象的函數(shù),它們的前綴可能會是build、create、make,甚至compute中的任何一個;
  4. 明明是一個數(shù)組,卻用了單數(shù)的order作為變量名。

之所以如此混亂,正是因為我沒有遵循一套一致的命名規(guī)則。每當我在一個項目中蹦出一些新想法時,便會躍躍欲試——不,我真的就用上了。我不曾整理過自己的命名規(guī)則(天哪我已經(jīng)寫了三年的JavaScript了),以至于無從判斷“新想法”是否真的新——也許它是一個已經(jīng)被我拋棄的規(guī)則。

為了不再深陷不一致命名的泥潭,我定下了本篇的命名規(guī)則,期望它們?yōu)橐院蟮奈抑更c迷津。

變量名

通用規(guī)則

  • 變量名使用camel case的命名風格。例如,使用namingConvention,而不是naming_convention;
  • 在盡量遵循規(guī)則的基礎上隨機應變。

變量名的單復數(shù)規(guī)則

  • 如果一個變量存儲的值的類型為數(shù)組(即該變量作為Array.isArray方法的參數(shù)時結果為真),那么變量的名稱就使用復數(shù)形式。例如,使用fruits = []而不是fruit = []。
  • 如果一個變量存儲的值的類型為集合(即Set這個類型),那么變量的名稱應當使用單詞unique為前綴。例如,使用uniqueUserIds而不是userIdSet。

布爾變量的命名規(guī)則

如果一個變量的值的類型為boolean,那么變量的名稱應當以下列單詞為前綴:

  • is。當變量表達一個二元狀態(tài)的時候,例如isFull、isEmpty。在is后面的應當是一個形容詞;
  • has。當變量表達歷史上是否發(fā)生過某個事件的時候,例如hasPaid、hasArrived。在has后面的應當是一個動詞,并且采用過去分詞;
  • can。當變量表達某種權限的時候,例如canWrite、canExecute。在can后面的應當是一個動詞,并且采用現(xiàn)在分詞。

數(shù)值變量的命名規(guī)則

  • 如果變量中存儲的是一系列數(shù)字中的最大值,那么變量的名稱應當以max為前綴,例如maxScore。如果是最小值,則是以min為前綴,例如minScore;
  • 如果變量中存儲的是一系列數(shù)字的和,那么變量的名稱應當以total為前綴,例如totalIncome;
  • 如果變量中存儲的是數(shù)組的長度,那么變量的名稱可以用numberOf為前綴,例如numberOfUsers。

字符串變量的命名規(guī)則

  • 如果表達的是人名、品牌名、公司名、數(shù)據(jù)庫中的表名,那么變量的名稱可以用單詞name結尾,例如customerName、brandName、companyName;
  • 如果表達的是按鍵或按鈕上刻著的文字、紙質表格或電子表單上輸入框左側的簡短說明,那么變量的名稱可以用單詞label結尾,例如buttonLabel;
  • 不允許使用單詞content

函數(shù)名

  • 函數(shù)的名稱應當由動詞和名詞組成,例如readFile、writeFile;
  • 如果函數(shù)的功能是將參數(shù)轉換為另一種形式的輸出(比如進制轉換、幣種轉換),那么函數(shù)的名稱應當以單詞to為前綴,例如toDollar、toHexadecimal;
  • 如果函數(shù)的功能是檢驗參數(shù)并返回一個布爾值,那么函數(shù)的名稱應當以單詞check為前綴,例如checkIsDirectory、checkIsExecutable;
  • 如果函數(shù)的功能是“計數(shù)”,那么函數(shù)的名稱應當以單詞count為前綴,并且其中被計數(shù)的對象應當為復數(shù)形式,例如countPaidOrders。

構造型函數(shù)的命名規(guī)則

  • 如果表達的是從無到有地創(chuàng)造一個對象,那么函數(shù)名可以用create作為前綴,例如createObject;
  • 如果表達的是將一些輸入原封不動地放在一起(可能輸入之間添加了其它東西)創(chuàng)造出一個對象,那么函數(shù)名可以用make作為前綴,例如makeFloor。進一步地,如果函數(shù)不改變輸入的相對順序,那么函數(shù)名可以用concat,例如concatString;
  • 如果函數(shù)會將根據(jù)輸入創(chuàng)造出具有不止一個層級的對象,那么函數(shù)名可以用build作為前綴,例如buildBinarySearchTree。

修改型函數(shù)的命名規(guī)則

  • 如果函數(shù)負責更新數(shù)據(jù)庫中的記錄,那么函數(shù)名應當以單詞update為前綴;
  • 如果函數(shù)修改的是一些可枚舉的狀態(tài),那么函數(shù)名應當以單詞change為前綴。

類名

  • 類的名稱應當采用capital case的命名風格,例如DatabaseConnection;
  • 類的名稱應當以一個名詞結尾;
  • 如果類的存在是為了使用某種設計模式,那么類名應當可以反映在設計模式中所處的位置,例如在State模式中,代表具體狀態(tài)的類的名稱可以是InitialState、UnpaidState。

參考資料

The art of naming variables
Google JavaScript Style Guide
Letter case

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。

相關文章

  • 我用的一些Node.js開發(fā)工具、開發(fā)包、框架等總結

    我用的一些Node.js開發(fā)工具、開發(fā)包、框架等總結

    這篇文章主要介紹了我個人使用的一些Node.js開發(fā)工具、開發(fā)包、框架等總結,需要的朋友可以參考下
    2014-09-09
  • node模塊機制與異步處理詳解

    node模塊機制與異步處理詳解

    這篇文章主要介紹了node模塊機制與異步處理詳解的相關資料,需要的朋友可以參考下
    2016-03-03
  • node.js模擬實現(xiàn)自動發(fā)送郵件驗證碼

    node.js模擬實現(xiàn)自動發(fā)送郵件驗證碼

    這篇文章主要為大家介紹了node.js模擬實現(xiàn)自動發(fā)送郵件驗證碼的實例過程,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪
    2022-04-04
  • Node.js中Swagger的使用指南詳解

    Node.js中Swagger的使用指南詳解

    Swagger(目前用OpenAPI?Specification代替)是一個用于設計、構建、記錄和使用REST?API的強大工具,本文將探討使用Swagger的一些關鍵技巧,需要的可以參考一下
    2024-01-01
  • node.js中的console.error方法使用說明

    node.js中的console.error方法使用說明

    這篇文章主要介紹了node.js中的console.error方法使用說明,本文介紹了console.error的方法說明、語法、接收參數(shù)、使用實例和實現(xiàn)源碼,需要的朋友可以參考下
    2014-12-12
  • Nodejs 發(fā)送Post請求功能(發(fā)短信驗證碼例子)

    Nodejs 發(fā)送Post請求功能(發(fā)短信驗證碼例子)

    這篇文章主要介紹了Nodejs 發(fā)送Post請求功能(發(fā)短信驗證碼例子),需要的朋友可以參考下
    2017-02-02
  • node下使用UglifyJS壓縮合并JS文件的方法

    node下使用UglifyJS壓縮合并JS文件的方法

    下面小編就為大家分享一篇node下使用UglifyJS壓縮合并JS文件的方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧
    2018-03-03
  • Node.js測試中的Mock文件系統(tǒng)詳解

    Node.js測試中的Mock文件系統(tǒng)詳解

    相信大家應該都知道在Node.js測試中,常常會需要構造某種項目目錄。 為每個測試用例添加相應的目錄結構既費時又難以維護。那么這個時候Mock文件系統(tǒng)就派上用場了,下面這篇文章詳細的介紹了Mock文件系統(tǒng),有需要的朋友們可以參考借鑒,下面來一起學習學習吧。
    2016-11-11
  • Node.js 深度調試方法解析

    Node.js 深度調試方法解析

    這篇文章主要介紹了Node.js 深度調試方法解析,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
    2020-07-07
  • node搭建后臺的實現(xiàn)步驟

    node搭建后臺的實現(xiàn)步驟

    本文介紹了使用Node.js搭建后臺的實現(xiàn)步驟,文章詳細闡述了每個步驟的實現(xiàn)過程,并給出了示例代碼,對于想要了解如何使用Node.js搭建后臺的讀者具有一定的參考價值
    2023-08-08

最新評論