Array.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 ⁨septiembre de 2015⁩.

El métodocopyWithin() transfiere una copia plana de una sección a otra dentro del mismo array ( o contexto similar ), sin modificar su propiedad length y lo devuelve.

Pruébalo

const array1 = ["a", "b", "c", "d", "e"];// Copy to index 0 the element at index 3console.log(array1.copyWithin(0, 3, 4));// Expected output: Array ["d", "b", "c", "d", "e"]// Copy to index 1 all elements from index 3 to the endconsole.log(array1.copyWithin(1, 3));// Expected output: Array ["d", "d", "e", "d", "e"]

Índice basado en cero que establece en dónde dentro de la secuencia original se insertará la secuencia copiada. Si es negativo,target se contará desde el final. -1 es el último elemento, -2 el penúltimo, etc.

Sitarget es igual o mayor quearr.length, no se copiará nada. Sitarget es posicionado después destart, la secuencia copiada se recortará para que encaje conarr.length.

startOpcional

Índice basado en cero a partir del cual comenzar la copia de elementos. Si es negativo, start comenzará a contarse desde el final.

Sistart es omitido,copyWithin copiará desde el principio (por defecto es 0).

endOpcional

Índice basado en cero hasta el cual se copiarán los elementos.copyWithin copiará hasta pero sin incluir el end. Si es negativo,end será contado desde el final.

Siend es omitido,copyWithin copiará hasta el final ( por defecto esarr.length).

Valor de retorno

El array modificado.

Descripción

copyWithin es similar a la funciónmemmove de C y C++ , siendo altamente eficiente para desplazar los datos en unArray oTypedArray. La secuencia de datos es leída y escrita en una sola operación; la escritura será correcta incluso en el caso de que la zona de lectura y el destino de escritura se solapen.

La funcióncopyWithin es intencionadamentegenérica, permitiendo que se aplique en contextos en los cualesthis no sea necesariamente un objetoArray.

El métodocopyWithin es un método mutador. No altera la propiedadlength dethis, pero cambiará su contenido y creará nuevas propiedades si es necesario.

Ejemplos

En los siguientes ejemplos céntrate en los siguientes aspectos:

El tamaño del contexto en el que se aplica no cambia. En los ejemplos el array parte con cinco elementos y siempre mantiene cinco elementos.
start yend trabajan juntos para decidir qué se copiará. Siempre tienen valor por defecto aunque omitasend, ostart yend.
target trabaja solo y debe especificarse. Indica el lugar para en el que la copia comenzará a sobreescribir datos existentes. Debe estar dentro de los límites en el contexto que se aplique.
escribirarr.copyWithin( n ) es lo mismo quearr.copyWithin( n, 0, arr.length)

[1, 2, 3, 4, 5].copyWithin(-2);// [1, 2, 3, 1, 2][1, 2, 3, 4, 5].copyWithin(0, 3);// [4, 5, 3, 4, 5][1, 2, 3, 4, 5].copyWithin(0, 3, 4);// [4, 2, 3, 4, 5][1, 2, 3, 4, 5].copyWithin(-2, -3, -1);// [1, 2, 3, 3, 4]

A continuación se aplica en el contexto de un objetoarray-like:

El objeto contextual tiene alguna propiedad con clave numérica, y una propiedad length. Esto es suficiente para considerarse array-like.
observa queno se modifica la propiedad length, a pesar de que se ha introducido una nueva propiedad con clave 0. A esto ser refiere cuando se dice quecopyWithin es un métodomutador. ¿Por qué se creó esta nueva propiedad? porque mediante el argumento target se especificó que la copia debía comenzar a partir de un índice que ¡¡no existía!!

[].copyWithin.call({ length: 5, 3: 1 }, 0, 3);// {0: 1, 3: 1, length: 5}

Lo que sigue ahora son las subclases tipadas de Array en ES6:

// Arrays tipados en ES6. Son subclases de Arrayvar i32a = new Int32Array([1, 2, 3, 4, 5]);i32a.copyWithin(0, 2);// Int32Array [3, 4, 5, 4, 5]// En plataformas que todavía no siguen la norma ES6:[].copyWithin.call(new Int32Array([1, 2, 3, 4, 5]), 0, 3, 4);// Int32Array [4, 2, 3, 4, 5]

Polyfill

if (!Array.prototype.copyWithin) {  Array.prototype.copyWithin =    // Array: Number[, Number[, Number]]    function copyWithin(target, start, stop) {      var positiveT = target >= 0,        positiveS = (start = start | 0) >= 0,        length = this.length,        zero = 0,        r = function () {          return (+new Date() * Math.random()).toString(36);        },        delimiter = "\b" + r() + "-" + r() + "-" + r() + "\b",        hold;      stop = stop || this.length;      hold = this.slice        .apply(          this,          positiveT ? [start, stop] : positiveS ? [start, -target] : [start],        )        .join(delimiter);      return (        this.splice.apply(          this,          positiveT            ? [target, stop - start, hold]            : positiveS              ? [target, stop, hold]              : [target, start, hold],        ),        this.join(delimiter).split(delimiter).slice(zero, length)      );    };}