Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

TypedArray.prototype.set()

Baseline
Weitgehend verfügbar

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

Die Methode set() von TypedArray-Instanzen speichert mehrere Werte in einem typisierten Array. Die Eingabewerte werden aus einem angegebenen Array gelesen.

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

// Copy the values into the array starting at index 3
uint8.set([1, 2, 3], 3);

console.log(uint8);
// Expected output: Uint8Array [0, 0, 0, 1, 2, 3, 0, 0]

Syntax

js
set(array)
set(array, targetOffset)

set(typedarray)
set(typedarray, targetOffset)

Parameter

array

Das Array, aus dem Werte kopiert werden. Alle Werte aus dem Quellarray werden in das Zielarray kopiert. Wenn die Länge des Quellarrays zuzüglich des Ziel-Offsets die Länge des Zielarrays überschreitet, wird eine Ausnahme ausgelöst.

typedarray

Wenn das Quellarray ein typisiertes Array ist, können die beiden Arrays denselben zugrunde liegenden ArrayBuffer verwenden. Die JavaScript-Engine kopiert den Quellbereich des Puffers in den Zielbereich.

targetOffset Optional

Der Offset im Zielarray, ab dem die Werte aus dem Quellarray geschrieben werden. Wird dieser Wert weggelassen, wird 0 angenommen. Das Quellarray überschreibt dann die Werte im Zielarray ab Index 0.

Rückgabewert

Keiner (undefined).

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

  • Ein Element würde über das Ende des typisierten Arrays hinaus gespeichert, weil targetOffset zu groß ist oder weil array oder typedarray zu groß ist.
  • targetOffset ist negativ.

Beispiele

set() verwenden

js
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

uint8.set([1, 2, 3], 3);

console.log(uint8); // Uint8Array [ 0, 0, 0, 1, 2, 3, 0, 0 ]

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.set

Browser-Kompatibilität

Siehe auch