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.lengthWpis 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.