Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.at — odczyt jednostki UTF-16 według indeksu

String.prototype.at(index) zwraca napis zawierający jedną jednostkę kodową UTF-16. Indeksy ujemne liczą od końca, a pozycja poza zakresem daje undefined.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

string.at(index)

String.prototype.at(index) odczytuje jedną jednostkę kodową UTF-16 bez zmiany napisu. Indeksy zaczynają się od 0; -1 oznacza ostatnią jednostkę, a -2 przedostatnią. Wynikiem jest napis o długości 1 albo undefined, jeśli obliczona pozycja wypada poza zakresem. Dla pustego napisu metoda zwraca undefined, jeśli konwersja indeksu się powiedzie. Konwersja odbywa się przed sprawdzeniem zakresu, więc "".at(0n) zgłasza TypeError.

Argument jest konwertowany na liczbę całkowitą przez odrzucenie części ułamkowej w kierunku zera. Pominięty argument, undefined i NaN oznaczają indeks 0; nieskończoności dają undefined. Dla ujemnego indeksu pozycja wynosi string.length + index po konwersji.

W przeciwieństwie do at(), charAt() nie liczy od końca dla indeksów ujemnych i zwraca "" poza zakresem. Zapis text[-1] odczytuje właściwość o nazwie "-1", a nie ostatnią jednostkę napisu.

Jednostka UTF-16 nie musi być całym znakiem Unicode ani znakiem widocznym dla użytkownika: "😀".at(0) zwraca tylko pierwszą połowę pary surogatów. Metoda należy do ECMAScript 2022, nie do API przeglądarki. Specyfikacja nie określa wersji wspierających ją przeglądarek; przed wdrożeniem sprawdź środowiska docelowe, np. przez typeof String.prototype.at === "function".

Przykłady

const text = "JavaScript";
console.log(text.at(0));
console.log(text.at(-1));
console.log(text.at(-2));
console.log(text.at(10));
console.log(text.charAt(10) === "");
console.log("😀".at(0).length);

Wynik

J
t
p
undefined
true
1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła