ArrayBuffer.prototype.slice()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die slice()-Methode von ArrayBuffer-Instanzen gibt ein neues ArrayBuffer zurück, dessen Inhalt eine Kopie der Bytes dieses ArrayBuffer von start bis, aber ausschließlich, end ist. Wenn entweder start oder end negativ ist, bezieht es sich auf einen Index vom Ende des Arrays, anstatt vom Anfang.

Probieren Sie es aus

Syntax

js
slice()
slice(start)
slice(start, end)

Parameter

start Optional

Der Null-basierte Index, an dem die Extraktion beginnt, in eine ganze Zahl umgewandelt.

  • Ein negativer Index zählt rückwärts vom Ende des Puffers — wenn -buffer.length <= start < 0, wird start + buffer.length verwendet.
  • Wenn start < -buffer.length oder start weggelassen wird, wird 0 verwendet.
  • Wenn start >= buffer.length, wird ein leerer Puffer zurückgegeben.
end Optional

Der Null-basierte Index, an dem die Extraktion beendet wird, in eine ganze Zahl umgewandelt. slice() extrahiert bis, aber nicht einschließlich end.

  • Ein negativer Index zählt rückwärts vom Ende des Puffers — wenn -buffer.length <= end < 0, wird end + buffer.length verwendet.
  • Wenn end < -buffer.length, wird 0 verwendet.
  • Wenn end >= buffer.length oder end weggelassen wird, wird buffer.length verwendet, wodurch alle Elemente bis zum Ende extrahiert werden.
  • Wenn end eine Position impliziert, die vor oder an der Position liegt, die start impliziert, wird ein leerer Puffer zurückgegeben.

Rückgabewert

Ein neues ArrayBuffer, das die extrahierten Elemente enthält.

Beispiele

Kopieren eines ArrayBuffer

js
const buf1 = new ArrayBuffer(8);
const buf2 = buf1.slice(0);

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-arraybuffer.prototype.slice

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch