TypedArray.prototype[Symbol.iterator]()

Baseline 已广泛支持

此特性已非常成熟,可在多种设备和浏览器版本上使用。自 ⁨2016 年 9 月⁩以来,它已在各大浏览器中可用。

[Symbol.iterator]() 方法是 TypedArray 实例的方法,它实现了 iterable protocol,并允许类型化数组(typed arrays)被期望使用 iterable 的大多数语法所消费,例如 spread 语法for...of 循环。它返回一个 array iterator 对象,该对象会生成类型化数组中每个索引的值。

此属性的初始值与 TypedArray.prototype.values 属性的初始值是相同的函数对象。

试一试

const uint8 = new Uint8Array([10, 20, 30]);
const iterator = uint8[Symbol.iterator]();

for (const value of iterator) {
  console.log(value);
}

// Expected output: 10
// Expected output: 20
// Expected output: 30

语法

js
typedArray[Symbol.iterator]()

参数

无。

返回值

TypedArray.prototype.values() 返回相同的值:一个新的 iterable iterator 对象,它会生成类型化数组中每个索引的值。

示例

使用 for...of 循环进行迭代

请注意,你很少需要直接调用此方法。[Symbol.iterator]() 方法的存在使类型化数组成为 iterable,而像 for...of 循环这样的迭代语法会自动调用此方法来获取用于循环的迭代器。

js
const arr = new Uint8Array([10, 20, 30, 40, 50]);
for (const n of arr) {
  console.log(n);
}

手动创建迭代器

你仍然可以手动调用返回的迭代器对象的 next() 方法,以实现对迭代过程的最大控制。

js
const arr = new Uint8Array([10, 20, 30, 40, 50]);
const arrIter = arr[Symbol.iterator]();
console.log(arrIter.next().value); // 10
console.log(arrIter.next().value); // 20
console.log(arrIter.next().value); // 30
console.log(arrIter.next().value); // 40
console.log(arrIter.next().value); // 50

规范

规范
ECMAScript® 2026 语言规范
# sec-%typedarray%.prototype-%symbol.iterator%

浏览器兼容性

另见