[zh-cn]: update the translation of TypedArray from() static method

files/zh-cn/web/javascript/reference/global_objects/typedarray/from/index.md

@@ -1,11 +1,15 @@
 ---
 title: TypedArray.from()
 slug: Web/JavaScript/Reference/Global_Objects/TypedArray/from
+l10n:
+  sourceCommit: fb442649a7e91a177a582a3e9c6e1a95a9e8dda5
 ---
 
 {{JSRef}}
 
-`TypedArray.from()` 方法 从一个类数组或者可迭代对象中创建一个新[类型数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#typedarray_objects)。这个方法和 {{jsxref("Array.from()")}} 类似。
+**`TypedArray.from()`** 静态方法从[类型化数组](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#typedarray_对象)或可迭代对象创建一个新的类型化数组。此方法与 {{jsxref("Array.from()")}} 几乎相同。
+
+{{EmbedInteractiveExample("pages/js/typedarray-from.html", "shorter")}}
 
 ## 语法
 
@@ -14,7 +18,7 @@ TypedArray.from(arrayLike, mapFn)
 TypedArray.from(arrayLike, mapFn, thisArg)
 ```
 
-上面代码中的 `TypedArray` 需要替换为下面的任何一个构造函数：
+其中 `TypedArray` 是其中之一：
 
 - {{jsxref("Int8Array")}}
 - {{jsxref("Uint8Array")}}
@@ -23,66 +27,99 @@ TypedArray.from(arrayLike, mapFn, thisArg)
 - {{jsxref("Uint16Array")}}
 - {{jsxref("Int32Array")}}
 - {{jsxref("Uint32Array")}}
+- {{jsxref("Float16Array")}}
 - {{jsxref("Float32Array")}}
 - {{jsxref("Float64Array")}}
 - {{jsxref("BigInt64Array")}}
 - {{jsxref("BigUint64Array")}}
 
 ### 参数
 
-- _`source`_
-  - : 想要转换为类型数组的类数组或者可迭代对象。
-- _`mapFn`_
-  - : 可选参数。如果指定了该参数，则最后生成的类型数组会经过该函数的加工处理后再返回。
-- _`thisArg`_
-  - : 可选参数。执行 `mapFn` 函数时 `this` 的值。
+- `arrayLike`
+  - : 一个可迭代对象或类数组对象，用于转换为类型化数组。
+- `mapFn` {{optional_inline}}
+  - : 对类型化数组的每个元素调用的函数。如果提供了该函数，数组中要添加的每个值首先会传递给该函数，然后将 `mapFn` 的返回值添加到类型化数组中。该函数使用以下参数调用：
+    - `element`
+      - : 当前在类型化数组中处理的元素。
+    - `index`
+      - : 当前在类型化数组中处理的元素的索引。
+- `thisArg` {{optional_inline}}
+  - : 执行 `mapFn` 时用作 `this` 的值。
 
 ### 返回值
 
 一个新的 {{jsxref("TypedArray")}} 实例。
 
 ## 描述
 
-`TypedArray.from()` 允许你从下面两者来创建数组：
-
-- 类数组对象（拥有一个 `length` 属性和若干索引属性的任意对象）
-- [可迭代对象](/zh-CN/docs/Web/JavaScript/Reference/Iteration_protocols)（你可以从它身上迭代出若干个元素的对象，比如有 {{jsxref("Map")}} 和 {{jsxref("Set")}} 等）。
-
-`TypedArray.from()` 方法有一个可选参数 `mapFn`, 让你可以在最后生成的类型数组上再执行一次 {{jsxref("Array.prototype.map", "map")}} 方法后再返回。也就是说以下两种形式是等价的：
+详情请参见 {{jsxref("Array.from()")}}。
 
-- `TypedArray.from(obj, mapFn, thisArg)`
-- `TypedArray.from(Array.prototype.map.call(obj, mapFn, thisArg))`
+{{jsxref("Array.from()")}} 和 `TypedArray.from()` 之间存在一些微妙的区别（注意：下面提到的 `this` 值是指调用 `TypedArray.from()` 时的 `this` 值，而不是用于调用 `mapFn` 的 `thisArg` 参数）：
 
-`from()` 的 `length` 属性值为 `1`。
-
-{{jsxref("Array.from()")}} 和 `TypedArray.from()` 之间有一些微妙的区别：
-
-- 如果 `|this|` 的值传递给 `TypedArray.from` 不是一个构造器，`TypedArray.from` 将抛出{jsxref("TypeError")}}, 而 `Array.from` 默认将创建一个 {{jsxref("Array")}}.
-- `TypedArray.from` 使用`[Put]` 而 `rray.from` 使用`[DefineProperty]]`. 因此，当和 {{jsxref("Proxy")}} 对象一起时，它调用 {{jsxref("Global_Objects/Proxy/handler/set", "handler.set")}} 创建一个新的元素而非 {{jsxref("Global_Objects/Proxy/handler/defineProperty", "handler.defineProperty")}}.
-- 当 `from` 获得一个迭代器时，`TypedArray` 一开始收集迭代器中的所有值，此时创建一个 `|this|` 的实例用于计数，然后在实例中设置值。 `Array.from` 设置每个从迭代器其中获取的值，最后设置它的长度。
-- 当 `Array.from` 获得一个不可迭代的类数组时，it respects holes, 而 `TypedArray.from` 将确保结果是 dense.
+- 如果`TypedArray.from()` 的 `this` 值不是构造函数，`TypedArray.from()` 会抛出一个 {{jsxref("TypeError")}}，而 `Array.from()` 默认会创建一个新的 {{jsxref("Array")}}。
+- 由 `this` 构造的对象必须是一个 `TypedArray` 实例，而 `Array.from()` 允许其 `this` 值构造为任何对象。
+- 当 `source` 参数是一个迭代器时，`TypedArray.from()` 首先从迭代器中收集所有值，然后使用计数创建一个 `this` 实例，最后将值设置到该实例上。`Array.from()` 在接收到来自迭代器的每个值时设置其值，然后在最后设置其 `length`。
+- `TypedArray.from()` 使用 `[[Set]]`，而 `Array.from()` 使用 `[[DefineOwnProperty]]`。因此，在处理 {{jsxref("Proxy")}} 对象时，它调用 [`handler.set()`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/set) 来创建新元素，而不是调用 [`handler.defineProperty()`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/defineProperty)。
+- 当 `Array.from()` 接收到一个不是迭代器的类数组时，它会保留空洞。`TypedArray.from()` 将确保结果是密集的。
 
 ## 示例
 
+### 来自可迭代对象（Set）
+
 ```js
-// 使用 Set (可迭代对象)
-var s = new Set([1, 2, 3]);
+const s = new Set([1, 2, 3]);
 Uint8Array.from(s);
 // Uint8Array [ 1, 2, 3 ]
+```
+
+### 来自字符串
 
-// 使用字符串
+```js
 Int16Array.from("123");
 // Int16Array [ 1, 2, 3 ]
+```
+
+### 与箭头函数和 map 一起使用
+
+使用箭头函数作为 map 函数来操作元素
 
-// 使用箭头函数对数组元素进行映射
+```js
 Float32Array.from([1, 2, 3], (x) => x + x);
 // Float32Array [ 2, 4, 6 ]
+```
+
+### 生成一个数字序列
 
-// 生成一个数字序列
+```js
 Uint8Array.from({ length: 5 }, (v, k) => k);
 // Uint8Array [ 0, 1, 2, 3, 4 ]
 ```
 
+### 在非 TypedArray 构造函数上调用 from() 方法
+
+`from()` 方法的 `this` 值必须是一个返回 `TypedArray` 实例的构造函数。
+
+```js
+function NotArray(len) {
+  console.log("调用 NotArray 时的长度", len);
+}
+
+Int8Array.from.call({}, []); // TypeError: #<Object> is not a constructor
+Int8Array.from.call(NotArray, []);
+// 调用 NotArray 时的长度 0
+// TypeError: Method %TypedArray%.from called on incompatible receiver #<NotArray>
+```
+
+```js
+function NotArray2(len) {
+  console.log("调用 NotArray2 时的长度", len);
+  return new Uint8Array(len);
+}
+console.log(Int8Array.from.call(NotArray2, [1, 2, 3]));
+// 调用 NotArray2 时的长度 3
+// Uint8Array(3) [ 1, 2, 3 ]
+```
+
 ## 规范
 
 {{Specifications}}