From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001
From: Peter Bengtsson <mail@peterbe.com>
Date: Tue, 8 Dec 2020 14:40:17 -0500
Subject: initial commit

---
 .../errors/invalid_array_length/index.html         | 77 ++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 files/zh-cn/web/javascript/reference/errors/invalid_array_length/index.html

(limited to 'files/zh-cn/web/javascript/reference/errors/invalid_array_length')

diff --git a/files/zh-cn/web/javascript/reference/errors/invalid_array_length/index.html b/files/zh-cn/web/javascript/reference/errors/invalid_array_length/index.html
new file mode 100644
index 0000000000..6e74db20b8
--- /dev/null
+++ b/files/zh-cn/web/javascript/reference/errors/invalid_array_length/index.html
@@ -0,0 +1,77 @@
+---
+title: 'RangeError: invalid array length'
+slug: Web/JavaScript/Reference/Errors/Invalid_array_length
+tags:
+  - JavaScript
+  - 范围错误
+  - 错误
+translation_of: Web/JavaScript/Reference/Errors/Invalid_array_length
+---
+<div>{{jsSidebar("Errors")}}</div>
+
+<h2 id="错误信息">错误信息</h2>
+
+<pre class="syntaxbox">RangeError: invalid array length (Firefox)
+RangeError: Invalid array length (Chrome)
+RangeError: Invalid array buffer length (Chrome)
+</pre>
+
+<h2 id="错误类型">错误类型</h2>
+
+<p>{{jsxref("RangeError")}}</p>
+
+<h2 id="什么地方出错了">什么地方出错了?</h2>
+
+<p>无效的数组错误长度通常会在以下情形中出现：</p>
+
+<ul>
+ <li>当创建一个长度为负数或者长度大于等于2<sup>32 </sup>的<sup> </sup>{{jsxref("Array")}} 或者 {{jsxref("ArrayBuffer")}} 时。</li>
+ <li>当设置 {{jsxref("Array.length")}} 属性为负数或者长度大于等于2<sup>32 </sup>时。</li>
+</ul>
+
+<p>为什么 Array（数组） 和 ArrayBuffer（数组缓冲区） 的长度会受到限制？因为 Array 和 ArrayBuffer 的 length（长度） 属性被定义为一个32位无符号整形（unsigned 32-bit integer）的值，所以它只能存储 0 - 2<sup>32</sup>-1 之间的数。</p>
+
+<p>当你使用构造函数来创建一个数组的时候，你可能想使用字面值的形式，第一个参数会被解释为数组的长度。</p>
+
+<p>或者说，你想要在设置数组之前确定它的长度，或把它作为一个构造函数的参数。</p>
+
+<h2 id="示例">示例</h2>
+
+<h3 id="错误的示例">错误的示例</h3>
+
+<pre class="brush: js example-bad">new Array(Math.pow(2, 40))
+new Array(-1)
+new ArrayBuffer(Math.pow(2, 32))
+new ArrayBuffer(-1)
+
+let a = [];
+a.length = a.length - 1;         // 将 length 属性的值设置为 -1
+
+let b = new Array(Math.pow(2, 32) - 1);
+b.length = b.length + 1;         // 将 length 属性的值设置为 2^32
+</pre>
+
+<h3 id="正确的示例">正确的示例</h3>
+
+<pre class="brush: js example-good">[ Math.pow(2, 40) ]                     // [ 1099511627776 ]
+[ -1 ]                                  // [ -1 ]
+new ArrayBuffer(Math.pow(2, 32) - 1)
+new ArrayBuffer(0)
+
+let a = [];
+a.length = Math.max(0, a.length - 1);
+
+let b = new Array(Math.pow(2, 32) - 1);
+b.length = Math.min(0xffffffff, b.length + 1);
+
+// 0xffffffff 是 2^32 - 1 的 十六进制 表示方式
+// 它也可以被写作 (-1 &gt;&gt;&gt; 0)
+</pre>
+
+<h2 id="相关页面">相关页面</h2>
+
+<ul>
+ <li>{{jsxref("Array")}}</li>
+ <li>{{jsxref("Array.length")}}</li>
+ <li>{{jsxref("ArrayBuffer")}}</li>
+</ul>
-- 
cgit v1.2.3-54-g00ecf