從Promise開始的JavaScript異步生活
  • 關於本書
  • 寫作格式
  • 更新日誌
  • 問答與回饋
  • 主要內容
    • 前言
    • 基本概念
    • Promises/A+標準定義
    • Promise 物件建立與基本使用
    • 執行流程與錯誤處理
    • 深入 then 方法
    • Promise.resolve 與 Promise.reject
    • Promise.all 與 Promise.race
    • 執行順序 連鎖(Chaining) 或 分支(Branching)
    • 反樣式(anti-pattern)與最佳實踐
    • 實例與程式碼片段
    • Promise 外部函式庫議題
    • 參考資源
Powered by GitBook
On this page
  • 專有名詞
  • 符號
  • 中文字詞與符號
  • 不使用分號作為每行程式碼的結尾
  • 其他參考

Was this helpful?

寫作格式

本書使用了以下的風格作為撰寫風格:

專有名詞

對於專有名詞,例如函式庫中的定義、函式、方法、物件等專用名詞,保留原字詞不進行"取代式"的翻譯,而使用括號(())加註其後作為補充翻譯,例如:

state(狀態)
props(屬性)

符號

提供的符號,儘可能使用括號(())加註符號在字句中。例如:

單行註解使用雙斜線符號(//)。

中文字詞與符號

可以使用全形的逗號(,)、分號(、)與句號(。),但儘量不使用用全形的括號(())、框號(「」)與其他符號等。而是使用半形符號。

適當的在中文字詞的前後加上空白字元,作為明顯的區隔出這個字詞。例如:

使用 擴充套件->管理 進入這個管理的頁面。

不使用分號作為每行程式碼的結尾

本書的所有程式碼,每行後面都"不"再使用分號(semicolon)(;)作為程式碼段落之用,程式碼只需要記得有分行就行了。

有許多現代新式的程式語言,也是不需要用分號(;)來作每行程式碼的結尾,例如Swift、Python或Ruby。而實際上,Javascript現在也可以不需要用分號(;)來分行,有許多知名的函式庫例如npm、jQuery都已經採用這個撰寫風格。所以,我們鼓勵所有的Javascript程式設計師,使用這種方式,讓程式碼看起來會更加簡潔。

更多參考資訊:

其他參考

Previous關於本書Next更新日誌

Last updated 4 years ago

Was this helpful?

Semicolons in JavaScript are optional
An Open Letter to JavaScript Leaders Regarding Semicolons
翻譯指引 Translation Guide