CKTIS / JavaScript
Array.prototype.toReversed: obrácená kopie
toReversed vytvoří obrácenou mělkou kopii bez změny příjemce a převede díry na undefined.
Verze: ECMAScript 2023; example target: Node.js 24.22.2
Syntaxe
array.toReversed()array.toReversed() přečte délku příjemce, vytvoří nové běžné Array a zapíše hodnoty v obráceném pořadí. Nemá argumenty, nemění array a nepoužívá Symbol.species; objekty prvků mají stejné reference, protože kopie je mělká.
Na rozdíl od reverse() je výsledek vždy hustý: čtení prázdné pozice dá undefined a v kopii se poté vytvoří vlastní vlastnost s touto hodnotou. Metoda je obecná a pracuje s array-like hodnotami přes length a indexované vlastnosti.
Příjemce null nebo undefined vyvolá TypeError. Chyby převodu délky, getterů a proxy trapů se šíří; délka příliš velká pro běžné Array může způsobit RangeError. Metoda byla standardizována v ECMAScript 2023.
Příklady
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);Výsledek
c,b,a a,b,c true true 3 true true true true