Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.reverse: odwrócenie w miejscu

reverse odwraca kolejność indeksów w miejscu, zachowuje dziury i zwraca ten sam obiekt.

Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2

Składnia

array.reverse()

array.reverse() zamienia parami właściwości od początku i końca, używając długości odbiorcy, po czym zwraca dokładnie ten sam obiekt. Metoda mutuje tablicę. Dla rzadkiej tablicy sprawdza istnienie obu właściwości: dziura jest przenoszona przez odpowiednie usunięcie, a nie zamieniana na element o wartości undefined.

Metoda nie przyjmuje argumentów i jest generyczna dla modyfikowalnych obiektów array-like. Długość zero lub jeden nie wymaga zamian. Odbiorca null lub undefined powoduje TypeError. Getter, setter, Proxy, niemodyfikowalna właściwość albo nieusuwalny indeks może zgłosić wyjątek; wcześniejsze zamiany nie muszą zostać cofnięte, więc odbiorca może pozostać częściowo odwrócony.

Przykłady

const values = [1, 2, 3];
const returned = values.reverse();
console.log(returned === values, values.join(","));
const sparse = [];
sparse.length = 4;
sparse[0] = "a";
sparse[2] = "c";
sparse.reverse();
console.log(sparse.length, Object.keys(sparse).join(","), sparse[1], sparse[3]);
const record = { 0: "x", 2: "z", length: 3 };
Array.prototype.reverse.call(record);
console.log(record[0], record[2], record.length === 3);

Wynik

true 3,2,1
4 1,3 c a
z x true

Źródła