diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md index 5e53c08acb..2614a09737 100644 --- a/1-js/01-getting-started/1-intro/article.md +++ b/1-js/01-getting-started/1-intro/article.md @@ -115,14 +115,6 @@ JavaScript 是将这三件事结合在一起的唯一的浏览器技术。 这样的语言还有很多。当然,即使我们在使用此类编译语言,我们也需要了解 JavaScript。因为了解 JavaScript 才能让我们真正明白我们在做什么。 -## Mock 工具 - - - -一个好用的开源接口 Mock 工具:[https://github.com/eolinker/eoapi](https://datayi.cn/w/QReKB8No) - -除了 Mock 功能,还集合了 API 管理和测试功能,还可以通过插件广场帮助你将 API 发布到各个应用平台,比如发布到网关上完成 API 上线,或者和低代码平台结合,将 API 快速变成低代码平台中可使用的组件等。 - ## 总结 - JavaScript 最开始是专门为浏览器设计的一门语言,但是现在也被用于很多其他的环境。 diff --git a/1-js/01-getting-started/3-code-editors/article.md b/1-js/01-getting-started/3-code-editors/article.md index 8d9c4fbe4e..abf4149ed7 100644 --- a/1-js/01-getting-started/3-code-editors/article.md +++ b/1-js/01-getting-started/3-code-editors/article.md @@ -13,7 +13,7 @@ IDE 加载项目(通常包含很多文件),并且允许在不同文件之 如果你还没考虑好选哪一款 IDE,可以考虑下面两个: - [Visual Studio Code](https://code.visualstudio.com/)(跨平台,免费)。 -- [WebStorm](https://www.jetbrains.com/webstorm/)(跨平台,收费)。 +- [WebStorm](https://www.jetbrains.com/webstorm/)(跨平台,非商用免费)。 对于 Windows 系统来说,也有个叫 "Visual Studio" 的 IDE,请不要跟 "Visual Studio Code" 混淆。"Visual Studio" 是一个收费的、强大的 Windows 专用编辑器,它十分适合于 .NET 开发。用它进行 JavaScript 开发也不错。"Visual Studio" 有个免费的版本 [Visual Studio Community](https://www.visualstudio.com/vs/community/)。 diff --git a/1-js/02-first-steps/01-hello-world/article.md b/1-js/02-first-steps/01-hello-world/article.md index 7de5da6af3..b7ece71086 100644 --- a/1-js/02-first-steps/01-hello-world/article.md +++ b/1-js/02-first-steps/01-hello-world/article.md @@ -73,7 +73,7 @@ ``` -这里,`/path/to/script.js` 是脚本文件从网站根目录开始的绝对路径。当然也可以提供当前页面的相对路径。例如,`src ="script.js"`,就像 `src="./script.js"`,表示当前文件夹中的 `"script.js"` 文件。 +这里,`/path/to/script.js` 是脚本文件从网站根目录开始的绝对路径。当然也可以提供当前页面的相对路径。例如,`src="script.js"`,就像 `src="./script.js"`,表示当前文件夹中的 `"script.js"` 文件。 我们也可以提供一个完整的 URL 地址,例如: diff --git a/1-js/02-first-steps/05-types/article.md b/1-js/02-first-steps/05-types/article.md index fe2a9905b4..c149b7899f 100644 --- a/1-js/02-first-steps/05-types/article.md +++ b/1-js/02-first-steps/05-types/article.md @@ -272,9 +272,9 @@ typeof alert // "function" (3) ## 总结 -JavaScript 中有八种基本的数据类型(译注:前七种为基本数据类型,也称为原始数据类型,而 `object` 为复杂数据类型)。 +JavaScript 中有八种基本的数据类型。 -- 七种原始数据类型: +- 七种原始数据类型(基本数据类型): - `number` 用于任何类型的数字:整数或浮点数,在 ±(253-1) 范围内的整数。 - `bigint` 用于任意长度的整数。 - `string` 用于字符串:一个字符串可以包含 0 个或多个字符,所以没有单独的单字符类型。 @@ -282,7 +282,7 @@ JavaScript 中有八种基本的数据类型(译注:前七种为基本数据 - `null` 用于未知的值 —— 只有一个 `null` 值的独立类型。 - `undefined` 用于未定义的值 —— 只有一个 `undefined` 值的独立类型。 - `symbol` 用于唯一的标识符。 -- 以及一种非原始数据类型: +- 以及一种非原始数据类型(复杂数据类型): - `object` 用于更复杂的数据结构。 我们可以通过 `typeof` 运算符查看存储在变量中的数据类型。 diff --git a/1-js/02-first-steps/08-operators/article.md b/1-js/02-first-steps/08-operators/article.md index 4e13f1f7dc..2a5427dd06 100644 --- a/1-js/02-first-steps/08-operators/article.md +++ b/1-js/02-first-steps/08-operators/article.md @@ -443,7 +443,7 @@ counter++; 逗号运算符 `,` 是最少见最不常使用的运算符之一。有时候它会被用来写更简短的代码,因此为了能够理解代码,我们需要了解它。 -逗号运算符能让我们处理多个语句,使用 `,` 将它们分开。每个语句都运行了,但是只有最后的语句的结果会被返回。 +逗号运算符能让我们处理多个表达式,使用 `,` 将它们分开。每个表达式都运行了,但是只有最后一个的结果会被返回。 举个例子: @@ -455,7 +455,7 @@ let a = (1 + 2, 3 + 4); alert( a ); // 7(3 + 4 的结果) ``` -这里,第一个语句 `1 + 2` 运行了,但是它的结果被丢弃了。随后计算 `3 + 4`,并且该计算结果被返回。 +这里,第一个表达式 `1 + 2` 运行了,但是它的结果被丢弃了。随后计算 `3 + 4`,并且该计算结果被返回。 ```smart header="逗号运算符的优先级非常低" 请注意逗号运算符的优先级非常低,比 `=` 还要低,因此上面你的例子中圆括号非常重要。 diff --git a/1-js/02-first-steps/12-nullish-coalescing-operator/article.md b/1-js/02-first-steps/12-nullish-coalescing-operator/article.md index 672665b5c9..42bb89af48 100644 --- a/1-js/02-first-steps/12-nullish-coalescing-operator/article.md +++ b/1-js/02-first-steps/12-nullish-coalescing-operator/article.md @@ -106,7 +106,7 @@ alert(height ?? 100); // 0 ## 优先级 -`??` 运算符的优先级与 `||` 相同,它们的的优先级都为 `4`,详见:[MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table)。 +`??` 运算符的优先级与 `||` 相同,它们的优先级都为 `3`,详见:[MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table)。 这意味着,就像 `||` 一样,空值合并运算符在 `=` 和 `?` 运算前计算,但在大多数其他运算(例如 `+` 和 `*`)之后计算。 diff --git a/1-js/02-first-steps/13-while-for/article.md b/1-js/02-first-steps/13-while-for/article.md index 42744fe9a6..6dee8a62ca 100644 --- a/1-js/02-first-steps/13-while-for/article.md +++ b/1-js/02-first-steps/13-while-for/article.md @@ -14,7 +14,7 @@ 如果你阅读本文是为了寻找其他类型的循环,那么: - 用于遍历对象属性的 `for..in` 循环请见:[for..in](info:object#forin)。 -- 用于遍历数组和可迭代对象的循环分别请见:[for..of](info:array#loops) 和 [iterables](info:iterable)。 +- 用于遍历数组和可迭代对象的循环分别请见:[for..of](info:array#xun-huan) 和 [iterables](info:iterable)。 否则,请继续阅读。 ``` diff --git a/1-js/03-code-quality/06-polyfills/article.md b/1-js/03-code-quality/06-polyfills/article.md index 931a32f107..1c4fd571c3 100644 --- a/1-js/03-code-quality/06-polyfills/article.md +++ b/1-js/03-code-quality/06-polyfills/article.md @@ -7,7 +7,7 @@ JavaScript 引擎背后的团队关于首先要实现什么有着他们自己想 因此,一个 JavaScript 引擎只能实现标准中的一部分是很常见的情况。 -查看语言特性的当前支持状态的一个很好的页面是 (它很大,我们现在还有很多东西要学)。 +查看语言特性的当前支持状态的一个很好的页面是 (它很大,我们现在还有很多东西要学)。 作为程序员,我们希望使用最新的特性。好东西越多越好! @@ -73,7 +73,6 @@ JavaScript 是一种高度动态的语言。脚本可以添加/修改任何函 两个有趣的 polyfill 库: - [core js](https://github.com/zloirock/core-js) 支持了很多特性,允许只包含需要的特性。 -- [polyfill.io](http://polyfill.io) 提供带有 polyfill 的脚本的服务,具体取决于特性和用户的浏览器。 ## 总结 @@ -85,7 +84,7 @@ JavaScript 是一种高度动态的语言。脚本可以添加/修改任何函 例如,以后熟悉了 JavaScript,你就可以搭建一个基于 [webpack](https://webpack.js.org/) 和 [babel-loader](https://github.com/babel/babel-loader) 插件的代码构建系统。 展示对各种特征的当前支持情况的工具: -- —— 对于原生 JavaScript。 +- —— 对于原生 JavaScript。 - —— 对于浏览器相关的函数。 P.S. 谷歌的 Chrome 浏览器通常是对最新的语言特性的支持情况最好的浏览器,如果教程的示例运行失败,请尝试使用 Chrome 浏览器。不过,教程中的大多数示例都适用于任意的现代浏览器。 diff --git a/1-js/04-object-basics/03-garbage-collection/article.md b/1-js/04-object-basics/03-garbage-collection/article.md index 0afca212d6..65eef58452 100644 --- a/1-js/04-object-basics/03-garbage-collection/article.md +++ b/1-js/04-object-basics/03-garbage-collection/article.md @@ -8,7 +8,7 @@ JavaScript 中主要的内存管理概念是 **可达性**。 -简而言之,"可达"值是那些以某种方式可访问或可用的值。它们一定是存储在内存中的。 +简而言之,"可达"值是那些以某种方式可访问或可用的值。它们被存储在内存中。 1. 这里列出固有的可达值的基本集合,这些值明显不能被释放。 @@ -17,11 +17,11 @@ JavaScript 中主要的内存管理概念是 **可达性**。 - 当前执行的函数,它的局部变量和参数。 - 当前嵌套调用链上的其他函数、它们的局部变量和参数。 - 全局变量。 - - (还有一些内部的) + - (还有一些其他的,内部实现) 这些值被称作 **根(roots)**。 -2. 如果一个值可以通过引用链从根访问任何其他值,则认为该值是可达的。 +2. 如果一个值可以从根通过引用或者引用链进行访问,则认为该值是可达的。 比方说,如果全局变量中有一个对象,并且该对象有一个属性引用了另一个对象,则 **该** 对象被认为是可达的。而且它引用的内容也是可达的。下面是详细的例子。 diff --git a/1-js/04-object-basics/06-constructor-new/article.md b/1-js/04-object-basics/06-constructor-new/article.md index 53af26adf0..432711c7a0 100644 --- a/1-js/04-object-basics/06-constructor-new/article.md +++ b/1-js/04-object-basics/06-constructor-new/article.md @@ -51,7 +51,7 @@ function User(name) { } ``` -所以 `new User("Jack")` 的结果是相同的对象: +所以 `new User("Jack")` 的结果和以下操作的结果相同: ```js let user = { diff --git a/1-js/04-object-basics/08-symbol/article.md b/1-js/04-object-basics/08-symbol/article.md index 3223721473..523ae28339 100644 --- a/1-js/04-object-basics/08-symbol/article.md +++ b/1-js/04-object-basics/08-symbol/article.md @@ -118,7 +118,7 @@ user[id] = "Their id value"; 我们的标识符和它们的标识符之间不会有冲突,因为 symbol 总是不同的,即使它们有相同的名字。 -......但如果我们处于同样的目的,使用字符串 `"id"` 而不是用 symbol,那么 **就会** 出现冲突: +......但如果我们出于同样的目的,使用字符串 `"id"` 而不是用 symbol,那么 **就会** 出现冲突: ```js let user = { name: "John" }; @@ -238,7 +238,7 @@ alert( Symbol.keyFor(sym2) ); // id `Symbol.keyFor` 内部使用全局 symbol 注册表来查找 symbol 的键。所以它不适用于非全局 symbol。如果 symbol 不是全局的,它将无法找到它并返回 `undefined`。 -也就是说,所有 symbol 都具有 `description` 属性。 +但是,所有 symbol 都具有 `description` 属性。 例如: diff --git a/1-js/04-object-basics/09-object-toprimitive/article.md b/1-js/04-object-basics/09-object-toprimitive/article.md index 363ddadb76..a83ef223ba 100644 --- a/1-js/04-object-basics/09-object-toprimitive/article.md +++ b/1-js/04-object-basics/09-object-toprimitive/article.md @@ -9,7 +9,7 @@ JavaScript 不允许自定义运算符对对象的处理方式。与其他一些 这是一个重要的限制:因为 `obj1 + obj2`(或者其他数学运算)的结果不能是另一个对象! -例如,我们无法使用对象来表示向量或矩阵(或成就或其他),把它们相加并期望得到一个"总和"向量作为结果。这样的想法是行不通的。 +例如,我们无法使用对象来表示向量或矩阵,把它们相加并期望得到一个"总和"向量作为结果。这样的想法是行不通的。 因此,由于我们从技术上无法实现此类运算,所以在实际项目中不存在对对象的数学运算。如果你发现有,除了极少数例外,通常是写错了。 diff --git a/1-js/05-data-types/02-number/article.md b/1-js/05-data-types/02-number/article.md index ab4958be43..0cdc93148c 100644 --- a/1-js/05-data-types/02-number/article.md +++ b/1-js/05-data-types/02-number/article.md @@ -249,14 +249,14 @@ PHP,Java,C,Perl,Ruby 给出的也是完全相同的结果,因为它们 ```js run let sum = 0.1 + 0.2; -alert( sum.toFixed(2) ); // 0.30 +alert( sum.toFixed(2) ); // "0.30" ``` 请注意,`toFixed` 总是返回一个字符串。它确保小数点后有 2 位数字。如果我们有一个电子购物网站,并需要显示 `\ 0.30`,这实际上很方便。对于其他情况,我们可以使用一元加号将其强制转换为一个数字: ```js run let sum = 0.1 + 0.2; -alert( +sum.toFixed(2) ); // "0.30" +alert( +sum.toFixed(2) ); // 0.3 ``` 我们可以将数字临时乘以 100(或更大的数字),将其转换为整数,进行数学运算,然后再除回。当我们使用整数进行数学运算时,误差会有所减少,但仍然可以在除法中得到: diff --git a/1-js/05-data-types/03-string/article.md b/1-js/05-data-types/03-string/article.md index 3a51a5ec9b..8d381f8e24 100644 --- a/1-js/05-data-types/03-string/article.md +++ b/1-js/05-data-types/03-string/article.md @@ -48,7 +48,7 @@ let guestList = "Guests: // Error: Unexpected token ILLEGAL * John"; ``` -单引号和双引号来自语言创建的的古老时代,当时没有考虑到多行字符串的需要。反引号出现较晚,因此更通用。 +单引号和双引号来自语言创建的古老时代,当时没有考虑到多行字符串的需要。反引号出现较晚,因此更通用。 反引号还允许我们在第一个反引号之前指定一个"模版函数"。语法是:func`string`。函数 `func` 被自动调用,接收字符串和嵌入式表达式,并处理它们。你可以在 [docs](mdn:/JavaScript/Reference/Template_literals#Tagged_template_literals) 中阅读更多关于它们的信息。这叫做 "tagged templates"。此功能可以更轻松地将字符串包装到自定义模版或其他函数中,但这很少使用。 diff --git a/1-js/05-data-types/05-array-methods/8-sort-objects/solution.md b/1-js/05-data-types/05-array-methods/8-sort-objects/solution.md index 9e7f29b3e7..c00ac5dc78 100644 --- a/1-js/05-data-types/05-array-methods/8-sort-objects/solution.md +++ b/1-js/05-data-types/05-array-methods/8-sort-objects/solution.md @@ -16,19 +16,3 @@ alert(arr[0].name); // John alert(arr[1].name); // Mary alert(arr[2].name); // Pete ``` - -译注:解决方案的代码还可以更短一些 - -```js -function sortByAge(arr) { - arr.sort((a, b) => a.age - b.age); -} -``` - -因为 `sort()` 方法的语法为 `arr.sort([compareFunction])`,如果没有指明 `compareFunction`,那么元素会被按照转换为的字符串的诸个字符的 Unicode 编码进行排序,如果指明了 `compareFunction`,那么数组会按照调用该函数的返回值排序。即 `a` 和 `b` 是两个将要被比较的元素: - -- 如果 `compareFunction(a, b)` 小于 `0`,那么 `a` 会被排列到 `b` 之前; -- 如果 `compareFunction(a, b)` 等于 `0`,那么 `a` 和 `b` 的相对位置不变。备注:ECMAScript 标准并不保证这一行为,而且也不是所有浏览器都会遵守(例如 Mozilla 在 2003 年之前的版本); -- 如果 `compareFunction(a, b)` 大于 `0`,那么 `b` 会被排列到 `a` 之前。 - -因此,升序排列的函数可以简写为:`(a, b) => a.age - b.age`。 diff --git a/1-js/05-data-types/05-array-methods/article.md b/1-js/05-data-types/05-array-methods/article.md index c51a0cfb9c..13b25a096e 100644 --- a/1-js/05-data-types/05-array-methods/article.md +++ b/1-js/05-data-types/05-array-methods/article.md @@ -763,7 +763,7 @@ alert(soldiers[1].age); // 23 - `map(func)` —— 根据对每个元素调用 `func` 的结果创建一个新数组。 - `sort(func)` —— 对数组进行原位(in-place)排序,然后返回它。 - `reverse()` —— 原位(in-place)反转数组,然后返回它。 - - `split/join` —— 将字符串转换为数组并返回。 + - `split/join` —— 将字符串拆分为数组并返回/将数组项组合成字符串并返回。 - `reduce/reduceRight(func, initial)` —— 通过对每个元素调用 `func` 计算数组上的单个值,并在调用之间传递中间结果。 - 其他: diff --git a/1-js/05-data-types/06-iterable/article.md b/1-js/05-data-types/06-iterable/article.md index ae88472ba7..2055f5c41c 100644 --- a/1-js/05-data-types/06-iterable/article.md +++ b/1-js/05-data-types/06-iterable/article.md @@ -5,7 +5,7 @@ 数组是可迭代的。但不仅仅是数组。很多其他内建对象也都是可迭代的。例如字符串也是可迭代的。 -如果从技术上讲,对象不是数组,而是表示某物的集合(列表,集合),`for..of` 是一个能够遍历它的很好的语法,因此,让我们来看看如何使其发挥作用。 +如果从严格意义上讲,对象不是数组,而是表示某物的集合(列表,集合),`for..of` 是一个能够遍历它的很好的语法,因此,让我们来看看如何使其发挥作用。 ## Symbol.iterator diff --git a/1-js/05-data-types/12-json/article.md b/1-js/05-data-types/12-json/article.md index f27d217219..0dbbdd157a 100644 --- a/1-js/05-data-types/12-json/article.md +++ b/1-js/05-data-types/12-json/article.md @@ -188,7 +188,7 @@ replacer : 要编码的属性数组或映射函数 `function(key, value)`。 space -: 用于格式化的空格数量 +: 用于格式化的空格数量。 大部分情况,`JSON.stringify` 仅与第一个参数一起使用。但是,如果我们需要微调替换过程,比如过滤掉循环引用,我们可以使用 `JSON.stringify` 的第二个参数。 @@ -246,7 +246,7 @@ alert( JSON.stringify(meetup, *!*['title', 'participants', 'place', 'name', 'num 该函数会为每个 `(key,value)` 对调用并返回"已替换"的值,该值将替换原有的值。如果值被跳过了,则为 `undefined`。 -在我们的例子中,我们可以为 `occupiedBy` 以外的所有内容按原样返回 `value`。为了 `occupiedBy`,下面的代码返回 `undefined`: +在我们的例子中,我们可以为 `occupiedBy` 以外的所有内容按原样返回 `value`。对于 `occupiedBy`,下面的代码返回 `undefined`: ```js run let room = { @@ -453,7 +453,7 @@ let json = `{ 还有另一种名为 [JSON5](http://json5.org/) 的格式,它允许未加引号的键,也允许注释等。但这是一个独立的库,不在语言的规范中。 -常规的 JSON 格式严格,并不是因为它的开发者很懒,而是为了实现简单,可靠且快速地实现解析算法。 +标准 JSON 格式之所以如此严格,并不是因为它的制定者们偷懒,而是为了能够简单,可靠且快速地实现解析算法。 ## 使用 reviver diff --git a/1-js/06-advanced-functions/01-recursion/article.md b/1-js/06-advanced-functions/01-recursion/article.md index 2e06590300..f728041114 100644 --- a/1-js/06-advanced-functions/01-recursion/article.md +++ b/1-js/06-advanced-functions/01-recursion/article.md @@ -28,7 +28,7 @@ pow(2, 4) = 16 function pow(x, n) { let result = 1; - // 再循环中,用 x 乘以 result n 次 + // 在循环中,用 x 乘以 result n 次 for (let i = 0; i < n; i++) { result *= x; } @@ -338,10 +338,10 @@ let company = { 我们可以看到,当我们的函数对一个部门求和时,有两种可能的情况: -1. 要么是由一 **数组** 的人组成的"简单"的部门 —— 这样我们就可以通过一个简单的循环来计算薪资的总和。 +1. 要么是由一个人员 **数组** 构成的"简单"的部门 —— 这样我们就可以通过一个简单的循环来计算薪资的总和。 2. 或者它是一个有 `N` 个子部门的 **对象** —— 那么我们可以通过 `N` 层递归调用来求每一个子部门的薪资,然后将它们合并起来。 -第一种情况是由一数组的人组成的部门,这种情况很简单,是最基础的递归。 +第一种情况是由人员数组构成的部门,这种情况很简单,是最基础的递归。 第二种情况是我们得到的是对象。那么可将这个复杂的任务拆分成适用于更小部门的子任务。它们可能会被继续拆分,但很快或者不久就会拆分到第一种情况那样。 @@ -396,7 +396,7 @@ alert(sumSalaries(company)); // 7700 我们刚刚在上面的公司结构的示例中看过了它。 一个公司的 **部门** 是: -- 一数组的人。 +- 人员数组。 - 或一个 **部门** 对象。 对于 Web 开发者而言,有更熟知的例子:HTML 和 XML 文档。 @@ -513,7 +513,7 @@ list.next = list.next.next; 链表主要的缺点就是我们无法很容易地通过元素的编号获取元素。但在数组中却很容易:`arr[n]` 是一个直接引用。而在链表中,我们需要从起点元素开始,顺着 `next` 找 `N` 次才能获取到第 N 个元素。 -......但是我们也并不是总需要这样的操作。比如,当我们需要一个队列甚至一个 [双向队列](https://en.wikipedia.org/wiki/Double-ended_queue) —— 有序结构必须可以快速地从两端添加/移除元素,但是不需要访问的元素。 +......但是我们也并不是总需要这样的操作。比如,当我们需要一个队列甚至一个 [双向队列](https://en.wikipedia.org/wiki/Double-ended_queue) —— 有序结构必须可以快速地从两端添加/移除元素,无需访问中间元素。 链表可以得到增强: - 我们可以在 `next` 之外,再添加 `prev` 属性来引用前一个元素,以便轻松地往回移动。 diff --git a/1-js/06-advanced-functions/02-rest-parameters-spread/article.md b/1-js/06-advanced-functions/02-rest-parameters-spread/article.md index a6efac76ee..6f8c5c1585 100644 --- a/1-js/06-advanced-functions/02-rest-parameters-spread/article.md +++ b/1-js/06-advanced-functions/02-rest-parameters-spread/article.md @@ -227,7 +227,7 @@ alert( Array.from(str) ); // H,e,l,l,o ## 复制 array/object -还记得我们 [之前讲过的](info:object-copy#ke-long-yu-he-bing-objectassign) `Object.assign()` 吗? +还记得我们 [之前讲过的](info:object-copy#cloning-and-merging-object-assign) `Object.assign()` 吗? 使用 spread 语法也可以做同样的事情(译注:也就是进行浅拷贝)。 diff --git a/1-js/06-advanced-functions/03-closure/7-let-scope/solution.md b/1-js/06-advanced-functions/03-closure/7-let-scope/solution.md index bbf1c8f35f..d58009c332 100644 --- a/1-js/06-advanced-functions/03-closure/7-let-scope/solution.md +++ b/1-js/06-advanced-functions/03-closure/7-let-scope/solution.md @@ -27,7 +27,7 @@ func(); function func() { *!* // 引擎从函数开始就知道局部变量 x, - // 但是变量 x 一直处于"未初始化"(无法使用)的状态,直到结束 let("死区") + // 但是变量 x 一直处于"未初始化"(无法使用)的状态,直到遇到 let,此时"死区"结束 // 因此答案是 error */!* diff --git a/1-js/06-advanced-functions/07-new-function/article.md b/1-js/06-advanced-functions/07-new-function/article.md index 9a7263d790..85326d1fff 100644 --- a/1-js/06-advanced-functions/07-new-function/article.md +++ b/1-js/06-advanced-functions/07-new-function/article.md @@ -92,7 +92,7 @@ getFunc()(); // *!*"test"*/!*,从 getFunc 的词法环境中获取的 问题在于,在将 JavaScript 发布到生产环境之前,需要使用 **压缩程序(minifier)** 对其进行压缩 —— 一个特殊的程序,通过删除多余的注释和空格等压缩代码 —— 更重要的是,将局部变量命名为较短的变量。 -例如,如果一个函数有 `let userName`,压缩程序会把它替换为 `let a`(如果 a 已被占用了,那就使用其他字符),剩余的局部变量也会被进行类似的替换。一般来说这样的替换是安全的,毕竟这些变量是函数内的局部变量,函数外的任何东西都无法访问它。在函数内部,压缩程序会替换所有使用了使用了这些变量的代码。压缩程序很聪明,它会分析代码的结构,而不是呆板地查找然后替换,因此它不会"破坏"你的程序。 +例如,如果一个函数有 `let userName`,压缩程序会把它替换为 `let a`(如果 a 已被占用了,那就使用其他字符),剩余的局部变量也会被进行类似的替换。一般来说这样的替换是安全的,毕竟这些变量是函数内的局部变量,函数外的任何东西都无法访问它。在函数内部,压缩程序会替换所有使用了这些变量的代码。压缩程序很聪明,它会分析代码的结构,而不是呆板地查找然后替换,因此它不会"破坏"你的程序。 但是在这种情况下,如果使 `new Function` 可以访问自身函数以外的变量,它也很有可能无法找到重命名的 `userName`,这是因为新函数的创建发生在代码压缩以后,变量名已经被替换了。 diff --git a/1-js/06-advanced-functions/09-call-apply-decorators/04-throttle/solution.md b/1-js/06-advanced-functions/09-call-apply-decorators/04-throttle/solution.md index 7d747cc452..6ed9ccf703 100644 --- a/1-js/06-advanced-functions/09-call-apply-decorators/04-throttle/solution.md +++ b/1-js/06-advanced-functions/09-call-apply-decorators/04-throttle/solution.md @@ -32,7 +32,7 @@ function throttle(func, ms) { 调用 `throttle(func, ms)` 返回 `wrapper`。 1. 在第一次调用期间,`wrapper` 只运行 `func` 并设置冷却状态(`isThrottled = true`)。 -2. 在这种状态下,所有调用都记忆在 `savedArgs/savedThis` 中。请注意,上下文和参数(arguments)同等重要,应该被记下来。我们同时需要他们以重现调用。 -3. ......然后经过 `ms` 毫秒后,触发 `setTimeout`。冷却状态被移除(`isThrottled = false`),如果我们忽略了调用,则将使用最后记忆的参数和上下文执行 `wrapper`。 +2. 在冷却状态下,所有调用都被保存在 `savedArgs/savedThis` 中。请注意,上下文(this)和参数(arguments)都很重要,应该被保存下来。我们需要它们来重现调用。 +3. 经过 `ms` 毫秒后,`setTimeout`中的函数被触发。冷却状态被移除(`isThrottled = false`),如果存在被忽略的调用,将使用最后一次调用保存的参数和上下文运行 `wrapper`。 -第 3 步运行的不是 `func`,而是 `wrapper`,因为我们不仅需要执行 `func`,还需要再次进入冷却状态并设置 timeout 以重置它。 +第 3 步运行的不是 `func`,而是 `wrapper`,因为我们不仅需要执行 `func`,还需要再次进入冷却状态并设置 `setTimeout` 以重置节流。 diff --git a/1-js/06-advanced-functions/09-call-apply-decorators/article.md b/1-js/06-advanced-functions/09-call-apply-decorators/article.md index 8739fd2dc4..53bd1f0b7b 100644 --- a/1-js/06-advanced-functions/09-call-apply-decorators/article.md +++ b/1-js/06-advanced-functions/09-call-apply-decorators/article.md @@ -413,7 +413,7 @@ hash(1, 2); - [func.call(context, arg1, arg2...)](mdn:js/Function/call) —— 用给定的上下文和参数调用 `func`。 - [func.apply(context, args)](mdn:js/Function/apply) —— 调用 `func` 将 `context` 作为 `this` 和类数组的 `args` 传递给参数列表。 -通用的 **呼叫转移(call forwarding)** 通常是使用 `apply` 完成的: +通用的 **调用传递(call forwarding)** 通常是使用 `apply` 完成的: ```js let wrapper = function() { diff --git a/1-js/06-advanced-functions/10-bind/6-ask-partial/task.md b/1-js/06-advanced-functions/10-bind/6-ask-partial/task.md index 64428b3b95..a0a7f19cb9 100644 --- a/1-js/06-advanced-functions/10-bind/6-ask-partial/task.md +++ b/1-js/06-advanced-functions/10-bind/6-ask-partial/task.md @@ -8,7 +8,7 @@ importance: 5 `user` 对象被修改了。现在不是两个函数 `loginOk/loginFail`,现在只有一个函数 `user.login(true/false)`。 -在下面的代码中,我们应该向 `askPassword` 传入什么参数,以使得 `user.login(true)` 结果是 `ok`,`user.login(fasle)` 结果是 `fail`? +在下面的代码中,我们应该向 `askPassword` 传入什么参数,以使得 `user.login(true)` 结果是 `ok`,`user.login(false)` 结果是 `fail`? ```js function askPassword(ok, fail) { diff --git a/1-js/06-advanced-functions/10-bind/article.md b/1-js/06-advanced-functions/10-bind/article.md index 6cae8ca561..d442ae1af8 100644 --- a/1-js/06-advanced-functions/10-bind/article.md +++ b/1-js/06-advanced-functions/10-bind/article.md @@ -275,7 +275,7 @@ alert( triple(5) ); // = mul(3, 5) = 15 ## 在没有上下文情况下的 partial -当我们想绑定一些参数(arguments),但是这里没有上下文 `this`,应该怎么办?例如,对于一个对象方法。 +当我们想绑定一些参数(arguments),但是不想绑定上下文 `this`,应该怎么办?例如,对于一个对象方法。 原生的 `bind` 不允许这种情况。我们不可以省略上下文直接跳到参数(arguments)。 @@ -319,7 +319,7 @@ user.sayNow("Hello"); ## 总结 -方法 `func.bind(context, ...args)` 返回函数 `func` 的"绑定的(bound)变体",它绑定了上下文 `this` 和第一个参数(如果给定了)。 +方法 `func.bind(context, ...args)` 返回函数 `func` 的"绑定的(bound)变体",它绑定了上下文 `this` 和 `...args` 参数。 通常我们应用 `bind` 来绑定对象方法的 `this`,这样我们就可以把它们传递到其他地方使用。例如,传递给 `setTimeout`。 diff --git a/1-js/08-prototypes/04-prototype-methods/article.md b/1-js/08-prototypes/04-prototype-methods/article.md index 377b4f5046..7f2e2ed156 100644 --- a/1-js/08-prototypes/04-prototype-methods/article.md +++ b/1-js/08-prototypes/04-prototype-methods/article.md @@ -214,7 +214,7 @@ alert(Object.keys(chineseDictionary)); // hello,bye - [Object.getPrototypeOf(obj)](mdn:js/Object/getPrototypeOf) —— 返回对象 `obj` 的 `[[Prototype]]`(与 `__proto__` 的 getter 相同)。 - [Object.setPrototypeOf(obj, proto)](mdn:js/Object/setPrototypeOf) —— 将对象 `obj` 的 `[[Prototype]]` 设置为 `proto`(与 `__proto__` 的 setter 相同)。 -- 不推荐使用内建的的 `__proto__` getter/setter 获取/设置原型,它现在在 ECMA 规范的附录 B 中。 +- 不推荐使用内建的 `__proto__` getter/setter 获取/设置原型,它现在在 ECMA 规范的附录 B 中。 - 我们还介绍了使用 `Object.create(null)` 或 `{__proto__: null}` 创建的无原型的对象。 diff --git a/1-js/09-classes/01-class/article.md b/1-js/09-classes/01-class/article.md index d49b005c37..c639144d59 100644 --- a/1-js/09-classes/01-class/article.md +++ b/1-js/09-classes/01-class/article.md @@ -317,7 +317,7 @@ new User().sayHi(); // Hello, John! 所以,我们就只需在表达式中写 " = ",就这样。 -类字段重要的不同之处在于,它们会在每个独立对象中被设好,而不是设在 `User.prototype`: +类字段的重要区别在于,它们会被挂在实例对象上,而非 `User.prototype` 上: ```js run class User { diff --git a/1-js/09-classes/03-static-properties-methods/article.md b/1-js/09-classes/03-static-properties-methods/article.md index 400e76093d..b9528fb5fc 100644 --- a/1-js/09-classes/03-static-properties-methods/article.md +++ b/1-js/09-classes/03-static-properties-methods/article.md @@ -1,7 +1,7 @@ # 静态属性和静态方法 -我们可以把一个方法作为一个整体赋值给类。这样的方法被称为 **静态的(static)**。 +我们还可以为整个类分配一个方法。这样的方法被称为 **静态的(static)**。 在一个类的声明中,它们以 `static` 关键字开头,如下所示: diff --git a/1-js/09-classes/04-private-protected-properties-methods/article.md b/1-js/09-classes/04-private-protected-properties-methods/article.md index ba4d4edb45..4396358d53 100644 --- a/1-js/09-classes/04-private-protected-properties-methods/article.md +++ b/1-js/09-classes/04-private-protected-properties-methods/article.md @@ -55,9 +55,9 @@ 在许多其他编程语言中,还存在"受保护"的字段:只能从类的内部和基于其扩展的类的内部访问(例如私有的,但可以从继承的类进行访问)。它们对于内部接口也很有用。从某种意义上讲,它们比私有的属性和方法更为广泛,因为我们通常希望继承类来访问它们。 -受保护的字段不是在语言级别的 Javascript 中实现的,但实际上它们非常方便,因为它们是在 Javascript 中模拟的类定义语法。 +受保护的字段不是在语言级别的 JavaScript 中实现的,但实际上它们非常方便,因为它们是在 JavaScript 中模拟的类定义语法。 -现在,我们将使用所有这些类型的属性在 Javascript 中制作咖啡机。咖啡机有很多细节,我们不会对它们进行全面模拟以保持简洁(尽管我们可以)。 +现在,我们将使用所有这些类型的属性在 JavaScript 中制作咖啡机。咖啡机有很多细节,我们不会对它们进行全面模拟以保持简洁(尽管我们可以)。 ## 受保护的 "waterAmount" @@ -188,7 +188,7 @@ new CoffeeMachine().setWaterAmount(100); [recent browser=none] -这儿有一个马上就会被加到规范中的已完成的 Javascript 提案,它为私有属性和方法提供语言级支持。 +这儿有一个马上就会被加到规范中的已完成的 JavaScript 提案,它为私有属性和方法提供语言级支持。 私有属性和方法应该以 `#` 开头。它们只在类的内部可被访问。 diff --git a/1-js/09-classes/05-extend-natives/article.md b/1-js/09-classes/05-extend-natives/article.md index c81b0b31cb..121970d71e 100644 --- a/1-js/09-classes/05-extend-natives/article.md +++ b/1-js/09-classes/05-extend-natives/article.md @@ -32,7 +32,7 @@ arr.constructor === PowerArray 甚至,我们可以定制这种行为。 -我们可以给这个类添加一个特殊的静态 getter `Symbol.species`。如果存在,则应返回 JavaScript 在内部用来在 `map` 和 `filter` 等方法中创建新实体的 `constructor`。 +我们可以给这个类添加一个特殊的静态 getter `Symbol.species`,它会返回 JavaScript 在内部用来在 `map` 和 `filter` 等方法中创建新实体的 `constructor`。 如果我们希望像 `map` 或 `filter` 这样的内建方法返回常规数组,我们可以在 `Symbol.species` 中返回 `Array`,就像这样: diff --git a/1-js/09-classes/07-mixins/article.md b/1-js/09-classes/07-mixins/article.md index 6ce70767cc..58465c7d83 100644 --- a/1-js/09-classes/07-mixins/article.md +++ b/1-js/09-classes/07-mixins/article.md @@ -2,13 +2,13 @@ 在 JavaScript 中,我们只能继承单个对象。每个对象只能有一个 `[[Prototype]]`。并且每个类只可以扩展另外一个类。 -但是有些时候这种设定(译注:单继承)会让人感到受限制。例如,我有一个 `StreetSweeper` 类和一个 `Bicycle` 类,现在想要一个它们的 mixin:`StreetSweepingBicycle` 类。 +但是有些时候这种设定(译注:单继承)会让人感到受限制。例如,我有一个 `StreetSweeper` 类和一个 `Bicycle` 类,现在想要一个它们的混合体:`StreetSweepingBicycle` 类。 或者,我们有一个 `User` 类和一个 `EventEmitter` 类来实现事件生成(event generation),并且我们想将 `EventEmitter` 的功能添加到 `User` 中,以便我们的用户可以触发事件(emit event)。 -有一个概念可以帮助我们,叫做 "mixins"。 +有一个概念可以帮助我们,叫做 "mixin"。 -根据维基百科的定义,[mixin](https://en.wikipedia.org/wiki/Mixin) 是一个包含可被其他类使用而无需继承的方法的类。 +根据维基百科的定义,[mixin](https://en.wikipedia.org/wiki/Mixin) 是一个类,其方法可被其他类使用,而无需继承。 换句话说,*mixin* 提供了实现特定行为的方法,但是我们不单独使用它,而是使用它来将这些行为添加到其他类中。 @@ -47,7 +47,7 @@ Object.assign(User.prototype, sayHiMixin); new User("Dude").sayHi(); // Hello Dude! ``` -这里没有继承,只有一个简单的方法拷贝。所以 `User` 可以从另一个类继承,还可以包括 mixin 来 "mix-in" 其它方法,就像这样: +这里没有继承,只有一个简单的方法拷贝。因此,我们可以让 `User` 在继承另一个类的同时,使用 mixin 来 "mix-in"(混合)其它方法,就像这样: ```js class User extends Person { @@ -103,7 +103,7 @@ new User("Dude").sayHi(); // Hello Dude! 这是因为方法 `sayHi` 和 `sayBye` 最初是在 `sayHiMixin` 中创建的。因此,即使复制了它们,但是它们的 `[[HomeObject]]` 内部属性仍引用的是 `sayHiMixin`,如上图所示。 -当 `super` 在 `[[HomeObject]].[[Prototype]]` 中寻找父方法时,意味着它搜索的是 `sayHiMixin.[[Prototype]]`,而不是 `User.[[Prototype]]`。 +当 `super` 在 `[[HomeObject]].[[Prototype]]` 中寻找父方法时,意味着它搜索的是 `sayHiMixin.[[Prototype]]`。 ## EventMixin diff --git a/1-js/10-error-handling/1-try-catch/article.md b/1-js/10-error-handling/1-try-catch/article.md index 5bdc6d49a5..744c079a7b 100644 --- a/1-js/10-error-handling/1-try-catch/article.md +++ b/1-js/10-error-handling/1-try-catch/article.md @@ -489,7 +489,7 @@ try { 1. 如果你对于 "Make an error?" 的回答是 "Yes",那么执行 `try -> catch -> finally`。 2. 如果你的回答是 "No",那么执行 `try -> finally`。 -`finally` 子句(clause)通常用在:当我们开始做某事的时候,希望无论出现什么情况都要完成完成某个任务。 +`finally` 子句(clause)通常用在:当我们开始做某事的时候,希望无论出现什么情况都要完成某个任务。 例如,我们想要测量一个斐波那契数字函数 `fib(n)` 执行所需要花费的时间。通常,我们可以在运行它之前开始测量,并在运行完成时结束测量。但是,如果在该函数调用期间出现 error 该怎么办?特别是,下面这段 `fib(n)` 的实现代码在遇到负数或非整数数字时会返回一个 error。 @@ -565,7 +565,7 @@ alert( func() ); // 先执行 finally 中的 alert,然后执行这个 alert ````smart header="`try...finally`" -没有 `catch` 子句的 `try...finally` 结构也很有用。当我们不想在这儿处理 error(让它们 fall through),但是需要确保我们启动的处理需要被完成。 +没有 `catch` 子句的 `try...finally` 结构也很有用。当我们不想在原地处理 error(让它们掉出去吧),但是需要确保我们启动的处理需要被完成时,我们应当使用它。 ```js function func() { @@ -662,7 +662,7 @@ try { Error 对象包含下列属性: -- `message` _ 人类可读的 error 信息。 +- `message` —— 人类可读的 error 信息。 - `name` —— 具有 error 名称的字符串(Error 构造器的名称)。 - `stack`(没有标准,但得到了很好的支持)—— Error 发生时的调用栈。 diff --git a/1-js/10-error-handling/2-custom-errors/article.md b/1-js/10-error-handling/2-custom-errors/article.md index ac80c7d102..7cf8a564a9 100644 --- a/1-js/10-error-handling/2-custom-errors/article.md +++ b/1-js/10-error-handling/2-custom-errors/article.md @@ -23,7 +23,7 @@ let json = `{ "name": "John", "age": 30 }`; 我们的 `ValidationError` 类应该继承自 `Error` 类。 -`Error` 类是内建的,但这是其近似代码,所以我们可以了解我们要扩展的内容: +`Error` 类是内建的,但我们可以通过下面这段近似代码理解我们要扩展的内容: ```js // JavaScript 自身定义的内建的 Error 类的"伪代码" @@ -36,7 +36,7 @@ class Error { } ``` -现在让我们从其中继承 `ValidationError`,并尝试进行运行: +现在让我们从其中继承 `ValidationError` 试一试: ```js run untrusted *!* @@ -247,7 +247,7 @@ try { 2. 函数`readUser` 将捕获内部发生的数据读取 error,例如 `ValidationError` 和 `SyntaxError`,并生成一个 `ReadError` 来进行替代。 3. 对象 `ReadError` 会把对原始 error 的引用保存在其 `cause` 属性中。 -之后,调用 `readUser` 的代码只需要检查 `ReadError`,而不必检查每种数据读取 error。并且,如果需要更多 error 细节,那么可以检查 `readUser` 的 `cause` 属性。 +之后,调用 `readUser` 的代码只需要检查 `ReadError`,而不必检查每种数据读取 error。并且,如果需要更多 error 细节,那么可以检查 `ReadError` 对象的 `cause` 属性。 下面的代码定义了 `ReadError`,并在 `readUser` 和 `try..catch` 中演示了其用法: diff --git a/1-js/11-async/01-callbacks/article.md b/1-js/11-async/01-callbacks/article.md index abc233e45a..6899f32be8 100644 --- a/1-js/11-async/01-callbacks/article.md +++ b/1-js/11-async/01-callbacks/article.md @@ -10,7 +10,7 @@ 但是,我们会尽全力使讲解变得更加清晰。在这儿不会有浏览器方面的真正复杂的东西。 ``` -JavaScript 主机(host)环境提供了许多函数,这些函数允许我们计划 **异步** 行为(action)。换句话说,我们现在开始执行的行为,但它们会在稍后完成。 +JavaScript 主机(host)环境提供了许多函数,这些函数允许我们计划 **异步** 行为(action)—— 也就是在我们执行一段时间后才自行完成的行为。 例如,`setTimeout` 函数就是一个这样的函数。 diff --git a/1-js/11-async/02-promise-basics/article.md b/1-js/11-async/02-promise-basics/article.md index 675ec81431..bcc265ed8f 100644 --- a/1-js/11-async/02-promise-basics/article.md +++ b/1-js/11-async/02-promise-basics/article.md @@ -12,7 +12,7 @@ 2. "消费者代码(consuming code)"想要在"生产者代码"完成工作的第一时间就能获得其工作成果。许多函数可能都需要这个结果。这些就是"粉丝"。 3. **Promise** 是将"生产者代码"和"消费者代码"连接在一起的一个特殊的 JavaScript 对象。用我们的类比来说:这就是就像是"订阅列表"。"生产者代码"花费它所需的任意长度时间来产出所承诺的结果,而 "promise" 将在它(译注:指的是"生产者代码",也就是下文所说的 executor)准备好时,将结果向所有订阅了的代码开放。 -这种类比并不十分准确,因为 JavaScipt 的 promise 比简单的订阅列表更加复杂:它们还拥有其他的功能和局限性。但以此开始挺好的。 +这种类比并不十分准确,因为 JavaScript 的 promise 比简单的订阅列表更加复杂:它们还拥有其他的功能和局限性。但以此开始挺好的。 Promise 对象的构造器(constructor)语法如下: @@ -83,7 +83,7 @@ let promise = new Promise(function(resolve, reject) { 与最初的 "pending" promise 相反,一个 resolved 或 rejected 的 promise 都会被称为 "settled"。 -````smart header="这只能有一个结果或一个 error" +````smart header="只有一个结果或一个 error" executor 只能调用一个 `resolve` 或一个 `reject`。任何状态的更改都是最终的。 所有其他的再对 `resolve` 和 `reject` 的调用都会被忽略: @@ -99,7 +99,7 @@ let promise = new Promise(function(resolve, reject) { }); ``` -这的宗旨是,一个被 executor 完成的工作只能有一个结果或一个 error。 +关键就在于,一个由 executor 完成的工作只能有一个结果或一个 error。 并且,`resolve/reject` 只需要一个参数(或不包含任何参数),并且将忽略额外的参数。 ```` @@ -118,7 +118,7 @@ let promise = new Promise(function(resolve, reject) { }); ``` -例如,当我们开始做一个任务时,但随后看到一切都已经完成并已被缓存时,可能就会发生这种情况。 +例如,当我们开始做一个任务,随后发现一切都已经完成并已被缓存时,可能就会发生这种情况。 这挺好。我们立即就有了一个 resolved 的 promise。 ```` @@ -294,7 +294,7 @@ new Promise((resolve, reject) => { // 下面这 promise 在被创建后立即变为 resolved 状态 let promise = new Promise(resolve => resolve("done!")); -promise.then(alert); // done!(现在显示) +promise.then(alert); // done!(立刻显示) ``` 请注意这使得 promise 比现实生活中的"订阅列表"方案强大得多。如果歌手已经发布了他们的单曲,然后某个人在订阅列表上进行了注册,则他们很可能不会收到该单曲。实际生活中的订阅必须在活动开始之前进行。 @@ -357,7 +357,7 @@ promise.then(script => alert('Another handler...')); | promise | callback | |----------|-----------| -| promise 允许我们按照自然顺序进行编码。首先,我们运行 `loadScript` 和 `.then` 来处理结果。| 在调用 `loadScript(script, callback)` 时,我们必须有一个 `callback` 函数可供使用。换句话说,在调用 `loadScript` **之前**,我们必须知道如何处理结果。| +| promise 允许我们按照自然顺序进行编码。首先,我们运行 `loadScript`,之后,用 `.then` 来处理结果。| 在调用 `loadScript(script, callback)` 时,我们必须有一个 `callback` 函数可供使用。换句话说,在调用 `loadScript` **之前**,我们必须知道如何处理结果。| | 我们可以根据需要,在 promise 上多次调用 `.then`。每次调用,我们都会在"订阅列表"中添加一个新的"粉丝",一个新的订阅函数。在下一章将对此内容进行详细介绍:[](info:promise-chaining)。 | 只能有一个回调。| diff --git a/1-js/11-async/05-promise-api/article.md b/1-js/11-async/05-promise-api/article.md index 9fdaa2d57e..1b5599601f 100644 --- a/1-js/11-async/05-promise-api/article.md +++ b/1-js/11-async/05-promise-api/article.md @@ -131,10 +131,10 @@ Promise.all([ ]).then(render); // render 方法需要所有 fetch 的数据 ``` -`Promise.allSettled` 等待所有的 promise 都被 settle,无论结果如何。结果数组具有: +`Promise.allSettled` 等待所有的 promise 都被 settle,无论结果如何。结果数组会是这样的: -- `{status:"fulfilled", value:result}` 对于成功的响应, -- `{status:"rejected", reason:error}` 对于 error。 +- 对成功的响应,结果数组对应元素的内容为 `{status:"fulfilled", value:result}`, +- 对出现 error 的响应,结果数组对应元素的内容为 `{status:"rejected", reason:error}`。 例如,我们想要获取(fetch)多个用户的信息。即使其中一个请求失败,我们仍然对其他的感兴趣。 diff --git a/1-js/11-async/08-async-await/article.md b/1-js/11-async/08-async-await/article.md index 6c9c88c20f..9b65060b60 100644 --- a/1-js/11-async/08-async-await/article.md +++ b/1-js/11-async/08-async-await/article.md @@ -307,4 +307,4 @@ Promise 前的关键字 `await` 使 JavaScript 引擎等待该 promise settle, 这两个关键字一起提供了一个很好的用来编写异步代码的框架,这种代码易于阅读也易于编写。 -有了 `async/await` 之后,我们就几乎不需要使用 `promise.then/catch`,但是不要忘了它们是基于 promise 的,因为有些时候(例如在最外层作用域)我们不得不使用这些方法。并且,当我们需要同时等待需要任务时,`Promise.all` 是很好用的。 +有了 `async/await` 之后,我们就几乎不需要使用 `promise.then/catch`,但是不要忘了它们是基于 promise 的,因为有些时候(例如在最外层作用域)我们不得不使用这些方法。并且,当我们需要同时等待多个任务时,`Promise.all` 是很好用的。 diff --git a/1-js/12-generators-iterators/2-async-iterators-generators/article.md b/1-js/12-generators-iterators/2-async-iterators-generators/article.md index 9aa2c7d658..4acdd82b82 100644 --- a/1-js/12-generators-iterators/2-async-iterators-generators/article.md +++ b/1-js/12-generators-iterators/2-async-iterators-generators/article.md @@ -394,7 +394,7 @@ async function* fetchCommits(repo) { ## 总结 -常规的 iterator 和 generator 可以很好地处理那些不需要花费时间来生成的的数据。 +常规的 iterator 和 generator 可以很好地处理那些不需要花费时间来生成的数据。 当我们期望异步地,有延迟地获取数据时,可以使用它们的异步版本,并且使用 `for await..of` 替代 `for..of`。 diff --git a/1-js/99-js-misc/01-proxy/article.md b/1-js/99-js-misc/01-proxy/article.md index 5c00256840..155ea6021f 100644 --- a/1-js/99-js-misc/01-proxy/article.md +++ b/1-js/99-js-misc/01-proxy/article.md @@ -154,7 +154,7 @@ dictionary = new Proxy(dictionary, { *!* get(target, phrase) { // 拦截读取属性操作 */!* - if (phrase in target) { //如果词典中有该短语 + if (phrase in target) { // 如果词典中有该短语 return target[phrase]; // 返回其翻译 } else { // 否则返回未翻译的短语 @@ -344,7 +344,7 @@ alert(user._password); // secret - `get` 读取此类属性时抛出错误, - `set` 写入属性时抛出错误, - `deleteProperty` 删除属性时抛出错误, -- `ownKeys` 在使用 `for..in` 和像 `Object.keys` 这样的的方法时排除以 `_` 开头的属性。 +- `ownKeys` 在使用 `for..in` 和像 `Object.keys` 这样的方法时排除以 `_` 开头的属性。 代码如下: @@ -726,7 +726,7 @@ alert(admin.name); // 输出:Guest (?!?) 问题实际上出在代理中,在 `(*)` 行。 -1. 当我们读取 `admin.name` 时,由于 `admin` 对象自身没有对应的的属性,搜索将转到其原型。 +1. 当我们读取 `admin.name` 时,由于 `admin` 对象自身没有对应的属性,搜索将转到其原型。 2. 原型是 `userProxy`。 3. 从代理读取 `name` 属性时,`get` 捕捉器会被触发,并从原始对象返回 `target[prop]` 属性,在 `(*)` 行。 @@ -934,7 +934,7 @@ Proxy 可以拦截许多操作符,例如 `new`(使用 `construct`),`in` 假设我们有一个资源,并且想随时关闭对该资源的访问。 -我们可以做的是将它包装成可一个撤销的代理,没有任何捕捉器。这样的代理会将操作转发给对象,并且我们可以随时将其禁用。 +我们可以做的是将它包装成一个可撤销的代理,没有任何捕捉器。这样的代理会将操作转发给对象,并且我们可以随时将其禁用。 语法为: diff --git a/1-js/99-js-misc/03-currying-partials/article.md b/1-js/99-js-misc/03-currying-partials/article.md index 2960f8eb70..6e6a5f2f16 100644 --- a/1-js/99-js-misc/03-currying-partials/article.md +++ b/1-js/99-js-misc/03-currying-partials/article.md @@ -165,7 +165,7 @@ function curried(...args) { 当我们运行它时,这里有两个 `if` 执行分支: 1. 如果传入的 `args` 长度与原始函数所定义的(`func.length`)相同或者更长,那么只需要使用 `func.apply` 将调用传递给它即可。 -2. 否则,获取一个部分应用函数:我们目前还没调用 `func`。取而代之的是,返回另一个包装器 `pass`,它将重新应用 `curried`,将之前传入的参数与新的参数一起传入。 +2. 否则,获取一个部分应用函数:我们目前还没调用 `func`。取而代之的是,返回另一个包装器,它将重新应用 `curried`,将之前传入的参数与新的参数一起传入。 然后,如果我们再次调用它,我们将得到一个新的部分应用函数(如果没有足够的参数),或者最终的结果。 diff --git a/1-js/99-js-misc/04-reference-type/article.md b/1-js/99-js-misc/04-reference-type/article.md index e5799e35cc..3f4b736eec 100644 --- a/1-js/99-js-misc/04-reference-type/article.md +++ b/1-js/99-js-misc/04-reference-type/article.md @@ -4,7 +4,7 @@ ```warn header="深入的语言特性" 本文所讲的是一个高阶主题,能帮你更好地理解一些边缘情况。 -这仅是锦上添花。许多经验丰富的的开发者不甚了了也过得不错。如果你想了解代码运行的本质,那就继续读下去吧。 +这仅是锦上添花。许多经验丰富的开发者不甚了了也过得不错。如果你想了解代码运行的本质,那就继续读下去吧。 ``` 一个动态执行的方法调用可能会丢失 `this`。 diff --git a/2-ui/1-document/02-dom-nodes/article.md b/2-ui/1-document/02-dom-nodes/article.md index 9c8b6a2cbd..2ee8d3b97f 100644 --- a/2-ui/1-document/02-dom-nodes/article.md +++ b/2-ui/1-document/02-dom-nodes/article.md @@ -216,7 +216,7 @@ drawHtmlTree(node6, 'div.domtree', 690, 500); 探索 DOM 的另一种方式是使用浏览器开发工具。实际上,这就是我们在开发中所使用的。 -你可以打开这个网页 [elks.html](elks.html),然后打开浏览器开发工具,并切换到元素(Elements)选项卡。 +你可以打开这个网页 [elk.html](elk.html),然后打开浏览器开发工具,并切换到元素(Elements)选项卡。 它看起来像这样: diff --git a/2-ui/1-document/08-styles-and-classes/article.md b/2-ui/1-document/08-styles-and-classes/article.md index 2ac22bcd10..5e7ed2d699 100644 --- a/2-ui/1-document/08-styles-and-classes/article.md +++ b/2-ui/1-document/08-styles-and-classes/article.md @@ -270,19 +270,6 @@ pseudo 例如,如果有 `paddingLeft/paddingTop` 属性,那么对于 `getComputedStyle(elem).padding`,我们会得到什么?什么都没有,或者是从已知的 padding 中"生成"的值?这里没有标准的规则。 -还有其他不一致的地方。例如,在下面这个例子中,某些浏览器(Chrome)会显示 `10px`,而某些浏览器(Firefox)则没有: - -```html run - - -``` ```` ```smart header="应用于 `:visited` 链接的样式被隐藏了!" diff --git a/2-ui/2-events/02-bubbling-and-capturing/article.md b/2-ui/2-events/02-bubbling-and-capturing/article.md index 27566dfb4b..69f4a27306 100644 --- a/2-ui/2-events/02-bubbling-and-capturing/article.md +++ b/2-ui/2-events/02-bubbling-and-capturing/article.md @@ -112,7 +112,7 @@ 2. 之后,我们决定捕获在整个窗口上的点击,以追踪用户的行为(用户点击的位置)。有些分析系统会这样做。通常,代码会使用 `document.addEventListener('click'...)` 来捕获所有的点击。 3. 我们的分析不适用于被 `stopPropagation` 所阻止点击的区域。太伤心了,我们有一个"死区"。 -通常,没有真正的必要去阻止冒泡。一项看似需要阻止冒泡的任务,可以通过其他方法解决。其中之一就是使用自定义事件,稍后我们会介绍它们此外,我们还可以将我们的数据写入一个处理程序中的 `event` 对象,并在另一个处理程序中读取该数据,这样我们就可以向父处理程序传递有关下层处理程序的信息。 +通常,没有真正的必要去阻止冒泡。一项看似需要阻止冒泡的任务,可以通过其他方法解决。其中之一就是使用自定义事件,稍后我们会介绍它们。此外,我们还可以将我们的数据写入一个处理程序中的 `event` 对象,并在另一个处理程序中读取该数据,这样我们就可以向父处理程序传递有关下层处理程序的信息。 ``` diff --git a/2-ui/99-ui-misc/02-selection-range/article.md b/2-ui/99-ui-misc/02-selection-range/article.md index 57b6eadecc..e863c79c2e 100644 --- a/2-ui/99-ui-misc/02-selection-range/article.md +++ b/2-ui/99-ui-misc/02-selection-range/article.md @@ -348,7 +348,7 @@ From – To 一章。 +否则,例如,如果主窗口来自于 `site.com`,弹窗来自于 `gmail.com`,则出于安全性考虑,这两个窗口不能访问彼此的内容。有关详细信息,请参见 一章。 ``` ## 从弹窗访问窗口 diff --git a/5-network/05-fetch-crossorigin/article.md b/5-network/05-fetch-crossorigin/article.md index 4ace5ef064..d5b662ecc1 100644 --- a/5-network/05-fetch-crossorigin/article.md +++ b/5-network/05-fetch-crossorigin/article.md @@ -211,6 +211,7 @@ Access-Control-Expose-Headers: Content-Length,API-Key - `Access-Control-Request-Method` header 带有非安全请求的方法。 - `Access-Control-Request-Headers` header 提供一个以逗号分隔的非安全 HTTP-header 列表。 +- `Origin` header 说明请求来自哪里。(如 https://javascript.info) 如果服务器同意处理请求,那么它会进行响应,此响应的状态码应该为 200,没有 body,具有 header: diff --git a/6-data-storage/01-cookie/article.md b/6-data-storage/01-cookie/article.md index 9701b8e324..4c9d81abd9 100644 --- a/6-data-storage/01-cookie/article.md +++ b/6-data-storage/01-cookie/article.md @@ -135,7 +135,7 @@ alert(document.cookie); // 有 cookie user=John ## expires,max-age -默认情况下,如果一个 cookie 没有设置这两个参数中的任何一个,那么在关闭浏览器之后,它就会消失。此类 cookie 被称为 "session cookie"。 +默认情况下,如果一个 cookie 这两个参数都没有设置,那么在关闭浏览器之后,它就会消失。此类 cookie 被称为 "session cookie"。 为了让 cookie 在浏览器关闭后仍然存在,我们可以设置 `expires` 或 `max-age` 选项中的一个。 diff --git a/7-animation/1-bezier-curve/article.md b/7-animation/1-bezier-curve/article.md index 9a272323a2..971fc072d0 100644 --- a/7-animation/1-bezier-curve/article.md +++ b/7-animation/1-bezier-curve/article.md @@ -8,7 +8,7 @@ [贝塞尔曲线](https://en.wikipedia.org/wiki/B%C3%A9zier_curve)由控制点定义。 -这些点可能有 2、3、4 或更多。 +这些点可能有 2、3、4 个或更多。 例如,两点曲线: diff --git a/8-web-components/index.md b/8-web-components/index.md index f572ed3d41..f77d57d073 100644 --- a/8-web-components/index.md +++ b/8-web-components/index.md @@ -1,3 +1,3 @@ # Web components -Web components is a set of standards to make self-contained components: custom HTML-elements with their own properties and methods, encapsulated DOM and styles. +Web components 是用于创建独立组件的一组标准:自定义 HTML 元素,它们具有自己的属性和方法,封装好的 DOM 和样式。 diff --git a/9-regular-expressions/04-regexp-anchors/1-start-end/solution.md b/9-regular-expressions/04-regexp-anchors/1-start-end/solution.md index dbab1467fe..eea1d4dfdd 100644 --- a/9-regular-expressions/04-regexp-anchors/1-start-end/solution.md +++ b/9-regular-expressions/04-regexp-anchors/1-start-end/solution.md @@ -2,4 +2,4 @@ 这个题目再次证明了锚点不是字符串,而是测试。 -对于空字符串 `""`,正则表达式引擎将会首先匹配 `pattern:^`(输入开始),匹配成功,然后立即匹配结束 `pattern:$`,也匹配成功。所空字符串是匹配项。 +对于空字符串 `""`,正则表达式引擎将会首先匹配 `pattern:^`(输入开始),匹配成功,然后立即匹配结束 `pattern:$`,也匹配成功。所以空字符串是匹配项。 diff --git a/9-regular-expressions/07-regexp-escaping/article.md b/9-regular-expressions/07-regexp-escaping/article.md index 1457b3674e..a920c222e1 100644 --- a/9-regular-expressions/07-regexp-escaping/article.md +++ b/9-regular-expressions/07-regexp-escaping/article.md @@ -92,7 +92,7 @@ let regexp = new RegExp(regStr); alert( "Chapter 5.1".match(regexp) ); // 5.1 ``` -## Summary +## 总结 - 要在字面意义上搜索特殊字符 `pattern:[ \ ^ $ . | ? * + ( )`,我们需要在它们前面加上一个反斜杠 `\`("转义它们")。 - 如果在 `pattern:/.../` 内(但不在 `new RegExp` 内),我们还需要转义 `/`。 diff --git a/README.md b/README.md index 5fe9f5649e..f92de9b00a 100755 --- a/README.md +++ b/README.md @@ -3,49 +3,15 @@ [![Gitter](https://img.shields.io/badge/chat-Gitter-forest.svg)](https://gitter.im/zh-javascript-info/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [![Telegram](https://img.shields.io/badge/chat-Telegram-blue.svg)](https://t.me/TheModernJavaScriptTutorial) -本教程为 [React 官方文档](https://reactjs.org/docs/getting-started.html#javascript-resources) 与 [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) 共同推荐的前端教程,持续更新,永久免费,欢迎扫码关注微信公众号,加入读者群。群内自由交流技术,群友帮忙答疑,共同进步! +本教程为 [React 官方文档](https://reactjs.org/docs/getting-started.html#javascript-resources) 与 [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) 共同推荐的前端教程,持续更新,永久免费,欢迎扫码关注微信公众号,加入读者群。 - - -| 微信扫码关注官方订阅号,订阅更多精彩内容 | -|-| -| | -| | - -**加入读者交流群:** - -- **微信群**:加微信 **`imleviding`** 或 [扫二维码](https://user-images.githubusercontent.com/26959437/64596211-0fa63380-d3e6-11e9-983d-bd788ffe2370.jpg),验证信息填写 **`JS 教程`**。 -- **QQ 群**:打开 QQ 搜索群号 **`955916282`** 或 [扫二维码](https://user-images.githubusercontent.com/26959437/138594800-29700a46-0cb1-45bd-b614-4b6486cf0124.jpg),验证信息填写 **`JS 教程`**。 - -教程配套每日一题:https://github.com/leviding/one-note-a-day +| 微信扫码关注公众号,加微信好友进群 | +|:----------------------------:| +| | +| 加好友请备注 `JS`,不备注不通过 | 本项目托管了现代 JavaScript 教程中文版的内容,此内容发布在 [https://zh.javascript.info](https://zh.javascript.info) -## Mock 工具 - - - -分享一个好用的开源接口 Mock 工具:[https://github.com/eolinker/eoapi](https://datayi.cn/w/nRbOawVP) - -除了 Mock 功能,还集合了 API 管理和测试功能,还可以通过插件广场帮助你将 API 发布到各个应用平台,比如发布到网关上完成 API 上线,或者和低代码平台结合,将 API 快速变成低代码平台中可使用的组件等。 - - - - ## 目录 - [翻译](#翻译) @@ -158,21 +124,21 @@ ``` ```md -`ReadableStream` objects 允許一个个资料块(chunk)地读取资料。 +`ReadableStream` objects 允许一个个资料块(chunk)地读取资料。 ``` ### 标点符号 - 本教程标点符号格式采用 [此份指南](https://github.com/sparanoid/chinese-copywriting-guidelines)。 -- 资料链接、**增強**,都须 [留下空白](https://github.com/sparanoid/chinese-copywriting-guidelines#%E9%8F%88%E6%8E%A5%E4%B9%8B%E9%96%93%E5%A2%9E%E5%8A%A0%E7%A9%BA%E6%A0%BC)。 +- 资料链接、**粗体**,都须 [留下空白](https://github.com/sparanoid/chinese-copywriting-guidelines#%E9%8F%88%E6%8E%A5%E4%B9%8B%E9%96%93%E5%A2%9E%E5%8A%A0%E7%A9%BA%E6%A0%BC)。 - 中文无斜体形式,英文的斜体翻译至中文改为 **加粗**。 - 斜线号 `/` 较为特殊,若用于分隔两同类型词条时,请维持半形斜线且两侧不加空白,**但在词汇们整体的前后要留一空白做分隔:** - `Increment/decrement can only be applied to variables.`:`递增/递减 只能被套用在变量上。` - `If the result of increment/decrement is not used, ...`:`如果 递增/递减 的結果没被使用,...` -- 语一句话只能有一个逗号,但中文无此限制,可依据语气通顺程度将一些英文句点转为逗号。 +- 英文一句话只能有一个逗号,但中文无此限制,可依据语气通顺程度将一些英文句点转为逗号。 - 列举项目后的文字需加句号。<- 像这样 @@ -283,9 +249,18 @@ importance: 5 本中文版教程的核心维护者 🚀 -- LeviDing [@leviding](https://github.com/leviding) -- Martin [@MartinsYong](https://github.com/MartinsYong) -- Bemself [bemself](https://github.com/bemself) -- LycheeEng [@lycheeEng](https://github.com/lycheeEng) +**Admin:** + +- [LeviDing](https://github.com/leviding) + +**当前活跃维护者:** + +- [LeviDing](https://github.com/leviding) + +**历史核心维护者:** + +- [MartinsYong](https://github.com/MartinsYong) +- [bemself](https://github.com/bemself) +- [lycheeEng](https://github.com/lycheeEng) 我们希望与大家合作维护本教程。本教程的详细贡献者列表请见:。

AltStyle によって変換されたページ (->オリジナル) /