一个TypedArray 对象描述了底层二进制数据缓冲区的类数组视图。没有称为TypedArray 的全局属性，也没有直接可用的TypedArray 构造函数。但是，有很多不同的全局属性，其值是指定元素类型的类型化数组构造函数，如下所列。在接下来的页面，你将找到可以与包含任意类型元素的任意类型化数组一起使用的常见属性和方法。

尝试一下

// Create a TypedArray with a size in bytesconst typedArray1 = new Int8Array(8);typedArray1[0] = 32;const typedArray2 = new Int8Array(typedArray1);typedArray2[1] = 42;console.log(typedArray1);// Expected output: Int8Array [32, 0, 0, 0, 0, 0, 0, 0]console.log(typedArray2);// Expected output: Int8Array [32, 42, 0, 0, 0, 0, 0, 0]

描述

TypedArray 构造函数（通常归类为%TypedArray%，表示它的“内在性”，因为它与任何 JavaScript 程序暴露出的全局对象不对应）是所有TypedArray 子类的通用父类。将%TypedArray% 作为一个“抽象类”，其为所有类型化数组的子类提供了实用方法的通用接口。该构造函数没有直接暴露：没有全局的TypedArray 属性。它只能通过Object.getPrototypeOf(Int8Array) 及类似方式访问。

当创建TypedArray 子类（例如Int8Array）的实例时，在内存的中会创建数组缓冲区，或者，如果将ArrayBuffer 对象作为构造参数，则使用该ArrayBuffer。缓冲区地址被保存为实例的内部属性并且所有的%TypedArray%.prototype 方法都将基于数组缓冲区地址设置和获取值。

TypedArray 对象

值编码与标准化

所有的类型化数组都是基于ArrayBuffer 进行操作的，你可以借此观察到每个元素的确切字节表示，因此二进制格式中的数字编码方式具有重要意义。

• 无符号整数数组（Uint8Array、Uint16Array、Uint32Array 和BigUint64Array）直接以二进制形式存储数字。
• 有符号整数数组（Int8Array、Int16Array、Int32Array 和BigInt64Array）使用二进制补码存储数字。
• 浮点数组（Float32Array 和Float64Array）使用IEEE 754浮点格式存储数字。Number 参考文档中有关于确切格式的更多信息。JavaScript 数字默认使用双精度浮点格式，这与Float64Array 相同。Float32Array 将 23（而不是 52）位用于尾数，以及 8（而不是 11）位用于指数。请注意，规范要求所有的NaN 值使用相同的位编码，但确切的位模式取决于实现。
• Uint8ClampedArray 是一种特殊情况。它像Uint8Array 一样以二进制形式存储数字，但是当你存储超出范围的数字时，它会将数字钳制（clamp）到 0 到 255 的范围内，而不是截断最高有效位。

除了Int8Array、Uint8Array 和Uint8ClampedArray 以外的其他类型数组都将每个元素存储为多个字节。这些字节可以按照从最高有效位到最低有效位（大端序）或从最低有效位到最高有效位（小端序）的顺序进行排序。请参阅字节序以了解更多。类型化数组始终使用平台的本机字节顺序。如果要在缓冲区中写入和读取时指定字节顺序，应该使用DataView。

当向这些类型化数组写入时，超出可表示范围的值将被标准化。

• 所有整数数组（Uint8ClampedArray 除外）都使用固定宽度数值转换，首先截断数字的小数部分，然后取最低位。
• Uint8ClampedArray 首先将数字钳制到 0 到 255 的范围内（大于 255 的值变为 255，小于 0 的值变为 0），然后使用银行家舍入法将结果四舍五入（而非向下取整）到最近的整数，也就是说，如果数字恰好在两个整数之间，它将四舍五入到最近的偶数。例如，0.5 变为0，1.5 变为2，2.5 变为2。
• Float32Array 使用“银行家舍入法”将 64 位浮点数转换为 32 位。这与Math.fround() 提供的算法相同。

底层为可变大小缓冲时的行为

当一个TypedArray 被创建为一个可变大小缓冲的视图时，改变底层缓冲的大小会对TypedArray 的大小产生不同的影响，这取决于TypedArray 是否是长度跟踪的。

