CKTIS / JavaScript
String.length — dĺžka reťazca v jednotkách UTF-16
Vlastnosť length reťazca vracia počet jeho kódových jednotiek UTF-16, čo nie je vždy počet znakov vnímaných používateľom. Číta sa ako text.length, bez zátvoriek.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
text.lengthTento záznam String.length opisuje vlastnosť dĺžky reťazcovej hodnoty: používajte text.length, nie text.length(). Výsledkom je nezáporné celé číslo, ktoré počíta kódové jednotky UTF-16. Prázdny reťazec má dĺžku 0. Je to súčasť ECMAScriptu, nie Web API.
Nezamieňajte túto hodnotu s počtom kódových bodov Unicode, znakov vnímaných používateľom ani bajtov. Emoji reprezentované párom náhradných znakov zaberá dve jednotky. Aj písmeno nasledované kombinujúcim znakom môže vyzerať ako jeden znak, hoci jeho dĺžka je 2.
Dĺžka konkrétneho reťazca je nemenná; priradenie hodnoty do length text neskráti. V obalovom objekte String je táto vlastná vlastnosť nezapisovateľná, nevymenovateľná a nekonfigurovateľná.
Pozor na zápis: doslovný výraz String.length číta dĺžku zoznamu parametrov konštruktora String, nie dĺžku reťazca. Ak chcete zmerať text, vždy umiestnite reťazcovú hodnotu pred .length.
Príklady
const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
console.log(text.length);
}Výsledok
0 3 2 2
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.