Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.at: element według indeksu względnego

Metoda at odczytuje element tablicy, a ujemny indeks liczy od końca bez ręcznego używania length.

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

Składnia

array.at(index)

array.at(index) konwertuje index do liczby całkowitej przez obcięcie części ułamkowej. Indeks nieujemny liczy od początku, a ujemny od array.length; -1 oznacza ostatni element. Metoda jest generyczna dla obiektów array-like i nie zmienia odbiorcy.

Gdy obliczony indeks leży poza zakresem, wynikiem jest undefined bez odczytu właściwości. Dziura w tablicy również daje undefined, więc sam wynik nie rozróżnia dziury od jawnej wartości. NaN zachowuje się jak indeks 0, a Infinity jest poza zakresem.

Odbiorca null lub undefined powoduje TypeError. W przeciwieństwie do zapisu array[-1], który szuka właściwości o nazwie "-1", at(-1) naprawdę liczy od końca. Przykład pokazuje indeks ujemny, poza zakresem i ułamek.

Przykłady

const values = ["first", "middle", "last"];
console.log(values.at(-1));
console.log(values.at(-4));
console.log(values.at(1.9));

Wynik

last
undefined
middle

Źródła