liubin / promises-book Goto Github PK

View Code? Open in Web Editor NEW

This project forked from azu/promises-book

2.1K 102.0 450.0 13.94 MB

JavaScript Promise迷你书

Home Page: http://liubin.github.io/promises-book/

License: MIT License

JavaScript 97.45% Makefile 0.24% Shell 0.45% CSS 1.68% HTML 0.18%

promises-book's Introduction

Promises Book

Promises迷你书电子版（中文版）

在这里http://liubin.github.io/promises-book/ 可以在线阅读。

也可以从这里http://liubin.github.io/promises-book/javascript-promise-book.pdf 下载PDF版。

你还可以从这里https://gumroad.com/l/javascript-promise 免费下载本书的附录，也可以自己设定价格购买，本附录记录了本书诞生的经纬。

如果你想捐赠的话，可以到这里。

关于作者

GitHub: azu
Twitter : azu_re

关注浏览器、JavaScript先关的最新技术。

擅长将将目的作为手段，本书也是因此而成。

管理着个人主页 Web Scratch 和 JSer.info 。

关于译者

liubin
- 除去kakau和honnkyou的其余部分的翻译、整体校对，以及源代码，工具部分的翻译
kaku
- 1.1. Promise是什么、1.2. Promise 简介、1.3. 编写Promise代码
honnkyou
- 3.1. 基本测试

Installation

本书采用Asciidoc格式编写。

可以使用Asciidoctor构建本书电子版。

编译为HTML

(sudo) gem install asciidoctor coderay
(sudo) npm install -g gulp
npm install
rbenv rehash # 如果你是使用rbenv的话。
make html
open index.html

编译为PDF（中文版）

执行命令（OS X下）：

make cn-pdf

如果你想修改字体，可以直接替换_tools/build_cn_pdf.sh里的STKaiti为你想要的字体。

注意：，如果出现java.lang.OutOfMemoryError错误的话，设置一下JVM参数再进行make即可：

export JAVA_OPTS="-Xms512m -Xmx512m"

编译为PDF（日语版）

本书字体使用了VL Gothic Font Family。该字体可以从VL Gothic Font Family下载，并需要进行安装。

所需软件

VL Gothic Font Family
Java

git submodule update --init
make pdf
open javascript-promise-book.pdf

编译为Epub

由于本书还不是特别完善，因此质量会很一般。 HTML版在智能机等小画面尺寸的设备上也能很好的展现，所以推荐大家使用HTML方式阅读。

gem install specific_install
gem specific_install -l https://github.com/opendevise/asciidoctor-epub3
asciidoctor-epub3 -D output index.adoc

Contributing

欢迎各种Pull Request和Issue。

也可以到这里留言。

在Pull Request的时候请先参考 CONTRIBUTING.md 。

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D

License

随书代码以MIT许可证发布。

图书内容则遵循Creative Commons Attribution-NonCommercial许可证。

promises-book's People

Contributors

Stargazers

Watchers

Forkers

kaku87 honnkyou thomasyus kxws888 sdtm1016 karenpeng voidexception salcabar dgunzi lreelenn lujiabz ashengwang the263 zhangf911 heidcloud sm1022 jasonweng cangcanglang geniousli emanual pythonjava brileyhe jianglong0156 joesleung meleslilijing truexu0529 lxj met-pub xcchcaptain xiexiaochuan chafel stionzhai jailecoeu ismichaelni lottid ddt626 lukahuang sunfurong luckykaiyi twq0076262 funagi lln7777 jqk6 favrio alecchou ldfaiztt liujie8372 yitian1204 mba811 stepli1010 wenber steelli dieface wangzhan sly-liu wangxiaofeng81 xiaonia kingmario marlywoos tangjinzhou foxlele2014 shijiawu lidasong2014 yyent purepennons huangfu cyberpunkerx genie88 testerrandolph mzbac otouc levylizzz wangwei1237 xifeiwu cqricky shanli havegone ckplus mageia reeli antsword iyangming imhu jay61439476 tiansiyuan nevermindex xiezhe igitinode wynfrith wuyad easonyi codetilldie moyuanming r569594043 westke networkrepositories mywei1989 tibic lifan3333 lixiansky

promises-book's Issues

日语词汇需要改为中文词汇

非同期 -> 异步
同期 -> 同步

做成 -> 创建/生成/产生

创建一个新建新promise对象

URL : http://liubin.org/promises-book/#promises-overview

创建一个新建新promise对象作为接口。

这个地方读起来有点怪怪的。
改成
新创建一个promise对象如何？

第一章 1.1 “发祥”词汇表达不准确？

1.1 什么是Promise
...
Promise是抽象异步处理对象以及对其进行各种操作的组件。 其详细内容在接下来我们还会进行介绍，Promise并不是从JavaScript中发祥的概念。
...

