TypedArray.prototype.copyWithin()

Baseline Widely available

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

La méthode copyWithin() permet de copier des éléments d'un tableau dans le tableau typé à partir de la position cible. Les éléments copiés sont ceux contenus entre les index début et fin. L'argument fin est optionnel, sa valeur par défaut correspondra à la longueur du tableau dont on souhaite copier les éléments. Cette méthode utilise le même algorithme que Array.prototype.copyWithin. TypedArray est l'un des types de tableaux typés.

Exemple interactif

Syntaxe

js
typedarray.copyWithin(cible, début[, fin = this.length])

Paramètres

cible

La position, dans le tableau typé, à partir de laquelle on souhaite copier les éléments.

début

La position du tableau contenant les éléments à copier à partir de laquelle copier les éléments.

fin Facultatif

Paramètre optionnel. La position jusqu'à laquelle prendre les éléments à copier.

Valeur de retour

Le tableau typé, modifié par la fonction.

Description

Voir la page Array.prototype.copyWithin pour plus d'informations.

Cette méthode remplace la méthode expérimentale TypedArray.prototype.move().

Exemples

js
var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);
console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]
uint8.copyWithin(3, 0, 3);
console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]

Spécifications

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.copywithin

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi