CKTIS / JavaScript
Array.prototype.with : copie avec un indice remplacé
with renvoie une copie superficielle dense dont une valeur est remplacée à un indice positif ou négatif donné.
Version : ECMAScript 2023; example target: Node.js 24.22.2
Syntaxe
array.with(index, value)array.with(index, value) crée un nouvel Array ordinaire de même longueur, écrit value à la position choisie et copie toutes les autres valeurs. Elle ne modifie pas array, ignore Symbol.species et les objets inchangés gardent les mêmes références.
index est converti en entier ; une valeur négative compte depuis la fin, donc -1 désigne la dernière position. Un indice inférieur à moins la longueur ou supérieur ou égal à la longueur lève RangeError. Les trous sont lus comme undefined et matérialisés, ce qui rend le résultat dense.
La méthode est générique pour array-like et date d’ECMAScript 2023. Un receveur null ou undefined lève TypeError ; les erreurs de conversion de longueur ou indice, de getters et traps de proxy se propagent, et une longueur trop grande peut aussi produire RangeError.
Exemples
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); }Résultat
a,B,c a,b,c true true 2 true true 9 true