Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.toReversed: odwrócona kopia

toReversed tworzy odwróconą, płytką kopię tablicy bez zmiany odbiorcy i materializuje dziury jako undefined.

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

Składnia

array.toReversed()

array.toReversed() odczytuje długość odbiorcy, tworzy zwykłą nową tablicę i zapisuje wartości w odwrotnej kolejności. Nie przyjmuje argumentów, nie zmienia array i nie korzysta z Symbol.species; obiekty elementów pozostają tymi samymi referencjami, bo kopia jest płytka.

W przeciwieństwie do reverse() wynik jest zawsze gęsty: odczyt pustego miejsca daje undefined, po czym w kopii powstaje własna właściwość o tej wartości. Metoda jest generyczna i działa z array-like na podstawie length oraz indeksów.

Odbiorca null lub undefined powoduje TypeError. Błędy konwersji length, getterów i proxy trapów są propagowane; array-like o długości zbyt dużej dla zwykłej tablicy może spowodować RangeError. Funkcja jest częścią ECMAScript 2023.

Przykłady

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

Wynik

c,b,a
a,b,c
true true
3 true true true true

Źródła