CKTIS / JavaScript
Array.prototype.toReversed: obrnjena kopija
toReversed ustvari obrnjeno plitvo kopijo brez spremembe prejemnika in luknje pretvori v undefined.
Različica: ECMAScript 2023; example target: Node.js 24.22.2
Sintaksa
array.toReversed()array.toReversed() prebere dolžino prejemnika, ustvari nov navaden Array in zapiše vrednosti v obratnem vrstnem redu. Ne sprejme argumentov, ne spremeni array in ne upošteva Symbol.species; objekti elementov ohranijo iste reference, ker je kopija plitva.
Za razliko od reverse() je rezultat vedno gost: branje praznega mesta vrne undefined, nato pa se v kopiji ustvari lastna lastnost s to vrednostjo. Metoda je splošna in dela z array-like vrednostmi prek length ter indeksiranih lastnosti.
Prejemnik null ali undefined sproži TypeError. Napake pretvorbe dolžine, getterjev in proxy pasti se širijo; dolžina, prevelika za navaden Array, lahko povzroči RangeError. Metoda je bila standardizirana v ECMAScript 2023.
Primeri
const source = [{ id: "a" }, { id: "b" }, { id: "c" }];
const copy = source.toReversed();
console.log(copy.map(item => item.id).join(","));
console.log(source.map(item => item.id).join(","));
console.log(copy !== source, copy[0] === source[2]);
const sparse = [1, , 3];
const dense = sparse.toReversed();
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, dense[1] === undefined);Rezultat
c,b,a a,b,c true true 3 true true true true