CKTIS / JavaScript
String.length — dolžina niza v enotah UTF-16
Lastnost length niza vrne število njegovih kodnih enot UTF-16, kar ni vedno enako številu znakov, ki jih zazna uporabnik. Preberemo jo kot text.length, brez oklepajev.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
text.lengthTa zapis String.length opisuje lastnost dolžine vrednosti niza: uporabite text.length, ne text.length(). Rezultat je nenegativno celo število, ki šteje kodne enote UTF-16. Prazen niz ima dolžino 0. To je del ECMAScripta, ne spletni API.
Te vrednosti ne enačite s številom kodnih točk Unicode, znakov, ki jih zazna uporabnik, ali bajtov. Emoji, predstavljen s surogatnim parom, zasede dve enoti. Tudi črka, ki ji sledi kombinirno znamenje, je lahko videti kot en znak, čeprav je njena dolžina 2.
Dolžina posameznega niza je nespremenljiva; prirejanje vrednosti lastnosti length besedila ne skrajša. Pri ovojniškem objektu String ta lastna lastnost ni zapisljiva, ni naštevna in ni nastavljiva.
Bodite pozorni na zapis: dobesedni izraz String.length prebere dolžino seznama parametrov konstruktorja String, ne dolžine niza. Za merjenje besedila zato vrednost niza vedno postavite pred .length.
Primeri
const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
console.log(text.length);
}Rezultat
0 3 2 2
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.