TypedArray.from()

TypedArray.from()方法从一个类数组或者可迭代对象中创建一个新类型数组。这个方法和Array.from()类似。

语法

TypedArray.from(source[, mapFn[, thisArg]])

where TypedArray is one of:

Int8Array
Uint8Array
Uint8ClampedArray
Int16Array
Uint16Array
Int32Array
Uint32Array
Float32Array
Float64Array

参数

source: 想要转换为类型数组的类数组或者可迭代对象。
mapFn: 可选参数。如果指定了该参数，则最后生成的类型数组会经过该函数的加工处理后再返回。
thisArg: 可选参数。执行mapFn函数时this的值。

返回值

一个新的TypedArray实例。

描述

TypedArray.from()允许你从下面两者来创建数组:

类数组对象（拥有一个length属性和若干索引属性的任意对象）
Set等）。

TypedArray.from()方法有一个可选参数mapFn,让你可以在最后生成的类型数组上再执行一次map方法后再返回。也就是说TypedArray.from(obj, mapFn, thisArg)和TypedArray.from(Array.prototype.map.call(obj, mapFn, thisArg))是等价的。

from()的length属性为1.

Array.from()和TypedArray.from()之间有一些微妙的区别:

如果|this|的值传递给TypedArray.from不是一个构造器,TypedArray.from将抛出{jsxref("TypeError")}},而Array.from默认将创建一个Array.
TypedArray.from使用[Put]而rray.from使用[DefineProperty]].因此,当和handler.defineProperty.
当from获得一个迭代器时,TypedArray一开始收集迭代器中的所有值，此时创建一个|this|的实例用于计数,然后在实例中设置值。Array.from设置每个从迭代器其中获取的值，最后设置它的长度。
当Array.from获得一个不可迭代的类数组时, it respects holes,而TypedArray.from将确保结果是 dense.

示例

// Set (iterable object)
var s = new Set([1, 2, 3]);
Uint8Array.from(s);
// Uint8Array [ 1, 2, 3 ]

// String
Int16Array.from('123');                      
// Int16Array [ 1, 2, 3 ]

// Using an arrow function as the map function to
// manipulate the elements
Float32Array.from([1, 2, 3], x => x + x);      
// Float32Array [ 2, 4, 6 ]

// Generate a sequence of numbers
Uint8Array.from({length: 5}, (v, k) => k);    
// Uint8Array [ 0, 1, 2, 3, 4 ]

Polyfill

You can partially work around this by inserting the following code at the beginning of your scripts, allowing use of much of the functionality of from()in implementations that do not natively support it.

if (!Int8Array.__proto__.from) {
    (function () {
        Int8Array.__proto__.from = function (obj, func, thisObj) {

            var typedArrayClass = Int8Array.__proto__;
            if(typeof this !== 'function') {
                throw new TypeError('# is not a constructor');
            }
            if (this.__proto__ !== typedArrayClass) {
                throw new TypeError('this is not a typed array.');
            }
 
            func = func || function (elem) {
                    return elem;
                };

            if (typeof func !== 'function') {
                throw new TypeError('specified argument is not a function');
            }

            obj = Object(obj);
            if (!obj['length']) {
                return new this(0);
            }
            var copy_data = [];
            for(var i = 0; i < obj.length; i++) {
                copy_data.push(obj[i]);
            }

            copy_data = copy_data.map(func, thisObj);

            var typed_array = new this(copy_data.length);
            for(var i = 0; i < typed_array.length; i++) {
                typed_array[i] = copy_data[i];
            }
            return typed_array;
        }
    })();
}