El método copyWithin () de JavaScript Array copia los elementos de la matriz a otra posición en la matriz, sobrescribiendo los valores existentes.
La sintaxis del copyWithin()
método es:
arr.copyWithin(target, start, end)
Aquí, arr es una matriz.
copyWithin () Parámetros
El copyWithin()
método incluye:
- target: la posición del índice donde copiar los elementos.
- start (opcional): la posición de índice desde la que empezar a copiar elementos. Si se omite, se copiará del índice 0 .
- end (opcional): la posición de índice desde la que finalizar la copia de elementos. (exclusivo) Si se omite, se copiará hasta el último índice.
Notas:
- Si alguno de los argumentos es negativo, el índice se contará desde atrás. Por ejemplo, -1 representa el último elemento y así sucesivamente.
- Si el valor objetivo es posterior al inicio, la secuencia copiada se recorta para ajustarse a la longitud de arr .
Valor de retorno de copyWithin ()
- Devuelve la matriz modificada después de copiar los elementos.
Notas :
- Este método sobrescribe la matriz original.
- Este método no cambia la longitud de la matriz original.
Ejemplo: uso del método 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 )
Salida
(1, 2, 3, 4, 1, 2) (1, 2, 3, 4, 1, 2) (5, 6, 3, 4, 5, 6) (1, 3, 4, 5, 5, 6)