TypedArray.from()

Probieren Sie es aus

const uint16 = Int16Array.from("12345");

console.log(uint16);
// Expected output: Int16Array [1, 2, 3, 4, 5]

Syntax

TypedArray.from(arrayLike, mapFn)
TypedArray.from(arrayLike, mapFn, thisArg)

Dabei ist TypedArray eines von:

• Int8Array
• Uint8Array
• Uint8ClampedArray
• Int16Array
• Uint16Array
• Int32Array
• Uint32Array
• Float16Array
• Float32Array
• Float64Array
• BigInt64Array
• BigUint64Array

Parameter

arrayLike

Ein iterierbares oder array-hnliches Objekt, das in ein getyptes Array umgewandelt werden soll.

mapFn Optional

Eine Funktion, die fr jedes Element des getypten Arrays aufgerufen wird. Wenn bereitgestellt, wird jeder Wert, der zum Array hinzugefgt werden soll, zuerst durch diese Funktion gefiltert, und der Rckgabewert von mapFn wird stattdessen zum getypten Array hinzugefgt. Die Funktion wird mit den folgenden Argumenten aufgerufen:

element

Das aktuelle Element, das im getypten Array verarbeitet wird.

index

Der Index des aktuellen Elements, das im getypten Array verarbeitet wird.

thisArg Optional

Wert, der als this beim Ausfhren von mapFn verwendet wird.

Rckgabewert

Eine neue TypedArray Instanz.

Beschreibung

Siehe Array.from() fr mehr Details.

Es gibt einige subtile Unterschiede zwischen Array.from() und TypedArray.from() (Hinweis: Der this-Wert, der im Folgenden erwhnt wird, ist der this-Wert, mit dem TypedArray.from() aufgerufen wurde, nicht das thisArg-Argument, das verwendet wird, um mapFn zu rufen):

• Wenn der this-Wert von TypedArray.from() kein Konstruktor ist, wirft TypedArray.from() einen TypeError, whrend Array.from() standardmig ein neues Array erstellt.
• Das durch this konstruierte Objekt muss eine TypedArray Instanz sein, whrend Array.from() erlaubt, dass sein this-Wert zu einem beliebigen Objekt konstruiert wird.
• Wenn der source-Parameter ein Iterator ist, sammelt TypedArray.from() zuerst alle Werte aus dem Iterator, erstellt dann eine Instanz von this unter Verwendung der Anzahl, und setzt schlielich die Werte auf der Instanz. Array.from() setzt jeden Wert, sobald er vom Iterator empfangen wird, und setzt dann seine length am Ende.
• TypedArray.from() verwendet [[Set]], whrend Array.from() [[DefineOwnProperty]] verwendet. Daher ruft es beim Arbeiten mit Proxy-Objekten handler.set() auf, um neue Elemente zu erstellen, anstatt handler.defineProperty().
• Wenn Array.from() ein array-hnliches Objekt erhlt, das kein Iterator ist, respektiert es Lcher. TypedArray.from() sorgt dafr, dass das Ergebnis dicht ist.

Beispiele

Aus einem iterierbaren Objekt (Set)

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

Aus einem String

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

Verwendung mit Pfeilfunktion und Karte

Verwendung einer Pfeilfunktion als Abbildungsfunktion, um die Elemente zu manipulieren

Float32Array.from([1, 2, 3], (x) => x + x);
// Float32Array [ 2, 4, 6 ]

Eine Zahlenfolge erzeugen

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

Aufrufen von from() auf Nicht-TypedArray-Konstruktoren

Der this-Wert von from() muss ein Konstruktor sein, der eine TypedArray Instanz zurckgibt.

function NotArray(len) {
  console.log("NotArray called with length", len);
}

Int8Array.from.call({}, []); // TypeError: #<Object> is not a constructor
Int8Array.from.call(NotArray, []);
// NotArray called with length 0
// TypeError: Method %TypedArray%.from called on incompatible receiver #<NotArray>

function NotArray2(len) {
  console.log("NotArray2 called with length", len);
  return new Uint8Array(len);
}
console.log(Int8Array.from.call(NotArray2, [1, 2, 3]));
// NotArray2 called with length 3
// Uint8Array(3) [ 1, 2, 3 ]

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von TypedArray.from in core-js
• JavaScript getypte Arrays Leitfaden
• TypedArray
• TypedArray.of()
• TypedArray.prototype.map()
• Array.from()