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.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
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()
.
Exemple
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
Spécification | État | Commentaires |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'TypedArray.prototype.copyWithin' dans cette spécification. |
Standard | Définition initiale. |
ECMAScript Latest Draft (ECMA-262) La définition de 'TypedArray.prototype.copyWithin' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Ordinateur | Mobile | Serveur | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Support simple | Chrome Support complet 45 | Edge Support complet 14 | Firefox Support complet 34 | IE Aucun support Non | Opera Support complet 36 | Safari Aucun support Non | WebView Android Aucun support Non | Chrome Android Aucun support Non | Edge Mobile ? | Firefox Android Support complet 34 | Opera Android Aucun support Non | Safari iOS Aucun support Non | Samsung Internet Android Aucun support Non | nodejs Support complet 4.0.0 |
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- Compatibilité inconnue
- Compatibilité inconnue