TypedArray.from() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

TypedArray.from()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.

Die TypedArray.from() statische Methode erstellt ein neues getyptes Array aus einem array-ähnlichen oder iterierbaren Objekt. Diese Methode ist fast identisch mit Array.from().

In diesem Artikel

Probieren Sie es aus

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

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

Syntax

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

Dabei ist TypedArray eines von:

Parameter

arrayLike

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

mapFn Optional

Eine Funktion, die für jedes Element des getypten Arrays aufgerufen wird. Wenn bereitgestellt, wird jeder Wert, der zum Array hinzugefügt werden soll, zuerst durch diese Funktion gefiltert, und der Rückgabewert von mapFn wird stattdessen zum getypten Array hinzugefügt. 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 Ausführen von mapFn verwendet wird.

Rückgabewert

Eine neue TypedArray Instanz.

Beschreibung

Siehe Array.from() für mehr Details.

Es gibt einige subtile Unterschiede zwischen Array.from() und TypedArray.from() (Hinweis: Der this-Wert, der im Folgenden erwähnt 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, während Array.from() standardmäßig ein neues Array erstellt.
Das durch this konstruierte Objekt muss eine TypedArray Instanz sein, während 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 schließlich 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]], während 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 erhält, das kein Iterator ist, respektiert es Löcher. TypedArray.from() sorgt dafür, dass das Ergebnis dicht ist.

Beispiele

Aus einem iterierbaren Objekt (Set)

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

Aus einem String

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

Verwendung mit Pfeilfunktion und Karte

Verwendung einer Pfeilfunktion als Abbildungsfunktion, um die Elemente zu manipulieren

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

Eine Zahlenfolge erzeugen

js
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 zurückgibt.

js
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>

js
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 ]

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
TypedArray
Statische Methoden
1. from()
2. of()
Statische Eigenschaften
1. BYTES_PER_ELEMENT
2. [Symbol.species]
Instanzmethoden
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
Instanzeigenschaften
1. buffer
2. byteLength
3. byteOffset
4. length
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array