Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.with: copia con un indice sostituito

with restituisce una copia superficiale densa con un valore sostituito all’indice positivo o negativo indicato.

Versione: ECMAScript 2023; example target: Node.js 24.22.2

Sintassi

array.with(index, value)

array.with(index, value) crea un nuovo Array ordinario della stessa lunghezza, scrive value nella posizione scelta e copia gli altri valori. Non modifica array, ignora Symbol.species e gli oggetti invariati mantengono gli stessi riferimenti.

index è convertito in intero; un valore negativo conta dalla fine, quindi -1 sceglie l’ultima posizione. Un indice minore dell’opposto della lunghezza o maggiore o uguale alla lunghezza genera RangeError. I vuoti sono letti come undefined e materializzati, rendendo il risultato denso.

Il metodo è generico per array-like ed è stato standardizzato in ECMAScript 2023. Un ricevente null o undefined genera TypeError; errori di conversione di lunghezza o indice, getter e trap di proxy si propagano, e una lunghezza eccessiva può produrre RangeError.

Esempi

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); }

Risultato

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

Fonti