如果一个类型化数组是通过省略或传递undefined 给第三个参数来创建的，那么它将跟踪长度，并且将自动调整大小以适应底层buffer 的大小：

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });const float32 = new Float32Array(buffer);console.log(float32.byteLength); // 8console.log(float32.length); // 2buffer.resize(12);console.log(float32.byteLength); // 12console.log(float32.length); // 3

如果一个类型化数组是通过使用第三个length 参数指定大小创建时，则它的大小不会随着buffer 大小的增长而改变：

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });const float32 = new Float32Array(buffer, 0, 2);console.log(float32.byteLength); // 8console.log(float32.length); // 2console.log(float32[0]); // 0, 初始值buffer.resize(12);console.log(float32.byteLength); // 8console.log(float32.length); // 2console.log(float32[0]); // 0, 初始值

当buffer 缩小时，其上的类型化数组可能会超出范围，在这种情况下，类型化数组的观测大小将减少为 0。这是非长度跟踪类型化数组唯一可能改变长度的情况。

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });const float32 = new Float32Array(buffer, 0, 2);buffer.resize(7);console.log(float32.byteLength); // 0console.log(float32.length); // 0console.log(float32[0]); // undefined

如果你随后再次增长buffer 以使类型化数组回到范围内，类型化数组的大小将恢复到其原始值。

buffer.resize(8);console.log(float32.byteLength); // 8console.log(float32.length); // 2console.log(float32[0]); // 0 - 又回到范围内了！

对于长度跟踪的类型化数组，如果buffer 被缩小到小于byteOffset，也会发生同样的事情。

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });const float32 = new Float32Array(buffer, 4);// float32 是长度跟踪的，但它只从第 4 个字节开始，直到缓冲的结尾，// 所以如果缓冲被缩小到小于 4 个字节，类型化数组就将超出范围buffer.resize(3);console.log(float32.byteLength); // 0

构造函数

该对象不能被直接实例化——试图去使用new 构造它将会抛出TypeError。

new (Object.getPrototypeOf(Int8Array))();// TypeError: Abstract class TypedArray not directly constructable

但是，你可以使用一个指定的类型化数组创建实例，例如Int8Array 或BigInt64Array。这些对象的构造函数是通用的：

new TypedArray()new TypedArray(length)new TypedArray(typedArray)new TypedArray(object)new TypedArray(buffer)new TypedArray(buffer, byteOffset)new TypedArray(buffer, byteOffset, length)

其中，TypedArray 是一个具体的构造函数。

参数

typedArray

当使用TypedArray 子类的实例调用时，typedArray 会被拷贝到一个新的类型数组中。对于非bigintTypeedArray 构造函数，typedArray 参数仅可以是非bigint 类型（例如Int32Array）。同样，对于bigintTypedArray 构造函数（BigInt64Array 或BigUint64Array），typedArray 参数仅可以是bigint 类型。typedArray 中的每个值在拷贝到新数组之前都转换为构造函数的相应类型。新的类型化数组的长度与typedArray 参数的长度相同。

object

当使用的不是TypedArray 实例的对象调用时，将以与TypedArray.from() 方法相同的方式创建一个新的类型化数组。

length可选

当使用非对象调用时，该参数将被视为指定类型化数组长度的数字。在内存中创建一个内部数组缓冲区，大小长度乘以BYTES_PER_ELEMENT 字节，用 0 填充。省略所有参数，等同于使用0 作为参数。

buffer、byteOffset可选、length可选

当使用ArrayBuffer 或SharedArrayBuffer 实例以及可选的byteOffset 和length 参数调用时，将创建一个新的指定缓冲区的类型化数组视图。byteOffset 和length 参数指定类型化数组视图将暴露的内存范围。如果忽略这两个参数，则是整个视图的所有buffer；如果仅忽略length，则是从byteOffset 开始的buffer 剩余部分的视图。

异常

所有TypeArray 子类构造函数都以相同的方式运行。它们都会抛出以下异常：

TypeError

抛出以下情况之一：

• 传递typedArray，但它是bigint 类型，而当前构造函数不是，反之亦然。
• 传递typedArray，但它的缓冲区被分离了，或者直接传递分离了视图的buffer。

RangeError

