Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.with: copia con un índice sustituido

with devuelve una copia superficial densa con un valor sustituido en el índice positivo o negativo indicado.

Versión: ECMAScript 2023; example target: Node.js 24.22.2

Sintaxis

array.with(index, value)

array.with(index, value) crea un Array ordinario nuevo de igual longitud, escribe value en la posición elegida y copia los demás valores. No muta array, ignora Symbol.species y los objetos no cambiados conservan las mismas referencias.

index se convierte en entero; un valor negativo cuenta desde el final, por lo que -1 selecciona la última posición. Un índice menor que menos la longitud o mayor o igual que ella lanza RangeError. Los huecos se leen como undefined y se materializan, haciendo denso el resultado.

El método es genérico para array-like y se estandarizó en ECMAScript 2023. Un receptor null o undefined lanza TypeError; se propagan fallos de conversión de longitud o índice, getters y traps de proxy, y una longitud excesiva también puede producir RangeError.

Ejemplos

const source = [{ id: "a" }, { id: "b" }, { id: "c" }];
const changed = source.with(-2, { id: "B" });
console.log(changed.map(item => item.id).join(","));
console.log(source.map(item => item.id).join(","));
console.log(changed !== source, changed[0] === source[0]);

const dense = [, 2].with(1, 9);
console.log(dense.length, 0 in dense, dense[0] === undefined, dense[1]);
try { [1].with(2, 0); } catch (error) { console.log(error instanceof RangeError); }

Resultado

a,B,c
a,b,c
true true
2 true true 9
true

Fuentes