TypedArray

一个TypedArray 对象描述一个底层的二进制数据缓存区的一个类似数组(array-like)视图。没有名为 TypedArray的全局属性，也没有一个直接可见的 TypedArray构造函数。相反，有许多不同的全局属性，其值是下面列出的特定元素类型的类型化数组构造函数。在下面的页面中，你会找到可用于包含任何类型的元素的任何类型数组的常见属性和方法

语法

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乘以数组中每个元素的字节数,每个元素的值都为0.(译者注:每个元素的字节数是由具体的构造函数决定的,比如Int16Array的每个元素的字节数为2,Int32Array的每个元素的字节数为4)

typedArray

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

object

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

buffer, byteOffset, length

当传入arrayBuffer和可选参数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的时候比较有用.

属性访问

你可以参考使用标准数组索引数组中的元素的方法(其实就是方括号里面写下标).然而,原型链上面定义的索引属性(译者注:即用数字作为属性,例如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]()

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

规范

浏览器支持

[1] -1 and similar are not considered as indexed properties and therefore return the value of the prototype property.

兼容性注意事项

从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