Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.length — długość napisu w jednostkach UTF-16

Właściwość length napisu zwraca liczbę jednostek kodowych UTF-16, a nie zawsze liczbę znaków widocznych dla użytkownika. Odczytuj ją jako text.length, bez nawiasów.

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

text.length

Wpis String.length opisuje tutaj właściwość długości wartości tekstowej: używaj text.length, nie text.length(). Wynikiem jest nieujemna liczba całkowita oznaczająca liczbę jednostek kodowych UTF-16. Pusty napis ma długość 0. To element języka ECMAScript, nie interfejs Web API.

Nie utożsamiaj tej wartości z liczbą punktów kodowych Unicode, znaków widocznych dla użytkownika ani bajtów. Emoji zapisane parą surogatów zajmuje dwie jednostki. Litera i następujący po niej znak łączący również mogą wyglądać jak jeden znak, mimo długości 2.

Długość danego napisu jest niezmienna; przypisanie do length nie skraca tekstu. W obiekcie opakowującym String ta własna właściwość jest niezapisywalna, niewyliczalna i niekonfigurowalna.

Uwaga na zapis: dosłowne wyrażenie String.length odczytuje długość listy parametrów konstruktora String, a nie długość napisu. Do pomiaru tekstu zawsze używaj wartości tekstowej przed .length.

Przykłady

const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
  console.log(text.length);
}

Wynik

0
3
2
2

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

Źródła