抛出以下情况之一：

• 新的类型化数组的长度太大。
• buffer 的长度（如果length 参数没有指定）或byteOffset 不是新的类型化数组元素大小的整数倍。
• byteOffset 不是有效的数组索引（0 和 2⁵³ - 1 之间的整数）。
• 当从一个缓冲区创建视图，边界在缓冲区之外。换句话说，byteOffset + length * TypedArray.BYTES_PER_ELEMENT > buffer.byteLength。

静态属性

这些属性定义在TypedArray 构造函数中，因此由所有TypedArray 子类型共享。

TypedArray[Symbol.species]

用于创建派生对象的构造函数。

所有TypedArray 子类也有着以下静态属性：

TypedArray.BYTES_PER_ELEMENT

返回不同的TypedArray 对象元素字节数的数值。

静态方法

这些属性定义在TypedArray 构造函数中，因此由所有TypedArray 子类型共享。

TypedArray.from()

从类数组或者可迭代对象创建新的TypedArray。参见Array.from()。

TypedArray.of()

创建一个具有可变参数的TypedArray。参见Array.of()。

实例属性

这些属性都是在TypedArray 属性对象上定义的访问器属性（getter），因此由所有TypedArray 子类型共享。

TypedArray.prototype.buffer

返回类型化数组引用的ArrayBuffer。

TypedArray.prototype.byteLength

返回类型化数组的长度（以字节为单位）。

TypedArray.prototype.byteOffset

返回从类型化数组距离ArrayBuffer 起始位置的偏移量（以字节为单位）。

TypedArray.prototype.length

返回类型化数组中保存的元素个数。

所有TypedArray 子类也有以下实例属性：

TypedArray.prototype.BYTES_PER_ELEMENT

返回不同的TypedArray 对象元素大小的数字值。

实例方法

这些方法定义在TypedArray 原型对象中，因此由所有TypedArray 子类型共享。

TypedArray.prototype.at()

返回给定索引处的数组元素。接受从最后一项往回计算的负整数。

TypedArray.prototype.copyWithin()

在数组内复制数组元素序列。参见Array.prototype.copyWithin()。

TypedArray.prototype.entries()

返回一个新的数组迭代器对象，其中包含数组中每个索引的键/值对。参见Array.prototype.entries()。

TypedArray.prototype.every()

如果调用数组中的每个元素都满足测试函数，则返回true。参见Array.prototype.every()。

TypedArray.prototype.fill()

用静态值填充数组中从开始索引到结束索引的所有元素。参见Array.prototype.fill()。

TypedArray.prototype.filter()

返回一个新数组，其中包含调用所提供的筛选函数返回为true 的所有数组元素。参见Array.prototype.filter()。

TypedArray.prototype.find()

返回数组中满足提供的测试函数的第一个元素的值，如果没有找到合适的元素，则返回undefined。参见Array.prototype.find()。

TypedArray.prototype.findIndex()

返回数组中满足提供的测试函数的第一个元素的索引，如果没有找到合适的元素，则返回-1。参见Array.prototype.findIndex()。

TypedArray.prototype.findLast()

回数组中满足提供的测试函数的最后一个元素的值，如果没有找到合适的元素，则返回undefined。参见Array.prototype.findLast()。

TypedArray.prototype.findLastIndex()

返回数组中满足所提供测试函数的最后一个元素的索引，如果没有找到合适的元素，则返回-1。参见Array.prototype.findLastIndex()。

TypedArray.prototype.forEach()

对调用数组中的每个元素调用函数。参见Array.prototype.forEach()。

TypedArray.prototype.includes()

根据类型化数组是否包含一个确定的元素，来决定返回true 还是false 参见Array.prototype.includes()。

TypedArray.prototype.indexOf()

返回在调用数组中可以找到给定元素的第一个（最小）索引，如果没有找到，则返回-1。参见Array.prototype.indexOf()。

TypedArray.prototype.join()

将数组的所有元素连接为字符串。参见Array.prototype.join()。

TypedArray.prototype.keys()

返回一个新的数组迭代器对象，该对象包含数组中每个索引的键。参见Array.prototype.keys()。

TypedArray.prototype.lastIndexOf()

