La méthode JavaScript Array copyWithin () copie superficiellement les éléments du tableau à une autre position du tableau, en écrasant les valeurs existantes.
La syntaxe de la copyWithin()
méthode est:
arr.copyWithin(target, start, end)
Ici, arr est un tableau.
Paramètres de copyWithin ()
La copyWithin()
méthode prend en compte:
- target - La position d'index vers laquelle copier les éléments.
- start (facultatif) - La position d'index à partir de laquelle commencer la copie des éléments. S'il est omis, il copiera à partir de l'index 0 .
- end (facultatif) - La position d'index à partir de laquelle terminer la copie des éléments. (exclusif) Si omis, il copiera jusqu'au dernier index.
Remarques:
- Si l'un des arguments est négatif, l'index sera compté à rebours. Par exemple, -1 représente le dernier élément et ainsi de suite.
- Si la valeur cible est après le début, la séquence copiée est ajustée pour s'adapter à la longueur d'arr .
Valeur renvoyée par copyWithin ()
- Renvoie le tableau modifié après avoir copié les éléments.
Remarques :
- Cette méthode écrase le tableau d'origine.
- Cette méthode ne modifie pas la longueur du tableau d'origine.
Exemple: Utilisation de la méthode copyWithin ()
let array = (1, 2, 3, 4, 5, 6); // target: from second-to-last element, start: 0, end: array.length let returned_arr = array.copyWithin(-2); console.log(returned_arr); // ( 1, 2, 3, 4, 1, 2 ) // modifies the original array console.log(array); // ( 1, 2, 3, 4, 1, 2 ) array = (1, 2, 3, 4, 5, 6); // target: 0, start copying from 5th element array.copyWithin(0, 4); console.log(array); // ( 5, 6, 3, 4, 5, 6 ) array = (1, 2, 3, 4, 5, 6); // target: 1, start copying from 3rd element to second-to-last element array.copyWithin(1, 2, -1); // -1 = last element (exclusive) console.log(array); // ( 1, 3, 4, 5, 5, 6 )
Production
(1, 2, 3, 4, 1, 2) (1, 2, 3, 4, 1, 2) (5, 6, 3, 4, 5, 6) (1, 3, 4, 5, 5, 6)