对于发祥一词不是特别理解，是否可以理解为发明？
本人不懂日语，不知道能否帮忙解惑？

错别字

1.1. 什么是Promise
在使用promise进行一步处理的时候，我们必须按照接口规定的方法编写处理代码。
一步 to 异步？

TimeoutError 需要使用 new 来创造

URL : http://liubin.org/promises-book/#race-delay-timeout

在 我们定义了 TimeoutError 类和构造函数，这个类继承了Error的prototype。它的使用方法和普通的 Error 对象一样，使用 throw 语句即可，如下所示。 下面的代码块，

var promise = new Promise(function(){
    throw TimeoutError("timeout");
});

promise.catch(function(error){
    console.log(error instanceof TimeoutError);// true
});

应该是 throw new TimeoutError("timeout")

Promise.all 的promise是为什么是并行执行的

Promise.all 那个chapter中，有写到：传递给 Promise.all 的promise并不是一个个的顺序执行的，而是同时开始、并行执行的。不是很理解这个部分。
js是单线程的，难道不应该是并发的么？

Promise.all 是在所有promise对象都变为resolve或者只要有一个变为reject时，才会去调用`.then` !

原文：
Promise.all 接收一个 promise对象的数组作为参数，当这个数组里的所有promise对象全部变为resolve或reject状态的时候，它才会去调用 .then 方法。

而实际上应该是：
Promise.all 是在所有promise对象都变为resolve或者只要有一个变为reject时，才会去调用.then

先抛出警告：2，再输出：p3

    var p1 = Promise.resolve(1);
    var p2 = Promise.reject(2);
    var p3 = new Promise(function(resolve, reject) {
        setTimeout(function() {
            console.log('p3')
            resolve(3);
        }, 500);
    });

    p3.then(function(res) {
        console.log('p3')
    });

    Promise.all([p1, p2, p3]).then(function(res) {
        console.log(res)
    }, function(err) {
        console.warn(err)
    });

Promise类似于 XMLHttpRequest，从构造函数 Promise 来创建一个新建新promise对象作为接口。

URL : http://liubin.org/promises-book/#promises-overview

这里的“新建”是否多余了？

"当然也有的Promise实现并没有内涵Promise"应该是“当然也有的Deferred实现并没有内涵Promise”

在4.4.2 http://liubin.github.io/promises-book/#deferred-and-promise 中

“这是jQuery.Deferred结构的简化版。当然也有的Promise实现并没有内涵Promise。”
应该是 “当然也有的Deferred实现并没有内涵Promise。”

日文原文为
もちろんPromiseを持たないDeferredの実装もあります。

错别字一枚

111页，关于作者后面：
“关注浏览器、JavaScript先关的最新技术。”
应该是“相关”，不是“先关” :)

中文版网页上的语言为 ja，应改为 zh-Hans，否则有些汉字很难看。

在此书中文页面上，<html> 的 lang 属性值为 ja，浏览器会用日文字体进行渲染，导致有些日文中不存在的汉字不得不用中文字体进行渲染，就变得不整齐。

应将上述属性改为:

<html lang="zh-Hans">

promise.["catch"] 应该是 promise["catch"]

在2.5.1 http://liubin.github.io/promises-book/#_ie8

“而且很多压缩工具自带了将 promise.catch 转换为 promise.["catch"] 的功能”
promise.["catch"] 应该是 promise["catch"] ，多了点号。

查看日文原文也有此笔误。

伪数组并非具有.length方法，而是length属性

URL : http://liubin.org/promises-book/#ch2-promise-resolve

在2.1.2 thenable中有这样的描述：

就像我们有时称具有 .length 方法的非数组对象为Array like一样，thenable指的是一个具有 .then 方法的对象。

伪数组的描述不是非常准确。伪数组并非具有.length方法，而是length属性。

如有理解不到之处，还请指正。

1.2在这种情况下 catch 的回调函数并不会被执行（因为promise返回了resolve），不过如果运行环境没有提供 setTimeout 函数的话，那么上面代码在执行中就会产生异常，在 catch 中设置的回调函数就会被执行。

URL : http://liubin.org/promises-book/#promises-overview

setTimeout(function () {
resolve('Async Hello world');
}, 16);

在1.2中有句话产生歧义，“在这种情况下 catch 的回调函数并不会被执行（因为promise返回了resolve），不过如果运行环境没有提供 setTimeout 函数的话，那么上面代码在执行中就会产生异常，在 catch 中设置的回调函数就会被执行。” 文中“没有提供 setTimeout ”对于一般阅读的人的感觉就是取消掉代码块中的setTimeout这个函数。哈_哈强迫症你懂的