TypedArray

一个TypedArray 对象描述一个底层的二进制数据缓存区的一个类似数组(array-like)视图。事实上，没有名为 TypedArray的全局对象，也没有一个名为的 TypedArray构造函数。相反，有许多不同的全局对象，下面会列出这些针对特定元素类型的类型化数组的构造函数。在下面的页面中，你会找到一些不管什么类型都公用的属性和方法。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

语法

new TypedArray(); // ES2017中新增
new TypedArray(length); 
new TypedArray(typedArray); 
new TypedArray(object); 
new TypedArray(buffer [, byteOffset [, length]]); 

TypedArray()指的是以下的其中之一： 

Int8Array(); 
Uint8Array(); 
Uint8ClampedArray();
Int16Array(); 
Uint16Array();
Int32Array(); 
Uint32Array(); 
Float32Array(); 
Float64Array();

参数

length

当传入 length参数时，一个内部数组缓冲区会被创建在内存中。该缓存区的大小是传入的 length乘以数组中每个元素的字节数（ BYTES_PER_ELEMENT），每个元素的值都为0。(译者注：每个元素的字节数是由具体的构造函数决定的，比如Int16Array的每个元素的字节数为2，Int32Array的每个元素的字节数为4)

typedArray

当传入一个包含任意类型元素的任意类型化数组对象 typedArray（比如 Int32Array）作为参数时， typedArray被复制到一个新的类型数组。 typedArray中的每个值会在复制到新的数组之前根据构造器进行转化。新的生成的类型化数组对象将会有跟传入的数组相同的长度（译者注：比如原来的typedArray.length==2，那么新生成的数组的length也是2，只是数组中的每一项进行了转化）

object

当传入一个 object作为参数时，如同通过 TypedArray.from() 方法一样创建一个新的类型数组。

buffer, byteOffset, length

当传入一个 buffer参数，或者再另外加上可选参数 byteOffset和 length时，一个新的类型化数组视图将会被创建并可用于呈现传入的 ArrayBuffer实例。 byteOffset和 length指定类型化数组视图暴露的内存范围，如果两者都未传入，那么整个buffer都会被呈现。如果仅仅忽略 length，那么 buffer中偏移 byteOffset后剩下的buffer将会被呈现。

描述

ECMAScript 6定义TypeArray构造器作为所有的类型化数组构造器(Int8Array,Int16Array等)的原型.该构造器不会直接暴露:没有全局的%TypedArray%和TypeArray属性.只能通过使用类似Object.getPrototypeOf(Int8Array.prototype)的方式进行访问.所有的类型化数组构造器(Int8Array,Int16Array等)都会继承TypeArray构造器的通用属性和方法.此外,所有的类型化数组原型(Int8Array.prototype,Int16Array.prototype等)的原型都以TypeArray.prototype作为原型.

TypedArray构造器自身不是特别有用.调用或在一个表达式中使用它都会抛出一个TypeError异常,除非在支持通过继承创建对象的JS引擎下运行.但直到现在还没有这样的JS引擎出现,因此TypeArray仅仅是对所有的类型化类构造器(Int8Array,Int16Array等)的方法和属性进行polyfill的时候比较有用.

当创建一个TypedArray实例（例如:Int8Array）时，一个数组缓冲区将被创建在内存中，如果ArrayBuffer对象被当作参数传给构造函数将使用传入的ArrayBuffer代替。缓冲区的地址被存储在实例的内部属性中，所有的%TypedArray%.prototype上的方法例如set value和get value等都会操作在数组缓冲区上。

属性访问

你可以参考使用标准数组索引数组中的元素的方法(其实就是方括号里面写下标).然而,原型链上面定义的索引属性(译者注:即用数字作为属性,例如Int16Array.prototype[0]=12;),在实例化的对象上面是获取不到该属性的(int16Array[0]==undefined).通过查询 ArrayBuffer 是找不到索引属性的.但您仍然可以使用命名属性(译者注:就是键不是数字的),就像所有对象一样。

// 设置和使用标准数组语法
var 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 bound
Int8Array.prototype[20] = "foo";
(new Int8Array(8))[20]; // undefined
// or with negative integers
Int8Array.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 对象

属性

TypedArray.BYTES_PER_ELEMENT

返回不同类型的数组对象的元素大小的数字值。

TypedArray.length

Length property whose value is 3.(译者注:应该是数组的长度吧???)

TypedArray.name

返回构造器的名称,例如"Int8Array".

get TypedArray[@@species]

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

