6-async/02-promise-basics by Starriers · Pull Request #186 · javascript-tutorial/zh.javascript.info

Starriers · 2018-08-08T12:02:40Z

To 校对人员： callback 最后再统一改为回调函数现在不想修改了

update repo.

caoyi0905 · 2018-08-15T09:24:13Z

校对认领

Starriers · 2018-08-15T10:19:02Z

@caoyi0905 术语部分你可以看下怎么翻译比较好

caoyi0905 · 2018-08-17T02:47:50Z

+内置 `setTimeout` 函数会使用回调函数。创建一个基于 promise 的替代产物。

-The function `delay(ms)` should return a promise. That promise should resolve after `ms` milliseconds, so that we can add `.then` to it, like this:
+`delay(ms)` 函数会返回 promise。这个 promise 应该在 `ms` 毫秒之后被处理。因此我们可以向它添加 `.then`，就像这样：


会返回 promise => 会返回一个 promise

向它添加 .then => 在这之后调用 .then

caoyi0905 · 2018-08-17T02:56:08Z

+想象一下，你自己是一位顶尖歌手，粉丝没日没夜地询问你下个单曲何时到来。

-To get a relief, you promise to send it to them when it's published. You give your fans a list. They can fill in their coordinates, so that when the song becomes available, all subscribed parties instantly get it. And if something goes very wrong, so that the song won't be published ever, then they are also to be notified.
+为了得到解脱，你承诺会在发行的第一时间让他们知道。你给了粉丝一张列表，他们可以填写自己的信息，因此它们会在歌曲发行的第一时间，所有订阅的人都可以立刻获知消息。如果发生了错误，也就是歌曲可能永远也不会被发行，他们也会被告知。


整段翻译的有点僵硬。以下是我的翻译，供参考。

为了从中解放，你承诺会在单曲发布的第一时间通知他们。你让粉丝们填写了他们的个人信息，因此他们会在歌曲发布的第一时间获取到。即使遇到了不测，歌曲可能永远不会被发行，他们也会被通知到。

caoyi0905 · 2018-08-17T02:57:18Z

+为了得到解脱，你承诺会在发行的第一时间让他们知道。你给了粉丝一张列表，他们可以填写自己的信息，因此它们会在歌曲发行的第一时间，所有订阅的人都可以立刻获知消息。如果发生了错误，也就是歌曲可能永远也不会被发行，他们也会被告知。

-Everyone is happy: you, because the people don't crowd you any more, and fans, because they won't miss the single.
+每个人都很开心：你，是因为没有人会再催促你，粉丝呢，则因为他们不会错误单曲发行的第一时间。


每个人都很开心：你不会被任何人催促；粉丝也不会错误单曲发行的第一时间。

caoyi0905 · 2018-08-17T02:59:17Z

+每个人都很开心：你，是因为没有人会再催促你，粉丝呢，则因为他们不会错误单曲发行的第一时间。

-That was a real-life analogy for things we often have in programming:
+在编程中，我们经常用现实世界中的事物进行类比：


这是我们在编程中经常遇到的事情的一个真实的比方。

caoyi0905 · 2018-08-17T02:59:52Z

-1. A "producing code" that does something and needs time. For instance, it loads a remote script. That's a "singer".
-2. A "consuming code" wants the result when it's ready. Many functions may need that result. These are  "fans".
-3. A *promise* is a special JavaScript object that links them together. That's a "list". The producing code creates it and gives to everyone, so that they can subscribe for the result.
+1. "producing code" 会做一些事情，也需要事件。比如，它加载一个远程脚本。此时它就像“歌手”。


生产者代码

caoyi0905 · 2018-08-17T03:10:43Z


 ```smart header="Reject with `Error` objects"
-Technically we can call `reject` (just like `resolve`) with any type of argument. But it's recommended to use `Error` objects in `reject` (or inherit from them). The reasoning for that will become obvious soon.
+从技术上来说，我们可以使用任何类型的参数来调用 `reject`（就像 `resolve`）。但建议在 `reject`（或从它们中继承）中使用 `Error` 对象。原因就会显示出来。 


原因就会显示出来。 => 错误原因就会显示出来。

caoyi0905 · 2018-08-17T03:15:05Z

 ```

