From 66dcfdadac7de0c6339b8008e4b1a65a5cc7ef6b Mon Sep 17 00:00:00 2001 From: ruanyf Date: Mon, 10 Dec 2018 16:24:12 +0800 Subject: [PATCH 001/253] docs(bom): fix xmlHttpRequest --- docs/bom/xmlhttprequest.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/bom/xmlhttprequest.md b/docs/bom/xmlhttprequest.md index 83f3a67..edac4bc 100644 --- a/docs/bom/xmlhttprequest.md +++ b/docs/bom/xmlhttprequest.md @@ -95,7 +95,7 @@ if (xhr.readyState === 4) { } ``` -上面代码中，`xhr.readyState`等于`4`时，表明脚本发出的 HTTP 请求已经成功。其他情况，都表示 HTTP 请求还在进行中。 +上面代码中，`xhr.readyState`等于`4`时，表明脚本发出的 HTTP 请求已经完成。其他情况，都表示 HTTP 请求还在进行中。 ### XMLHttpRequest.onreadystatechange @@ -247,7 +247,7 @@ xhr.send(null); - 200, OK，访问正常 - 301, Moved Permanently，永久移动 -- 302, Move temporarily，暂时移动 +- 302, Moved temporarily，暂时移动 - 304, Not Modified，未修改 - 307, Temporary Redirect，暂时重定向 - 401, Unauthorized，未授权 From 4c2983eef1d5ea4f0600b8e23a8c530746c7caf8 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Tue, 11 Dec 2018 13:10:32 +0800 Subject: [PATCH 002/253] docs(features): fix style --- docs/features/style.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/features/style.md b/docs/features/style.md index 2016d42..ac92ee8 100644 --- a/docs/features/style.md +++ b/docs/features/style.md @@ -448,13 +448,10 @@ function doAction(action) { switch (action) { case 'hack': return 'hack'; - break; case 'slash': return 'slash'; - break; case 'run': return 'run'; - break; default: throw new Error('Invalid action.'); } From 64ae2a94c4e49d9a95bcba368aa3c20dd79f6f41 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Sat, 15 Dec 2018 23:50:00 +0800 Subject: [PATCH 003/253] docs(bom): fix history --- docs/bom/history.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/bom/history.md b/docs/bom/history.md index 092bcbc..9efb558 100644 --- a/docs/bom/history.md +++ b/docs/bom/history.md @@ -29,6 +29,15 @@ History 对象主要有两个属性。 - `History.length`：当前窗口访问过的网址数量（包括当前网页） - `History.state`：History 堆栈最上层的状态值（详见下文） +```javascript +// 当前窗口访问过多少个网页 +window.history.length // 1 + +// Histroy 对象的当前状态 +// 通常是 undefined，即未设置 +window.history.state // undefined +``` + ## 方法 ### History.back()、History.forward()、History.go() @@ -48,7 +57,7 @@ history.go(-2); `history.go(0)`相当于刷新当前页面。 ```javascript -history.go(0);记录 +history.go(0); // 刷新当前页面 ``` 注意，移动到以前访问过的页面时，页面通常是从浏览器缓存之中加载，而不是重新要求服务器发送新的网页。 From 8c088b10f8a1564a67be13252e502e8f7d53e057 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Mon, 17 Dec 2018 15:32:14 +0800 Subject: [PATCH 004/253] docs(dom): fix css --- docs/dom/css.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/dom/css.md b/docs/dom/css.md index b7d6aa0..f9e020a 100644 --- a/docs/dom/css.md +++ b/docs/dom/css.md @@ -89,11 +89,11 @@ divStyle.cssText = ''; ```javascript // HTML 代码如下 //
var myDiv = document.getElementById('myDiv'); var divStyle = myDiv.style; -divStyles.length // 3 +divStyle.length // 3 ``` 上面代码中，`myDiv`元素的行内样式共包含3条样式规则。 From 4bf1b31b570f3583ca57f1975d23fe98e337d254 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Thu, 20 Dec 2018 15:48:01 +0800 Subject: [PATCH 005/253] docs(elements): fix a #83 --- docs/elements/a.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/elements/a.md b/docs/elements/a.md index 467fb74..188f0eb 100644 --- a/docs/elements/a.md +++ b/docs/elements/a.md @@ -22,7 +22,7 @@ ```javascript // HTML 代码如下 -// test +// test var a = document.getElementById('test'); a.hash // "#foo" a.host // "example.com:8081" From 88b64db046c885f46c70e4c958418b5eb50430c3 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Fri, 21 Dec 2018 13:37:58 +0800 Subject: [PATCH 006/253] docs(stdlib): fix object --- docs/features/console.md | 2 +- docs/stdlib/object.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/features/console.md b/docs/features/console.md index 2e1ffc8..0dc237a 100644 --- a/docs/features/console.md +++ b/docs/features/console.md @@ -11,7 +11,7 @@ `console`对象的浏览器实现，包含在浏览器自带的开发工具之中。以 Chrome 浏览器的“开发者工具”（Developer Tools）为例，可以使用下面三种方法的打开它。 -1. 按 F12 或者`Control + Shift + i`（PC）/ `Alt + Command + i`（Mac）。 +1. 按 F12 或者`Control + Shift + i`（PC）/ `Command + Option + i`（Mac）。 2. 浏览器菜单选择“工具/开发者工具”。 3. 在一个页面元素上，打开右键菜单，选择其中的“Inspect Element”。 diff --git a/docs/stdlib/object.md b/docs/stdlib/object.md index 627c0ce..bc94be6 100644 --- a/docs/stdlib/object.md +++ b/docs/stdlib/object.md @@ -405,10 +405,10 @@ obj.toLocaleString(obj) // "[object Object]" ```javascript var person = { - toString(): function () { + toString: function () { return 'Henry Norman Bethune'; }, - toLocaleString(): function () { + toLocaleString: function () { return '白求恩'; } }; From c8ce1f912e91bb1463295e19d013bec4bd95171f Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Sat, 22 Dec 2018 14:56:09 +0800 Subject: [PATCH 007/253] =?UTF-8?q?constructor=20=E6=8B=BC=E5=86=99?= =?UTF-8?q?=E6=9C=89=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原文中 constructor 被拼写为 'contructor' --- docs/oop/prototype.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/oop/prototype.md b/docs/oop/prototype.md index 6741806..410df6b 100644 --- a/docs/oop/prototype.md +++ b/docs/oop/prototype.md @@ -146,7 +146,7 @@ mine instanceof Array // true 上面代码中，`mine`是构造函数`MyArray`的实例对象，由于`MyArray.prototype`指向一个数组实例，使得`mine`可以调用数组方法（这些方法定义在数组实例的`prototype`对象上面）。最后那行`instanceof`表达式，用来比较一个对象是否为某个构造函数的实例，结果就是证明`mine`为`Array`的实例，`instanceof`运算符的详细解释详见后文。 -上面代码还出现了原型对象的`contructor`属性，这个属性的含义下一节就来解释。 +上面代码还出现了原型对象的`constructor`属性，这个属性的含义下一节就来解释。 ### constructor 属性 @@ -219,7 +219,7 @@ Person.prototype.constructor === Person // false Person.prototype.constructor === Object // true ``` -上面代码中，构造函数`Person`的原型对象改掉了，但是没有修改`constructor`属性，导致这个属性不再指向`Person`。由于`Person`的新原型是一个普通对象，而普通对象的`contructor`属性指向`Object`构造函数，导致`Person.prototype.constructor`变成了`Object`。 +上面代码中，构造函数`Person`的原型对象改掉了，但是没有修改`constructor`属性，导致这个属性不再指向`Person`。由于`Person`的新原型是一个普通对象，而普通对象的`constructor`属性指向`Object`构造函数，导致`Person.prototype.constructor`变成了`Object`。 所以，修改原型对象时，一般要同时修改`constructor`属性的指向。 From 5fecb37a0b53f0956da5ae12b4ab31f8a20fae6b Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Tue, 25 Dec 2018 17:48:36 +0800 Subject: [PATCH 008/253] Update css.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 使阅读更流畅 --- docs/dom/css.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dom/css.md b/docs/dom/css.md index f9e020a..2399616 100644 --- a/docs/dom/css.md +++ b/docs/dom/css.md @@ -756,7 +756,7 @@ var mdl = window.matchMedia('(min-width: 400px)'); mdl instanceof MediaQueryList // true ``` -注意，如果参数不是有效的`MediaQuery`条件语句，`window.matchMedia`不会报错，依然返回的一个 MediaQueryList 实例。 +注意，如果参数不是有效的`MediaQuery`条件语句，`window.matchMedia`不会报错，依然返回一个 MediaQueryList 实例。 ```javascript window.matchMedia('bad string') instanceof MediaQueryList // true From 05b852a29667633330ec49d24d898b6d99653b00 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Tue, 25 Dec 2018 21:02:50 +0800 Subject: [PATCH 009/253] docs(types): fix object #88 --- docs/types/object.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/types/object.md b/docs/types/object.md index 14df71c..9e50984 100644 --- a/docs/types/object.md +++ b/docs/types/object.md @@ -171,10 +171,19 @@ y // 1 JavaScript 引擎读到上面这行代码，会发现可能有两种含义。第一种可能是，这是一个表达式，表示一个包含`foo`属性的对象；第二种可能是，这是一个语句，表示一个代码区块，里面有一个标签`foo`，指向表达式`123`。 -为了避免这种歧义，V8 引擎规定，如果行首是大括号，一律解释为对象。不过，为了避免歧义，最好在大括号前加上圆括号。 +为了避免这种歧义，JavaScript 引擎的做法是，如果遇到这种情况，无法确定是对象还是代码块，一律解释为代码块。 ```javascript -({ foo: 123}) +{ console.log(123) } // 123 +``` + +上面的语句是一个代码块，而且只有解释为代码块，才能执行。 + +如果要解释为对象，最好在大括号前加上圆括号。因为圆括号的里面，只能是表达式，所以确保大括号只能解释为对象。 + +```javascript +({ foo: 123 }) // 正确 +({ console.log(123) }) // 报错 ``` 这种差异在`eval`语句（作用是对字符串求值）中反映得最明显。 From dd9ddb0a17bcfbcbfe9db51655ece037bb1175cd Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Wed, 26 Dec 2018 13:44:52 +0800 Subject: [PATCH 010/253] Update event.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 语句不完整 --- docs/events/event.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/events/event.md b/docs/events/event.md index 1f61b59..4716005 100644 --- a/docs/events/event.md +++ b/docs/events/event.md @@ -134,7 +134,7 @@ para.addEventListener('click', hide, false); ### Event.type -`Event.type`属性返回一个字符串，表示事件类型。事件的类型是在生成事件的时候。该属性只读。 +`Event.type`属性返回一个字符串，表示事件类型。事件的类型是在生成事件的时候指定的。该属性只读。 ```javascript var evt = new Event('foo'); From d3ba8b8b8d7feb736a484309e6670d1515fd68b2 Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Wed, 26 Dec 2018 18:52:53 +0800 Subject: [PATCH 011/253] Update touch.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 语句缺失 --- docs/events/touch.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/events/touch.md b/docs/events/touch.md index 2e311e3..62a3654 100644 --- a/docs/events/touch.md +++ b/docs/events/touch.md @@ -8,7 +8,7 @@ - TouchList：多个触摸点的集合 - TouchEvent：触摸引发的事件实例 -`Touch`接口的实例对象用来触摸点（一根手指或者一根触摸笔），包括位置、大小、形状、压力、目标元素等属性。有时，触摸动作由多个触摸点（多根手指）组成，多个触摸点的集合由`TouchList`接口的实例对象表示。`TouchEvent`接口的实例对象代表由触摸引发的事件，只有触摸屏才会引发这一类事件。 +`Touch`接口的实例对象用来表示触摸点（一根手指或者一根触摸笔），包括位置、大小、形状、压力、目标元素等属性。有时，触摸动作由多个触摸点（多根手指）组成，多个触摸点的集合由`TouchList`接口的实例对象表示。`TouchEvent`接口的实例对象代表由触摸引发的事件，只有触摸屏才会引发这一类事件。 很多时候，触摸事件和鼠标事件同时触发，即使这个时候并没有用到鼠标。这是为了让那些只定义鼠标事件、没有定义触摸事件的代码，在触摸屏的情况下仍然能用。如果想避免这种情况，可以用`event.preventDefault`方法阻止发出鼠标事件。 From 1ed37253c6648f6faaee1561663112835853a7d5 Mon Sep 17 00:00:00 2001 From: ruanyf Date: Thu, 27 Dec 2018 17:04:36 +0800 Subject: [PATCH 012/253] docs(stdlib): fix attributes/hasOwnproperty --- docs/stdlib/attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/stdlib/attributes.md b/docs/stdlib/attributes.md index b85182d..5146b49 100644 --- a/docs/stdlib/attributes.md +++ b/docs/stdlib/attributes.md @@ -550,7 +550,7 @@ extend({}, { get a(){ return 1 } }) // { get a(){ return 1 } }) ``` -上面代码中，`hasOwnProperty`那一行用来过滤掉继承的属性，否则会报错，因为`Object.getOwnPropertyDescriptor`读不到继承属性的属性描述对象。 +上面代码中，`hasOwnProperty`那一行用来过滤掉继承的属性，否则可能会报错，因为`Object.getOwnPropertyDescriptor`读不到继承属性的属性描述对象。 ## 控制对象状态 From 8369d1396ad8b8b8d3c0b4ec5a4a39e48e64d862 Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Thu, 27 Dec 2018 17:13:33 +0800 Subject: [PATCH 013/253] Update window.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 拼写错误 --- docs/bom/window.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/bom/window.md b/docs/bom/window.md index 993fd9b..49a2652 100644 --- a/docs/bom/window.md +++ b/docs/bom/window.md @@ -27,7 +27,7 @@ console.log(window.name) 该属性只能保存字符串，如果写入的值不是字符串，会自动转成字符串。各个浏览器对这个值的储存容量有所不同，但是一般来说，可以高达几MB。 -只要浏览器窗口不关闭，这个属性是不会消失的。举例来说，访问`a.com`时，该页面的脚本设置了`window.name`，接下来在同一个窗口里面载入了`b.com`，新页面的脚本可以读到上一个网页设置的`window.name`。页面刷新也是这种情况。一旦浏览器窗口关闭后，该属性保存的值就会消失，因为这是窗口已经不存在了。 +只要浏览器窗口不关闭，这个属性是不会消失的。举例来说，访问`a.com`时，该页面的脚本设置了`window.name`，接下来在同一个窗口里面载入了`b.com`，新页面的脚本可以读到上一个网页设置的`window.name`。页面刷新也是这种情况。一旦浏览器窗口关闭后，该属性保存的值就会消失，因为这时窗口已经不存在了。 ### window.closed，window.opener @@ -609,7 +609,7 @@ window.requestIdleCallback(callback[, options]) `options`参数是一个配置对象，目前只有`timeout`一个属性，用来指定回调函数推迟执行的最大毫秒数。该参数可选。 -`window.requestIdelCallback()`方法返回一个整数。该整数可以传入`window.cancelIdleCallback()`取消回调函数。 +`window.requestIdleCallback()`方法返回一个整数。该整数可以传入`window.cancelIdleCallback()`取消回调函数。 下面是一个例子。 @@ -635,7 +635,7 @@ requestIdleCallback(processPendingAnalyticsEvents, { timeout: 2000 }); 如果由于超时导致回调函数执行，则`deadline.timeRemaining()`返回`0`，`deadline.didTimeout`返回`true`。 -如果多次执行`window.requestIdelCallback()`，指定多个回调函数，那么这些回调函数将排成一个队列，按照先进先出的顺序执行。 +如果多次执行`window.requestIdleCallback()`，指定多个回调函数，那么这些回调函数将排成一个队列，按照先进先出的顺序执行。 ## 事件 From c17a25a3cbac73c839bf5682e19e9e71c73fca09 Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Sat, 29 Dec 2018 17:03:06 +0800 Subject: [PATCH 014/253] Update cors.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 使语句表达更清晰 --- docs/bom/cors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/bom/cors.md b/docs/bom/cors.md index aa41f83..35d8341 100644 --- a/docs/bom/cors.md +++ b/docs/bom/cors.md @@ -107,7 +107,7 @@ xhr.withCredentials = false; 非简单请求是那种对服务器提出特殊要求的请求，比如请求方法是`PUT`或`DELETE`，或者`Content-Type`字段的类型是`application/json`。 -非简单请求的 CORS 请求，会在正式通信之前，增加一次 HTTP 查询请求，称为“预检”请求（preflight）。浏览器先询问服务器，当前网页所在的域名是否在服务器的许可名单之中，以及可以使用哪些 HTTP 动词和头信息字段。只有得到肯定答复，浏览器才会发出正式的`XMLHttpRequest`请求，否则就报错。这是为了防止这些新增的请求，对传统的没有 CORS 支持的服务器形成压力，给服务器一个提前拒绝的机会，这样可以防止服务器大量收到`DELETE`和`PUT`请求，这些传统的表单不可能跨域发出的请求。 +非简单请求的 CORS 请求，会在正式通信之前，增加一次 HTTP 查询请求，称为“预检”请求（preflight）。浏览器先询问服务器，当前网页所在的域名是否在服务器的许可名单之中，以及可以使用哪些 HTTP 动词和头信息字段。只有得到肯定答复，浏览器才会发出正式的`XMLHttpRequest`请求，否则就报错。这是为了防止这些新增的请求，对传统的没有 CORS 支持的服务器形成压力，给服务器一个提前拒绝的机会，这样可以防止服务器收到大量`DELETE`和`PUT`请求，这些传统的表单不可能跨域发出的请求。 下面是一段浏览器的 JavaScript 脚本。 From f22060b02483b932a561a6b80e1475c84f2ff728 Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Sun, 30 Dec 2018 13:51:37 +0800 Subject: [PATCH 015/253] Update location.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 语义不明确 --- docs/bom/location.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/bom/location.md b/docs/bom/location.md index 78698a7..5853345 100644 --- a/docs/bom/location.md +++ b/docs/bom/location.md @@ -553,7 +553,7 @@ params.toString() // "a=2&a=1&b=3&c=4" ### URLSearchParams.keys()，URLSearchParams.values()，URLSearchParams.entries() -这三个方法都返回一个遍历器对象，供`for...of`循环消费。它们的区别在于，`keys`方法返回的是键名的遍历器，`values`方法返回的是键值的遍历器，`entries`返回的是键值的遍历器。 +这三个方法都返回一个遍历器对象，供`for...of`循环消费。它们的区别在于，`keys`方法返回的是键名的遍历器，`values`方法返回的是键值的遍历器，`entries`返回的是键值对的遍历器。 ```javascript var params = new URLSearchParams('a=1&b=2'); From 873545468303a0bc8894377bc262d2703afedf56 Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Mon, 31 Dec 2018 14:09:51 +0800 Subject: [PATCH 016/253] Update input.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 格式错误 --- docs/elements/input.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/elements/input.md b/docs/elements/input.md index f08f20b..39ae056 100644 --- a/docs/elements/input.md +++ b/docs/elements/input.md @@ -38,7 +38,8 @@ - `min`：字符串，表示该节点的最小数值或日期，且不能大于`max`属性。该属性可读写。 - `max`：字符串，表示该节点的最大数值或日期，且不能小于`min`属性。该属性可读写。 - `selectionStart`：整数，表示选中文本的起始位置。如果没有选中文本，返回光标在``元素内部的位置。该属性可读写。 -- `selectionEnd`：整数，表示选中文本的结束位置。如果没有选中文本，返回光标在``元素内部的位置。该属性可读写。- `selectionDirection`：字符串，表示选中文本的方向。可能的值包括`forward`（与文字书写方向一致）、`backward`（与文字书写方向相反）和`none`（文字方向未知）。该属性可读写。 +- `selectionEnd`：整数，表示选中文本的结束位置。如果没有选中文本，返回光标在``元素内部的位置。该属性可读写。 +- `selectionDirection`：字符串，表示选中文本的方向。可能的值包括`forward`（与文字书写方向一致）、`backward`（与文字书写方向相反）和`none`（文字方向未知）。该属性可读写。 ### 复选框和单选框的特有属性 From 5c9b34e4a3022bfb9ecdfac38222379d175fa41a Mon Sep 17 00:00:00 2001 From: byog <7764115+byog@users.noreply.github.com> Date: Mon, 31 Dec 2018 14:16:45 +0800 Subject: [PATCH 017/253] Update input.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 表意不明确 --- docs/elements/input.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/elements/input.md b/docs/elements/input.md index f08f20b..3f70bf5 100644 --- a/docs/elements/input.md +++ b/docs/elements/input.md @@ -84,7 +84,7 @@ - `click()`：模拟鼠标点击当前的``元素。 - `setSelectionRange()`：选中``元素内部的一段文本，但不会将焦点转移到选中的文本。该方法接受三个参数，第一个参数是开始的位置（从0开始），第二个参数是结束的位置（不包括该位置），第三个参数是可选的，表示选择的方向，有三个可能的值（`forward`、`backward`和默认值`none`）。 - `setRangeText()`：新文本替换选中的文本。该方法接受四个参数，第一个参数是新文本，第二个参数是替换的开始位置，第三个参数是结束位置，第四个参数表示替换后的行为（可选），有四个可能的值：`select`（选中新插入的文本）、`start`（选中的开始位置移到插入的文本之前）、`end`（选中的文本移到插入的文本之后）、`preserve`（保留原先选中的位置，默认值）。 -- `setCustomValidity()`：该方法调用后，会提示用户校验失败。它的参数就是报错的提示信息。 +- `setCustomValidity()`：该方法调用后，会在校验失败时以自定义的错误信息提示用户。它的参数就是报错的提示信息。 - `checkValidity()`：返回一个布尔值，表示当前节点的校验结果。如果返回`false`，表示不满足校验要求，否则就是校验成功或不必校验。 - `stepDown()`：将当前``节点的值减少一个步长。该方法可以接受一个整数`n`作为参数，表示一次性减少`n`个步长，默认是`1`。有几种情况会抛错：当前``节点不适合递减或递增、当前节点没有`step`属性、``节点的值不能转为数字、递减之后的值小于`min`属性或大于`max`属性。 - `stepUp()`：将当前``节点的值增加一个步长。其他与`stepDown()`方法相同。 From 28d08b429959ae49559d6a32669af6f13b9464fd Mon Sep 17 00:00:00 2001 From: ruanyf Date: Wed, 2 Jan 2019 22:49:35 +0800 Subject: [PATCH 018/253] docs(dom): fix node/getRootNode() --- docs/dom/node.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/dom/node.md b/docs/dom/node.md index 7dfd852..be9f4a3 100644 --- a/docs/dom/node.md +++ b/docs/dom/node.md @@ -558,7 +558,7 @@ wrapper.childNodes.length // 1 ### Node.prototype.getRootNode() -`getRootNode`方法返回当前节点所在文档的根节点，与`ownerDocument`属性的作用相同。 +`getRootNode()`方法返回当前节点所在文档的根节点`document`，与`ownerDocument`属性的作用相同。 ```javascript document.body.firstChild.getRootNode() === document @@ -567,3 +567,10 @@ document.body.firstChild.getRootNode() === document.body.firstChild.ownerDocumen // true ``` +该方法可用于`document`节点自身，这一点与`document.ownerDocument`不同。 + +```javascript +document.getRootNode() // document +document.ownerDocument // null +``` + From ed3b9030f018f245cbfcf142704e0d6ab72ea76b Mon Sep 17 00:00:00 2001 From: Fengyuan Chen Date: Thu, 3 Jan 2019 17:58:43 +0800 Subject: [PATCH 019/253] docs: fix typos and styles --- docs/async/general.md | 7 +++---- docs/async/timer.md | 1 - docs/basic/grammar.md | 7 +++---- docs/basic/history.md | 5 ++--- docs/basic/introduction.md | 5 ++--- docs/bom/cookie.md | 1 - docs/bom/engine.md | 14 +++++++------- docs/bom/file.md | 2 +- docs/bom/form.md | 11 +++++------ docs/bom/history.md | 3 +-- docs/bom/indexeddb.md | 10 +++++----- docs/bom/location.md | 3 +-- docs/bom/navigator.md | 1 - docs/bom/same-origin.md | 3 +-- docs/bom/storage.md | 2 +- docs/bom/webworker.md | 1 - docs/bom/window.md | 2 +- docs/bom/xmlhttprequest.md | 6 +++--- docs/dom/attributes.md | 1 - docs/dom/css.md | 3 +-- docs/dom/document.md | 1 - docs/dom/general.md | 1 - docs/dom/node.md | 3 +-- docs/dom/nodelist.md | 3 +-- docs/dom/parentnode.md | 1 - docs/dom/text.md | 5 ++--- docs/elements/button.md | 1 - docs/elements/form.md | 1 - docs/elements/image.md | 1 - docs/elements/option.md | 1 - docs/elements/video.md | 26 +++++++++++++------------- docs/events/common.md | 1 - docs/events/drag.md | 1 - docs/events/event.md | 3 +-- docs/events/eventtarget.md | 1 - docs/events/form.md | 1 - docs/events/globaleventhandlers.md | 1 - docs/events/keyboard.md | 3 +-- docs/events/model.md | 1 - docs/events/mouse.md | 1 - docs/events/progress.md | 1 - docs/events/touch.md | 1 - docs/features/error.md | 4 ++-- docs/features/style.md | 9 ++++----- docs/oop/new.md | 1 - docs/oop/object.md | 2 +- docs/oop/this.md | 1 - docs/operators/bit.md | 3 +-- docs/operators/boolean.md | 1 - docs/operators/comparison.md | 1 - docs/operators/priority.md | 5 ++--- docs/stdlib/array.md | 6 +++--- docs/stdlib/attributes.md | 1 - docs/stdlib/date.md | 6 +++--- docs/stdlib/json.md | 2 +- docs/stdlib/math.md | 1 - docs/stdlib/object.md | 6 +++--- docs/stdlib/regexp.md | 4 ++-- docs/stdlib/string.md | 5 ++--- docs/types/function.md | 10 +++++----- docs/types/general.md | 2 +- docs/types/number.md | 7 +++---- 62 files changed, 89 insertions(+), 135 deletions(-) diff --git a/docs/async/general.md b/docs/async/general.md index 022f8c8..3c1ac35 100644 --- a/docs/async/general.md +++ b/docs/async/general.md @@ -22,7 +22,7 @@ JavaScript 之所以采用单线程，而不是多线程，跟历史有关系。 同步任务是那些没有被引擎挂起、在主线程上排队执行的任务。只有前一个任务执行完毕，才能执行后一个任务。 -异步任务是那些被引擎放在一边，不进入主线程、而进入任务队列的任务。只有引擎认为某个异步任务可以执行了（比如 Ajax 操作从服务器得到了结果），该任务（采用回调函数的形式）才会进入主线程执行。排在异步任务后面的代码，不用等待异步任务结束会马上运行，也就是说，异步任务不具有”堵塞“效应。 +异步任务是那些被引擎放在一边，不进入主线程、而进入任务队列的任务。只有引擎认为某个异步任务可以执行了（比如 Ajax 操作从服务器得到了结果），该任务（采用回调函数的形式）才会进入主线程执行。排在异步任务后面的代码，不用等待异步任务结束会马上运行，也就是说，异步任务不具有“堵塞”效应。 举例来说，Ajax 操作可以当作同步任务处理，也可以当作异步任务处理，由开发者决定。如果是同步任务，主线程就等着 Ajax 操作返回结果，再往下执行；如果是异步任务，主线程在发出 Ajax 请求以后，就直接往下执行，等到 Ajax 操作有了结果，主线程再执行对应的回调函数。 @@ -101,11 +101,11 @@ function f1() { 上面代码中，`f1.trigger('done')`表示，执行完成后，立即触发`done`事件，从而开始执行`f2`。 -这种方法的优点是比较容易理解，可以绑定多个事件，每个事件可以指定多个回调函数，而且可以”[去耦合](http://en.wikipedia.org/wiki/Decoupling)“（decoupling），有利于实现模块化。缺点是整个程序都要变成事件驱动型，运行流程会变得很不清晰。阅读代码的时候，很难看出主流程。 +这种方法的优点是比较容易理解，可以绑定多个事件，每个事件可以指定多个回调函数，而且可以“[去耦合](http://en.wikipedia.org/wiki/Decoupling)”（decoupling），有利于实现模块化。缺点是整个程序都要变成事件驱动型，运行流程会变得很不清晰。阅读代码的时候，很难看出主流程。 ### 发布/订阅 -事件完全可以理解成”信号“，如果存在一个”信号中心“，某个任务执行完成，就向信号中心”发布“（publish）一个信号，其他任务可以向信号中心”订阅“（subscribe）这个信号，从而知道什么时候自己可以开始执行。这就叫做”[发布/订阅模式](http://en.wikipedia.org/wiki/Publish-subscribe_pattern)”（publish-subscribe pattern），又称“[观察者模式](http://en.wikipedia.org/wiki/Observer_pattern)”（observer pattern）。 +事件完全可以理解成“信号”，如果存在一个“信号中心”，某个任务执行完成，就向信号中心“发布”（publish）一个信号，其他任务可以向信号中心“订阅”（subscribe）这个信号，从而知道什么时候自己可以开始执行。这就叫做”[发布/订阅模式](http://en.wikipedia.org/wiki/Publish-subscribe_pattern)”（publish-subscribe pattern），又称“[观察者模式](http://en.wikipedia.org/wiki/Observer_pattern)”（observer pattern）。 这个模式有多种[实现](http://msdn.microsoft.com/en-us/magazine/hh201955.aspx)，下面采用的是 Ben Alman 的 [Tiny Pub/Sub](https://gist.github.com/661855)，这是 jQuery 的一个插件。 @@ -278,4 +278,3 @@ launcher(); 上面代码中，最多只能同时运行两个异步任务。变量`running`记录当前正在运行的任务数，只要低于门槛值，就再启动一个新的任务，如果等于`0`，就表示所有任务都执行完了，这时就执行`final`函数。 这段代码需要三秒完成整个脚本，处在串行执行和并行执行之间。通过调节`limit`变量，达到效率和资源的最佳平衡。 - diff --git a/docs/async/timer.md b/docs/async/timer.md index 89b6421..8a56953 100644 --- a/docs/async/timer.md +++ b/docs/async/timer.md @@ -363,4 +363,3 @@ timer = setTimeout(func, 0); 上面代码有两种写法，都是改变一个网页元素的背景色。写法一会造成浏览器“堵塞”，因为 JavaScript 执行速度远高于 DOM，会造成大量 DOM 操作“堆积”，而写法二就不会，这就是`setTimeout(f, 0)`的好处。 另一个使用这种技巧的例子是代码高亮的处理。如果代码块很大，一次性处理，可能会对性能造成很大的压力，那么将其分成一个个小块，一次处理一块，比如写成`setTimeout(highlightNext, 50)`的样子，性能压力就会减轻。 - diff --git a/docs/basic/grammar.md b/docs/basic/grammar.md index 3dd6d07..fdf6f33 100644 --- a/docs/basic/grammar.md +++ b/docs/basic/grammar.md @@ -181,7 +181,7 @@ var 临时变量 = 1; ## 注释 -源码中被 JavaScript 引擎忽略的部分就叫做注释，它的作用是对代码进行解释。Javascript 提供两种注释的写法：一种是单行注释，用`//`起头；另一种是多行注释，放在`/*`和`*/`之间。 +源码中被 JavaScript 引擎忽略的部分就叫做注释，它的作用是对代码进行解释。JavaScript 提供两种注释的写法：一种是单行注释，用`//`起头；另一种是多行注释，放在`/*`和`*/`之间。 ```javascript // 这是单行注释 @@ -333,7 +333,7 @@ else console.log('world'); ```javascript if (m !== 1) { if (n === 2) { - console.log('hello'); + console.log('hello'); } else { console.log('world'); } @@ -345,7 +345,7 @@ if (m !== 1) { ```javascript if (m !== 1) { if (n === 2) { - console.log('hello'); + console.log('hello'); } } else { console.log('world'); @@ -728,4 +728,3 @@ top: ## 参考链接 - Axel Rauschmayer, [A quick overview of JavaScript](http://www.2ality.com/2011/10/javascript-overview.html) - diff --git a/docs/basic/history.md b/docs/basic/history.md index 97dd32b..06a4131 100644 --- a/docs/basic/history.md +++ b/docs/basic/history.md @@ -75,13 +75,13 @@ ECMA-262 标准后来也被另一个国际标准化组织 ISO（International Or 2009年12月，ECMAScript 5.0版 正式发布。Harmony 项目则一分为二，一些较为可行的设想定名为 JavaScript.next 继续开发，后来演变成 ECMAScript 6；一些不是很成熟的设想，则被视为 JavaScript.next.next，在更远的将来再考虑推出。TC39 的总体考虑是，ECMAScript 5 与 ECMAScript 3 基本保持兼容，较大的语法修正和新功能加入，将由 JavaScript.next 完成。当时，JavaScript.next 指的是ECMAScript 6。第六版发布以后，将指 ECMAScript 7。TC39 预计，ECMAScript 5 会在2013年的年中成为 JavaScript 开发的主流标准，并在此后五年中一直保持这个位置。 -2011年6月，ECMAscript 5.1版发布，并且成为 ISO 国际标准（ISO/IEC 16262:2011）。到了2012年底，所有主要浏览器都支持 ECMAScript 5.1版的全部功能。 +2011年6月，ECMAScript 5.1版发布，并且成为 ISO 国际标准（ISO/IEC 16262:2011）。到了2012年底，所有主要浏览器都支持 ECMAScript 5.1版的全部功能。 2013年3月，ECMAScript 6 草案冻结，不再添加新功能。新的功能设想将被放到 ECMAScript 7。 2013年12月，ECMAScript 6 草案发布。然后是12个月的讨论期，听取各方反馈。 -2015年6月，ECMAScript 6 正式发布，并且更名为“ECMAScript 2015”。这是因为 TC39 委员会计划，以后每年发布一个 ECMAScript 的版本，下一个版本在2016年发布，称为”ECMAScript 2016”，2017年发布“ECMAScript 2017”，以此类推。 +2015年6月，ECMAScript 6 正式发布，并且更名为“ECMAScript 2015”。这是因为 TC39 委员会计划，以后每年发布一个 ECMAScript 的版本，下一个版本在2016年发布，称为“ECMAScript 2016”，2017年发布“ECMAScript 2017”，以此类推。 ## 周边大事记 @@ -185,4 +185,3 @@ JavaScript 伴随着互联网的发展一起发展。互联网周边技术的快 - John Dalziel, [The race for speed part 4: The future for JavaScript](http://creativejs.com/2013/06/the-race-for-speed-part-4-the-future-for-javascript/) - Axel Rauschmayer, [Basic JavaScript for the impatient programmer](http://www.2ality.com/2013/06/basic-javascript.html) - resin.io, [Happy 18th Birthday JavaScript! A look at an unlikely past and bright future](http://resin.io/happy-18th-birthday-javascript/) - diff --git a/docs/basic/introduction.md b/docs/basic/introduction.md index 0bdb9a1..f6d5173 100644 --- a/docs/basic/introduction.md +++ b/docs/basic/introduction.md @@ -69,11 +69,11 @@ Mozilla 基金会的手机操作系统 Firefox OS，更是直接将 JavaScript **（6）跨平台的桌面应用程序** -Chromium OS、Windows 8 等操作系统直接支持 JavaScript 编写应用程序。Mozilla 的 Open Web Apps 项目、Google 的 [Chrome App 项目](http://developer.chrome.com/apps/about_apps)、Github 的 [Electron 项目](http://electron.atom.io/)、以及 [TideSDK 项目](http://tidesdk.multipart.net/docs/user-dev/generated/)，都可以用来编写运行于 Windows、Mac OS 和 Android 等多个桌面平台的程序，不依赖浏览器。 +Chromium OS、Windows 8 等操作系统直接支持 JavaScript 编写应用程序。Mozilla 的 Open Web Apps 项目、Google 的 [Chrome App 项目](http://developer.chrome.com/apps/about_apps)、GitHub 的 [Electron 项目](http://electron.atom.io/)、以及 [TideSDK 项目](http://tidesdk.multipart.net/docs/user-dev/generated/)，都可以用来编写运行于 Windows、Mac OS 和 Android 等多个桌面平台的程序，不依赖浏览器。 **（7）小结** -可以预期，JavaScript 最终将能让你只用一种语言，就开发出适应不同平台（包括桌面端、服务器端、手机端）的程序。早在2013年9月的[统计](http://adambard.com/blog/top-github-languages-for-2013-so-far/)之中，JavaScript 就是当年 Github 上使用量排名第一的语言。 +可以预期，JavaScript 最终将能让你只用一种语言，就开发出适应不同平台（包括桌面端、服务器端、手机端）的程序。早在2013年9月的[统计](http://adambard.com/blog/top-github-languages-for-2013-so-far/)之中，JavaScript 就是当年 GitHub 上使用量排名第一的语言。 著名程序员 Jeff Atwood 甚至提出了一条 [“Atwood 定律”](http://www.codinghorror.com/blog/2007/07/the-principle-of-least-power.html)： @@ -162,4 +162,3 @@ function greetMe(yourName) { greetMe('World') // Hello World ``` - diff --git a/docs/bom/cookie.md b/docs/bom/cookie.md index 871bebb..789151b 100644 --- a/docs/bom/cookie.md +++ b/docs/bom/cookie.md @@ -259,4 +259,3 @@ document.cookie = 'fontSize=;expires=Thu, 01-Jan-1970 00:00:01 GMT'; ## 参考链接 - [HTTP cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies), by MDN - diff --git a/docs/bom/engine.md b/docs/bom/engine.md index 9b29f62..b42197c 100644 --- a/docs/bom/engine.md +++ b/docs/bom/engine.md @@ -104,7 +104,7 @@ URL 支持`javascript:`协议，即在 URL 的位置写入代码，使用这个 点击 ``` -浏览器的地址栏也可以执行`javascipt:`协议。将`javascript:console.log('Hello')`放入地址栏，按回车键也会执行这段代码。 +浏览器的地址栏也可以执行`javascript:`协议。将`javascript:console.log('Hello')`放入地址栏，按回车键也会执行这段代码。 如果 JavaScript 代码返回一个字符串，浏览器就会新建一个文档，展示这个字符串的内容，原有文档的内容都会消失。 @@ -139,8 +139,8 @@ URL 支持`javascript:`协议，即在 URL 的位置写入代码，使用这个 1. 浏览器一边下载 HTML 网页，一边开始解析。也就是说，不等到下载完，就开始解析。 2. 解析过程中，浏览器发现` +``` + +注意，请求的脚本网址有一个`callback`参数（`?callback=bar`），用来告诉服务器，客户端的回调函数名称（`bar`）。 + +第二步，服务器收到请求后，拼接一个字符串，将 JSON 数据放在函数名里面，作为字符串返回（`bar({...})`）。 + +第三步，客户端会将服务器返回的字符串，作为代码解析，因为浏览器认为，这是` +``` + +上面代码中，`document.currentScript`就是`