JavaScript/Objekte/Array/copyWithin

Die Array.copyWithin()-Methode kopiert einen Teil eines Arrays in eine andere Stelle des gleichen Arrays und gibt das Ergebnis zurück. Dabei wird die Länge des Arrays nicht verändert.

Syntax

arr.copyWithin(target[, start[, end]])

Attribute

Writable	true
Enumerable	false
Configurable	true

Paramter:

• target: null-Basierter Index, an den die kopierte Sequenz kopiert wird. Wenn target negativ ist, wird vom Ende her gezählt.
• start: null-Basierter Index, an dem das Kopieren begonnen werden soll. Wenn start negativ ist, wird vom Ende angefangen zu zählen.
  Wenn start nicht angegeben wird, nutzt copyWithin den Standardwert 0.
• end: null-Basierter Index an dem das Kopieren beendet werden soll. end ist exklusiv und wird deswegen nicht mit kopiert. Wenn end negativ ist, wird vom Ende angefangen zu zählen.
  Wenn end nicht angegeben wird, nutzt copyWithin den Standardwert arr.length.

Rückgabewert ist das geänderte Array.

Spezifikation

copyWithin()

ECMAScript 2015

2017 Draft

Weblinks

• MDN: Array.copyWithin