返回在调用数组中可以找到给定元素的最后一个（最大）索引，如果找不到，则返回-1。参见Array.prototype.lastIndexOf()。

TypedArray.prototype.map()

返回一个新数组，其中包含对调用数组中的每个元素调用函数的结果。参见Array.prototype.map()。

TypedArray.prototype.reduce()

对数组的每个元素（从左到右）执行用户提供的“reducer”回调函数，将其简化为单个值。参见Array.prototype.reduce()。

TypedArray.prototype.reduceRight()

对数组的每个元素（从右到左）执行用户提供的“reducer”回调函数，将其简化为单个值。参见Array.prototype.reduceRight()。

TypedArray.prototype.reverse()

反转数组元素的顺序——第一个成为最后一个，最后一个成为第一个。参见Array.prototype.reverse()。

TypedArray.prototype.set()

在类型化数组中存储多个值，从指定数组读取输入值。

TypedArray.prototype.slice()

提取调用数组的一部分并返回一个新数组。参见Array.prototype.slice()。

TypedArray.prototype.some()

如果调用数组中至少有一个元素满足提供的测试函数，则返回true。参见Array.prototype.some()。

TypedArray.prototype.sort()

对数组的元素进行排序并返回该数组。参见Array.prototype.sort()。

TypedArray.prototype.subarray()

从给定的开始和结束的元素索引返回一个新的TypedArray。

TypedArray.prototype.values()

返回一个新的数组迭代器对象，该对象包含数组中每个索引的值。参见Array.prototype.values()。

TypedArray.prototype.toLocaleString()

返回一个表示调用数组及其元素的本地化字符串。参见Array.prototype.toLocaleString()。

TypedArray.prototype.toString()

返回一个表示调用数组及其元素的字符串。参见Array.prototype.toString()。

TypedArray.prototype[Symbol.iterator]()

返回一个新的数组迭代器对象，该对象包含数组中每个索引的值。

示例

访问属性

你可以使用标准数组索引语法（即使用括号符号）引用数组中的元素。但是，在类型数组上获取或设置索引属性不会在原型链中搜索此属性，即使索引已越界。索引属性将查询ArrayBuffer 并且永远不会查看对象属性。你仍然可以使用命名属性，就像所有对象一样。

// Setting and getting using standard array syntaxconst int16 = new Int16Array(2);int16[0] = 42;console.log(int16[0]); // 42// Indexed properties on prototypes are not consulted (Fx 25)Int8Array.prototype[20] = "foo";new Int8Array(32)[20]; // 0// even when out of boundInt8Array.prototype[20] = "foo";new Int8Array(8)[20]; // undefined// or with negative integersInt8Array.prototype[-1] = "foo";new Int8Array(8)[-1]; // undefined// Named properties are allowed, though (Fx 30)Int8Array.prototype.foo = "bar";new Int8Array(32).foo; // "bar"

不能被冻结

不是空的TypedArray 不能被冻结，因为它们的底层ArrayBuffer 可以通过缓冲区的另一个TypedArray 视图进行变化。这意味着对象将从不会真正地冻结。

const i8 = Int8Array.of(1, 2, 3);Object.freeze(i8);// TypeError: Cannot freeze array buffer views with elements

byteOffset 必须对齐

当将TypedArray 构建为ArrayBuffer 的视图时，byteOffset 参数必须与其元素大小对齐；换句话说，偏移量必须是BYTES_PER_ELEMENT 的倍数。

const i32 = new Int32Array(new ArrayBuffer(4), 1);// RangeError: start offset of Int32Array should be a multiple of 4

const i32 = new Int32Array(new ArrayBuffer(4), 0);

byteLength 必须对齐

类似于byteOffset 参数，ArrayBuffer 传递给TypedArray 构造函数的byteLength 属性必须是构造函数BYTES_PER_ELEMENT 的倍数。

const i32 = new Int32Array(new ArrayBuffer(3));// RangeError: byte length of Int32Array should be a multiple of 4

const i32 = new Int32Array(new ArrayBuffer(4));

规范

浏览器兼容性

参见

• core-js 中类型化数组的 polyfill
• JavaScript 类型化数组
• ArrayBuffer
• DataView
• TextDecoder——从数字数据中解码字符串的助手