mdn · yin1999 · May 29, 2022 · May 28, 2022 · May 29, 2022 · May 29, 2022
@@ -19,7 +19,7 @@ <h3 id="参数">参数</h3>
  <dt><code>errors</code></dt>
  <dd>错误的描述，默认为空。</dd>
  <dt><code>message</code>{{Optional_Inline}}</dt>
- <dd>AggregateError错误的提示信息。</dd>
+ <dd>AggregateError 错误的提示信息。</dd>
 </dl>
 
 <h2 id="描述">描述</h2>
@@ -48,7 +48,7 @@ <h3 id="实例属性">实例属性</h3>
 
 <h2 id="示例">示例</h2>
 
-<h3 id="捕获一个AggregateError">捕获一个AggregateError</h3>
+<h3 id="捕获一个AggregateError">捕获一个 AggregateError</h3>
 
 <pre class="brush: js;">Promise.any([
   Promise.reject(new Error("some error")),
@@ -60,7 +60,7 @@ <h3 id="捕获一个AggregateError">捕获一个AggregateError</h3>
 });
 </pre>
 
-<h3 id="创建一个AggregateError">创建一个AggregateError</h3>
+<h3 id="创建一个AggregateError">创建一个 AggregateError</h3>
 
 <pre class="brush: js;">try {
   throw new AggregateError([

@@ -27,11 +27,11 @@ <h2 id="描述">描述</h2>
 
 <h2 id="示例">示例</h2>
 
-<p><code>species</code> 属性返回默认构造函数, 它用于 <code>Array</code> 对象的构造函数 <code>Array</code>:</p>
+<p><code>species</code> 属性返回默认构造函数，它用于 <code>Array</code> 对象的构造函数 <code>Array</code>:</p>
 
 <pre class="brush: js">Array[Symbol.species]; // function Array()</pre>
 
-<p>在继承类的对象中（例如你自定义的数组 <code>MyArray</code>），<code>MyArray</code> 的 <code>species</code> 属性返回的是 <code>MyArray</code> 这个构造函数. 然而你可能想要覆盖它，以便在你继承的对象 <code>MyArray</code> 中返回父类的构造函数 <code>Array</code> :</p>
+<p>在继承类的对象中（例如你自定义的数组 <code>MyArray</code>），<code>MyArray</code> 的 <code>species</code> 属性返回的是 <code>MyArray</code> 这个构造函数。然而你可能想要覆盖它，以便在你继承的对象 <code>MyArray</code> 中返回父类的构造函数 <code>Array</code> :</p>
 
 <pre class="brush: js">class MyArray extends Array {
   // 重写 MyArray 的 species 属性到父类 Array 的构造函数

@@ -29,7 +29,7 @@ <h3 id="Parameters">参数</h3>
  <dt><code>target</code></dt>
  <dd>0 为基底的索引，复制序列到该位置。如果是负数，<code>target</code> 将从末尾开始计算。如果 <code>target</code> 大于等于 <code>arr.length</code>，将不会发生拷贝。如果 <code>target</code> 在 <code>start</code> 之后，复制的序列将被修改以符合 <code>arr.length</code>。</dd>
  <dt><code>start</code></dt>
- <dd>0 为基底的索引，开始复制元素的起始位置。如果是负数，<code>start</code> 将从末尾开始计算。如果 <code>start</code> 被忽略，<code>copyWithin</code> 将会从0开始复制。</dd>
+ <dd>0 为基底的索引，开始复制元素的起始位置。如果是负数，<code>start</code> 将从末尾开始计算。如果 <code>start</code> 被忽略，<code>copyWithin</code> 将会从 0 开始复制。</dd>
  <dt><code>end</code></dt>
  <dd>0 为基底的索引，开始复制元素的结束位置。<code>copyWithin</code> 将会拷贝到该位置，但不包括 <code>end</code> 这个位置的元素。如果是负数， <code>end</code> 将从末尾开始计算。如果 <code>end</code> 被忽略，<code>copyWithin</code> 方法将会一直复制至数组结尾（默认为 <code>arr.length</code>）。</dd>
 </dl>

@@ -17,7 +17,7 @@ <h2 id="语法">语法</h2>
 
 <h3 id="返回值">返回值</h3>
 
-<p>一个新的 {{jsxref("Array")}} 迭代器对象。<a href="http://www.ecma-international.org/ecma-262/6.0/#sec-createarrayiterator">Array Iterator</a>是对象，它的原型（__proto__:Array Iterator）上有一个<a href="http://www.ecma-international.org/ecma-262/6.0/#sec-%arrayiteratorprototype%.next">next</a>方法，可用用于遍历迭代器取得原数组的[key,value]。</p>
+<p>一个新的 {{jsxref("Array")}} 迭代器对象。<a href="http://www.ecma-international.org/ecma-262/6.0/#sec-createarrayiterator">Array Iterator</a>是对象，它的原型（__proto__:Array Iterator）上有一个<a href="http://www.ecma-international.org/ecma-262/6.0/#sec-%arrayiteratorprototype%.next">next</a>方法，可用用于遍历迭代器取得原数组的 [key,value]。</p>
 
 <h2 id="示例">示例</h2>
 
@@ -45,30 +45,30 @@ <h3 id="2、iterator.next()">2、iterator.next()</h3>
           value:(2) [0, "a"]
            __proto__: Object
 */
-// iterator.next()返回一个对象，对于有元素的数组，
-// 是next{ value: Array(2), done: false }；
-// next.done 用于指示迭代器是否完成：在每次迭代时进行更新而且都是false，
-// 直到迭代器结束done才是true。
-// next.value是一个["key","value"]的数组，是返回的迭代器中的元素值。
+// iterator.next() 返回一个对象，对于有元素的数组，
+// 是 next{ value: Array(2), done: false }；
+// next.done 用于指示迭代器是否完成：在每次迭代时进行更新而且都是 false，
+// 直到迭代器结束 done 才是 true。
+// next.value 是一个 ["key","value"] 的数组，是返回的迭代器中的元素值。
 </pre>
 
-<h3 id="3、iterator.next方法运行">3、iterator.next方法运行</h3>
+<h3 id="3、iterator.next方法运行">3、iterator.next 方法运行</h3>
 
 <pre class="brush: js">var arr = ["a", "b", "c"];
 var iter = arr.entries();
 var a = [];
 
 // for(var i=0; i&lt; arr.length; i++){   // 实际使用的是这个
-for(var i=0; i&lt; arr.length+1; i++){    // 注意，是length+1，比数组的长度大
-    var tem = iter.next();             // 每次迭代时更新next
-    console.log(tem.done);             // 这里可以看到更新后的done都是false
-    if(tem.done !== true){             // 遍历迭代器结束done才是true
+for(var i=0; i&lt; arr.length+1; i++){    // 注意，是 length+1，比数组的长度大
+    var tem = iter.next();             // 每次迭代时更新 next
+    console.log(tem.done);             // 这里可以看到更新后的 done 都是 false
+    if(tem.done !== true){             // 遍历迭代器结束 done 才是 true
         console.log(tem.value);
         a[i]=tem.value;
     }
 }
 
-console.log(a);                         // 遍历完毕，输出next.value的数组</pre>
+console.log(a);                         // 遍历完毕，输出 next.value 的数组</pre>
 
 <h3 id="4、二维数组按行排序">4、二维数组按行排序</h3>
 

@@ -25,7 +25,7 @@ <h3 id="Parameters">参数</h3>
  <dt><code>value</code></dt>
  <dd>用来填充数组元素的值。</dd>
  <dt><code>start</code> {{optional_inline}}</dt>
- <dd>起始索引，默认值为0。</dd>
+ <dd>起始索引，默认值为 0。</dd>
  <dt><code>end</code> {{optional_inline}}</dt>
  <dd>终止索引，默认值为 <code>this.length</code>。</dd>
 </dl>
@@ -36,15 +36,15 @@ <h3 id="返回值">返回值</h3>
 
 <h2 id="Description">描述</h2>
 
-<p><strong><code>fill</code></strong> 方法接受三个参数 <code>value</code>, <code>start</code> 以及 <code>end</code>. <code>start</code> 和 <code>end</code> 参数是可选的, 其默认值分别为 <code>0</code> 和 <code>this</code> 对象的 <code>length </code>属性值。</p>
+<p><strong><code>fill</code></strong> 方法接受三个参数 <code>value</code>, <code>start</code> 以及 <code>end</code>. <code>start</code> 和 <code>end</code> 参数是可选的，其默认值分别为 <code>0</code> 和 <code>this</code> 对象的 <code>length </code>属性值。</p>
 
-<p>如果 <code>start</code> 是个负数, 则开始索引会被自动计算成为 <code>length+start</code>, 其中 <code>length</code> 是 <code>this</code> 对象的 <code>length </code>属性值。如果 <code>end</code> 是个负数, 则结束索引会被自动计算成为 <code>length+end</code>。</p>
+<p>如果 <code>start</code> 是个负数，则开始索引会被自动计算成为 <code>length+start</code>, 其中 <code>length</code> 是 <code>this</code> 对象的 <code>length </code>属性值。如果 <code>end</code> 是个负数，则结束索引会被自动计算成为 <code>length+end</code>。</p>
 
-<p><code><strong>fill</strong></code> 方法故意被设计成通用方法, 该方法不要求 <code>this</code> 是数组对象。</p>
+<p><code><strong>fill</strong></code> 方法故意被设计成通用方法，该方法不要求 <code>this</code> 是数组对象。</p>
 
-<p><code><strong>fill</strong></code> 方法是个可变方法, 它会改变调用它的 <code>this</code> 对象本身, 然后返回它, 而并不是返回一个副本。</p>
+<p><code><strong>fill</strong></code> 方法是个可变方法，它会改变调用它的 <code>this</code> 对象本身，然后返回它，而并不是返回一个副本。</p>
 
-<p>当一个对象被传递给 <strong><code>fill</code></strong>方法的时候, 填充数组的是这个对象的引用。</p>
+<p>当一个对象被传递给 <strong><code>fill</code></strong>方法的时候，填充数组的是这个对象的引用。</p>
 
 <h2 id="示例">示例</h2>
 
@@ -61,8 +61,8 @@ <h2 id="示例">示例</h2>
 
 // Objects by reference.
 var arr = Array(3).fill({}) // [{}, {}, {}];
-// 需要注意如果fill的参数为引用类型，会导致都执行同一个引用类型
-// 如 arr[0] === arr[1] 为true
+// 需要注意如果 fill 的参数为引用类型，会导致都执行同一个引用类型
+// 如 arr[0] === arr[1] 为 true
 arr[0].hi = "hi"; // [{ hi: "hi" }, { hi: "hi" }, { hi: "hi" }]</pre>
 
 <h2 id="Polyfill">Polyfill</h2>

@@ -12,7 +12,7 @@
 ---
 <div>{{JSRef}}</div>
 
-<p><code><strong>filter()</strong></code> 方法创建一个新数组, 其包含通过所提供函数实现的测试的所有元素。 </p>
+<p><code><strong>filter()</strong></code> 方法创建一个新数组，其包含通过所提供函数实现的测试的所有元素。 </p>
 
 <p>{{EmbedInteractiveExample("pages/js/array-filter.html")}}</p>
 

@@ -131,7 +131,7 @@ <h3 id="寻找数组中的质数">寻找数组中的质数</h3>
 
 <h2 id="Polyfill">Polyfill</h2>
 
-<p>本方法在ECMAScript 6规范中被加入，可能不存在于某些实现中。你可以通过以下代码来补充 <code>Array.prototype.find()</code>。</p>
+<p>本方法在 ECMAScript 6 规范中被加入，可能不存在于某些实现中。你可以通过以下代码来补充 <code>Array.prototype.find()</code>。</p>
 
 <pre class="brush: js">// https://tc39.github.io/ecma262/#sec-array.prototype.find
 if (!Array.prototype.find) {

@@ -26,7 +26,7 @@ <h3 id="Parameters">参数</h3>
 
 <dl>
  <dt><code>callback</code></dt>
- <dd>针对数组中的每个元素, 都会执行该回调函数, 执行时会自动传入下面三个参数:
+ <dd>针对数组中的每个元素，都会执行该回调函数，执行时会自动传入下面三个参数：
  <dl>
   <dt><code>element</code></dt>
   <dd>当前元素。</dd>
@@ -37,7 +37,7 @@ <h3 id="Parameters">参数</h3>
  </dl>
  </dd>
  <dt><code>thisArg</code></dt>
- <dd>可选。执行<code>callback</code>时作为<code>this</code>对象的值.</dd>
+ <dd>可选。执行<code>callback</code>时作为<code>this</code>对象的值。</dd>
 </dl>
 
 <h3 id="返回值">返回值</h3>
@@ -46,7 +46,7 @@ <h3 id="返回值">返回值</h3>
 
 <h2 id="Description">描述</h2>
 
-<p><code>findIndex</code>方法对数组中的每个数组索引<code>0..length-1</code>（包括）执行一次<code>callback</code>函数，直到找到一个<code>callback</code>函数返回真实值（强制为<code>true</code>）的值。如果找到这样的元素，<code>findIndex</code>会立即返回该元素的索引。如果回调从不返回真值，或者数组的<code>length</code>为0，则<code>findIndex</code>返回-1。 与某些其他数组方法（如Array#some）不同，在稀疏数组中，即使对于数组中不存在的条目的索引也会调用回调函数。</p>
+<p><code>findIndex</code>方法对数组中的每个数组索引<code>0..length-1</code>（包括）执行一次<code>callback</code>函数，直到找到一个<code>callback</code>函数返回真实值（强制为<code>true</code>）的值。如果找到这样的元素，<code>findIndex</code>会立即返回该元素的索引。如果回调从不返回真值，或者数组的<code>length</code>为 0，则<code>findIndex</code>返回-1。 与某些其他数组方法（如 Array#some）不同，在稀疏数组中，即使对于数组中不存在的条目的索引也会调用回调函数。</p>
 
 <p>回调函数调用时有三个参数：元素的值，元素的索引，以及被遍历的数组。</p>
 
@@ -123,9 +123,9 @@ <h2 id="Polyfill">Polyfill</h2>
 }
 </pre>
 
-<p>如果您需要兼容不支持<code><a href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">Object.defineProperty</a></code>的JavaScript引擎，那么最好不要对<code>Array.prototype</code>方法进行 polyfill ，因为您无法使其成为不可枚举的。</p>
+<p>如果您需要兼容不支持<code><a href="/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty">Object.defineProperty</a></code>的 JavaScript 引擎，那么最好不要对<code>Array.prototype</code>方法进行 polyfill ，因为您无法使其成为不可枚举的。</p>
 
-<p>使用此方法需要注意你是否在uc浏览器环境,如果你的页面在支付宝上使用尤其注意,因为支付宝使用的就是uc浏览器环境.</p>
+<p>使用此方法需要注意你是否在 uc 浏览器环境，如果你的页面在支付宝上使用尤其注意，因为支付宝使用的就是 uc 浏览器环境。</p>
 
 <h2 id="规范">规范</h2>
 

@@ -55,7 +55,7 @@ <h3 id="扁平化嵌套数组">扁平化嵌套数组</h3>
 
 <h3 id="扁平化与数组空项">扁平化与数组空项</h3>
 
-<p><code>flat()</code> 方法会移除数组中的空项:</p>
+<p><code>flat()</code> 方法会移除数组中的空项：</p>
 
 <pre class="brush: js">var arr4 = [1, 2, , 4, 5];
 arr4.flat();
@@ -118,7 +118,7 @@ <h3 id="forEachisArraypushrecursivity">forEach+isArray+push+recursivity</h3>
       if (Array.isArray(item) &amp;&amp; depth &gt; 0) {
         flat(item, depth - 1)
       } else {
-        // 去除空元素，添加非undefined元素
+        // 去除空元素，添加非 undefined 元素
         item !== void 0 &amp;&amp; result.push(item);
       }
     }
@@ -127,7 +127,7 @@ <h3 id="forEachisArraypushrecursivity">forEach+isArray+push+recursivity</h3>
 }
 </pre>
 
-<h3 id="使用堆栈stack">使用堆栈stack</h3>
+<h3 id="使用堆栈_stack">使用堆栈 stack</h3>
 
 <pre>// 无递归数组扁平化，使用堆栈
 // 注意：深度的控制比较低效，因为需要检查每一个值的深度

@@ -11,7 +11,7 @@
 ---
 <div>{{JSRef}}</div>
 
-<p><code><strong>flatMap()</strong></code> 方法首先使用映射函数映射每个元素，然后将结果压缩成一个新数组。它与 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a> 连着深度值为1的 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat">flat</a> 几乎相同，但 <code>flatMap</code> 通常在合并成一种方法的效率稍微高一些。</p>
+<p><code><strong>flatMap()</strong></code> 方法首先使用映射函数映射每个元素，然后将结果压缩成一个新数组。它与 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a> 连着深度值为 1 的 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat">flat</a> 几乎相同，但 <code>flatMap</code> 通常在合并成一种方法的效率稍微高一些。</p>
 
 <p>\{{EmbedInteractiveExample("pages/js/array-flatmap.html")}}</p>
 
@@ -41,11 +41,11 @@ <h3 id="参数">参数</h3>
 
 <h3 id="返回值">返回值</h3>
 
-<p> 一个新的数组，其中每个元素都是回调函数的结果，并且结构深度 <code>depth</code> 值为1。</p>
+<p> 一个新的数组，其中每个元素都是回调函数的结果，并且结构深度 <code>depth</code> 值为 1。</p>
 
 <h2 id="描述">描述</h2>
 
-<p>有关回调函数的详细描述，请参见 {{jsxref("Array.prototype.map()")}} 。 <code>flatMap</code> 方法与 <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a></code> 方法和深度depth为1的 <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat">flat</a></code> 几乎相同.</p>
+<p>有关回调函数的详细描述，请参见 {{jsxref("Array.prototype.map()")}} 。 <code>flatMap</code> 方法与 <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map">map</a></code> 方法和深度 depth 为 1 的 <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat">flat</a></code> 几乎相同。</p>
 
 <h2 id="示例">示例</h2>
 
@@ -79,7 +79,7 @@ <h3 id="map_与_flatMap"><code>map()</code> 与 <code>flatMap()</code></h3>
 
 <h3 id="在一个_map_期间增加或去除一些项">在一个 <code>map()</code> 期间增加或去除一些项</h3>
 
-<p><code>flatMap</code> 能用于在map期间增删项目（也就是修改items的数量）。换句话说，它允许你遍历很多项使之成为另一些项（靠分别把它们放进去来处理），而不是总是一对一。 从这个意义上讲，它的作用类似于 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter">filter</a>的对立面。只需返回一个1项元素数组以保留该项，返回一个多元素数组以添加项，或返回一个0项元素数组以删除该项。</p>
+<p><code>flatMap</code> 能用于在 map 期间增删项目（也就是修改 items 的数量）。换句话说，它允许你遍历很多项使之成为另一些项（靠分别把它们放进去来处理），而不是总是一对一。 从这个意义上讲，它的作用类似于 <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter">filter</a>的对立面。只需返回一个 1 项元素数组以保留该项，返回一个多元素数组以添加项，或返回一个 0 项元素数组以删除该项。</p>
 
 <pre><code>// Let's say we want to remove all the negative numbers and split the odd numbers into an even number and a 1
 let a = [5, 4, -3, 20, 17, -33, -4, 18]