TypedArray.prototype

TypedArray的原型.

方法

TypedArray.from()

使用类数组(array-like)或迭代对象创建一个新的类型化数组.参见 Array.from().

TypedArray.of()

通过可变数量的参数创建新的类型化数组.参见  Array.of().

TypedArray 原型

所有的类型化数组都是继承自TypedArray.prototype.

属性

TypedArray.prototype.constructor

返回创建实例原型的构造函数.这是相应的 typed array type的默认的构造函数.

TypedArray.prototype.buffer 只读

返回被格式化数组引用的 ArrayBuffer. 创建时已被固化,因此是只读的.

TypedArray.prototype.byteLength 只读

返回从 ArrayBuffer读取的字节长度. 创建时已被固化,因此是只读的.

TypedArray.prototype.byteOffset 只读

返回从 ArrayBuffer读取时的字节偏移量 .创建时已被固化,因此是只读的.

TypedArray.prototype.length 只读

返回在类型化数组中的元素的数量 .创建时已被固化,因此是只读的.

方法

TypedArray.prototype.copyWithin()

浅拷贝数组的部分元素到同一数组的不同位置，且不改变数组的大小，返回该数组. 参见  Array.prototype.copyWithin().

TypedArray.prototype.entries()

返回一个  Array Iterator 对象，该对象包含数组中每一个索引的键值对.参见  Array.prototype.entries().

TypedArray.prototype.every()

测试数组的所有元素是否都通过了指定函数的测试. 参见 Array.prototype.every().

TypedArray.prototype.fill()

将一个数组中指定区间的所有元素的值, 都替换成或者说填充成为某个固定的值. 参见  Array.prototype.fill().

TypedArray.prototype.filter()

使用指定的函数测试所有元素，并创建一个包含所有通过测试的元素的新数组. 参见 Array.prototype.filter().

TypedArray.prototype.find()

返回一个满足提供的函数的测试的元素,若是没有满足的元素则返回 undefined . 参见 Array.prototype.find().

TypedArray.prototype.findIndex()

查找数组中某指定元素的索引, 如果找不到指定的元素, 则返回 -1. 参见 Array.prototype.findIndex().

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.move() 未实现

以前的不标准版本的 TypedArray.prototype.copyWithin().

TypedArray.prototype.reduce()

接收一个函数作为累加器（accumulator),数组中的每个值（从左到右）开始合并，最终为一个值. 参见 Array.prototype.reduce().

TypedArray.prototype.reduceRight()

接受一个函数作为累加器（accumulator）,让每个值（从右到左，亦即从尾到头）缩减为一个值.（与  reduce() 的执行方向相反）. 参见 Array.prototype.reduceRight().

TypedArray.prototype.reverse()

颠倒数组中元素的位置。第一个元素会成为最后一个，最后一个会成为第一个. 参见 Array.prototype.reverse().

TypedArray.prototype.set()

读取一个指定数组中的元素保存到格式化数组中.

TypedArray.prototype.slice()

浅复制（shallow copy）数组的一部分到一个新的数组，并返回这个新数组. 参见 Array.prototype.slice().

TypedArray.prototype.some()

数组中只要有一个元素满足提供的测试函数的测试就返回true,否则返回false. 参见  Array.prototype.some().

TypedArray.prototype.sort()

对数组进行排序,并返回原数组(是改变原数组). 参见 Array.prototype.sort().

TypedArray.prototype.subarray()

返回给定的起始和结束索引之间的元素组成的新的类型化数组.

TypedArray.prototype.values()

返回有数组中的元素组成的新的数组迭代对象. 参见 Array.prototype.values().

TypedArray.prototype.toLocaleString()

返回一个将数组中的每个元素本地化后组成的字符串. 参见 Array.prototype.toLocaleString().

TypedArray.prototype.toString()

返回一个由数组中的每个元素字符串化后组成的字符串. 参见 Array.prototype.toString().

TypedArray.prototype[@@iterator]()

返回一个包含数组中每个元素的新的数组迭代对象.

规范

浏览器支持

兼容性注意事项

从ECMAScript 2015 (ES6)开始,TypedArray 构造函数使用的时候必须要使用new.从现在开始不使用new调用TypedArray构造函数将会抛出异常TypeError

var dv = Int8Array([1, 2, 3]);
// TypeError: 不使用new调用内置的Int8Array构造函数是被禁止的

var dv = new Int8Array([1, 2, 3]);

相关链接

• JavaScript typed arrays
• ArrayBuffer
• DataView