WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Typisierte Arrays: Ansicht mit `subarray()`, Kopie mit `slice()`

`subarray()` erstellt eine Ansicht desselben Puffers, `slice()` kopiert die gewählten Elemente standardmäßig in einen separaten Puffer. Beide werten die Bereichsgrenzen gleich aus.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

typedArray.subarray()
typedArray.subarray(start)
typedArray.subarray(start, end)
typedArray.slice()
typedArray.slice(start)
typedArray.slice(start, end)

subarray() und slice() sind Methoden des gemeinsamen Prototyps, den Instanzen wie Uint16Array erben. Einen globalen Konstruktor TypedArray gibt es nicht. Beide Methoden verlangen ein echtes typisiertes Array als this; ein gewöhnliches Array führt zu einem TypeError.

Beide verwenden nullbasierte Elementindizes innerhalb der Ansicht, keine Bytepositionen im Puffer wie ArrayBuffer.prototype.slice(). Der Anfang ist eingeschlossen, das Ende ausgeschlossen. Fehlt start oder ist es undefined, gilt 0; fehlt end oder ist es undefined, gilt das Ende der Ansicht. Nachkommastellen werden in Richtung null abgeschnitten, negative Indizes zählen vom Ende aus, und die Grenzen werden auf den Bereich von 0 bis zur Länge der Ansicht begrenzt. Liegt das so bestimmte Ende am oder vor dem Anfang, geben beide Methoden bei einer gültigen Ansicht auf einen Puffer fester Größe mit dem Standardkonstruktor für das Ergebnis ein leeres typisiertes Array zurück. Ein über constructor[Symbol.species] festgelegter benutzerdefinierter Konstruktor kann auch dann ein nicht leeres typisiertes Array zurückgeben, wenn die angeforderte Länge 0 ist.

Mit dem Standardkonstruktor für das Ergebnis erstellt subarray() eine neue Ansicht desselben Puffers, ohne Elemente zu kopieren. Schreibzugriffe im überlappenden Bereich sind in beiden Ansichten sichtbar. Selbst eine kleine Ansicht kann den gesamten Puffer im Speicher halten; über .buffer sind auch Bytes außerhalb des ausgewählten Bereichs zugänglich. Verwende slice() für eine unabhängige Kopie der ausgewählten Elemente. Ein benutzerdefiniertes constructor[Symbol.species] kann Code ausführen, den Elementtyp ändern oder beeinflussen, ob das Ergebnis denselben Speicher nutzt. Betrachte diese Methoden bei nicht vertrauenswürdigen Objekten nicht als Sicherheitsgrenze.

In ECMAScript 2024 passt eine mit subarray() erzeugte Ansicht beim Standardkonstruktor ihre Länge weiterhin an den Puffer an, wenn die Quellansicht das ebenfalls tut und end fehlt oder undefined ist. Ein end ungleich undefined ergibt eine Ansicht fester Länge; slice() liefert standardmäßig eine Kopie fester Länge. Ist der Puffer beim Aufruf bereits abgetrennt oder liegt die Quellansicht außerhalb seiner Grenzen, wirft slice() einen TypeError. subarray() rechnet dann mit einer Quelllänge von 0, doch das Erstellen des Ergebnisses kann trotzdem fehlschlagen. Prüfe, ob deine Zielumgebung Puffer mit veränderbarer Größe unterstützt.

Beispiele

{
  const source = new Uint16Array([10, 20, 30, 40]);
  const view = source.subarray(1, -1);
  const copy = source.slice(1, -1);

  view[0] = 99;
  source[2] = 77;

  console.log(`source: ${source.join(', ')}`);
  console.log(`view: ${view.join(', ')}`);
  console.log(`copy: ${copy.join(', ')}`);
  console.log(`same buffer: ${view.buffer === source.buffer}, ${copy.buffer === source.buffer}`);
}

Ergebnis

source: 10, 99, 77, 40
view: 99, 77
copy: 20, 30
same buffer: true, false

`(1, -1)` wählt `20` und `30` aus. Ein Schreibzugriff über `view` ändert `source`, und ein Schreibzugriff über `source` ändert `view`. `copy` behält `20, 30` und hat einen eigenen Puffer.

Zugehörige Lektionen

  • JavaScript · Lektion 2 · Fortgeschritten · Version: 4

Quellen