-The idea is that a job done by the executor may have only one result or an error. In programming, there exist other data structures that allow many "flowing" results, for instance streams and queues. They have their own advantages and disadvantages versus promises. They are not supported by JavaScript core and lack certain language features that promises provide, we don't cover them here to concentrate on promises.
+想法是，执行器所做的作业可能只有一个结果或者一个错误。在编程中，还有其他允许 "flowing" 结果的数据结构。例如流和队列。相对于 promise，它们有着自己的优势和劣势。它们不被 JavaScipt 核心支持，而且缺少 promise 所提供的某些语言特性，我们在这里不对 promise 进行过多的讨论。


想法是，去掉

caoyi0905 · 2018-08-17T03:17:21Z

 ```

-The call `.catch(f)` is a complete analog of `.then(null, f)`, it's just a shorthand.
+调用 `.catch(f)` 是 `.then(null, f)` 的模拟，它只做快速记录。


它只做快速记录。 => 这只是一个简写。

caoyi0905 · 2018-08-17T03:17:47Z

+promise.then(alert); // 完成！（在当前代码完成之后）

-alert("code finished"); // this alert shows first
+alert("code finished"); // 这个报警会最先显示


报警 => alert

这个问题不知道怎么解决。因为有的人翻译，有的人不翻译。

caoyi0905 · 2018-08-17T03:18:19Z

 ```

-Usage:
+使用：


使用 => 用法

leviding · 2018-08-20T02:50:11Z

@caoyi0905 👍

leviding · 2018-08-20T02:50:26Z

@Starriers 修改下吧

Starriers · 2018-08-20T03:33:57Z

Modify :
1 . Producing cod =》生产者
2 . Job =》任务
3 . executor 不翻译

Starriers · 2018-08-20T03:34:28Z

@caoyi0905 @leviding Proofreading modification have been done！

leviding · 2018-08-20T03:42:30Z

@Starriers 可以建一个 glossary 放进去？

leviding · 2018-08-20T03:44:27Z

@Starriers 建好了，在 WIKI

Starriers · 2018-08-20T03:45:25Z

@leviding 那是啥

leviding · 2018-08-20T04:28:05Z

@Starriers 术语表

leviding · 2018-08-21T03:57:17Z

#204

Starriers added 7 commits June 25, 2018 08:42

Merge pull request #1 from xitu/zh-hans

f21533a

update repo.

翻译完成

7f46f09

翻译完成

d939beb

翻译完成

ca0044c

翻译完成

89e3d66

翻译完成

5511704

翻译完成

bfbba04

leviding added the 校对认领 label Aug 8, 2018

leviding changed the title ~~Translation/promise basics~~ 6-async/02-promise-basics Aug 15, 2018

caoyi0905 reviewed Aug 17, 2018

View reviewed changes

leviding mentioned this pull request Aug 17, 2018

6-async #204

Closed

4 tasks

leviding added enhancement New feature or request 正在校对 labels Aug 20, 2018

Starriers added 2 commits August 20, 2018 11:10

Proofreading modification —— The First

cc0cc10

Proofreading have been done ! —— The First

9611396

leviding added WIP Work in process and removed enhancement New feature or request labels Aug 20, 2018

Update article.md

8f672c0

leviding approved these changes Aug 21, 2018

View reviewed changes

leviding merged commit 58adca5 into javascript-tutorial:zh-hans Aug 21, 2018

leviding added 翻译完成 and removed WIP Work in process 校对认领正在校对 labels Aug 21, 2018

Conversation

Starriers commented Aug 8, 2018

Uh oh!

caoyi0905 commented Aug 15, 2018

Uh oh!

Starriers commented Aug 15, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

leviding commented Aug 20, 2018

Uh oh!

leviding commented Aug 20, 2018

Uh oh!

Starriers commented Aug 20, 2018

Uh oh!

Starriers commented Aug 20, 2018

Uh oh!

leviding commented Aug 20, 2018

Uh oh!

leviding commented Aug 20, 2018

Uh oh!

Starriers commented Aug 20, 2018

Uh oh!

leviding commented Aug 20, 2018

Uh oh!

leviding commented Aug 21, 2018

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants