Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
TypedArray.prototype.copyWithin()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2016.
La méthodecopyWithin() permet de copier des éléments d'un tableau dans le tableau typé à partir de la positioncible. Les éléments copiés sont ceux contenus entre les indexdébut etfin. L'argumentfin 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 queArray.prototype.copyWithin.TypedArray est l'un des types detableaux typés.
Exemple interactif
const uint8 = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);// Insert position, start position, end positionuint8.copyWithin(3, 1, 3);console.log(uint8);// Expected output: Uint8Array [1, 2, 3, 2, 3, 6, 7, 8]Syntaxe
typedarray.copyWithin(cible, début[, fin = this.length])Paramètres
cibleLa position, dans le tableau typé, à partir de laquelle on souhaite copier les éléments.
débutLa position du tableau contenant les éléments à copier à partir de laquelle copier les éléments.
finFacultatifParamètre optionnel. La position jusqu'à laquelle prendre les éléments à copier.
Valeur de retour
Le tableau typé, modifié par la fonction.
Description
Voir la pageArray.prototype.copyWithin pour plus d'informations.
Cette méthode remplace la méthode expérimentaleTypedArray.prototype.move().
Exemples
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® 2026 Language Specification # sec-%typedarray%.prototype.copywithin |