CKTIS / JavaScript
String.length — tekenreekslengte in UTF-16-eenheden
De length-eigenschap van een tekenreeks geeft het aantal UTF-16-code-eenheden terug. Dat is niet altijd gelijk aan het aantal tekens dat een gebruiker waarneemt. Lees de eigenschap als text.length, zonder haakjes.
Versie: 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.lengthDeze String.length-vermelding beschrijft de lengte-eigenschap van een tekenreekswaarde: gebruik text.length, niet text.length(). Het resultaat is een niet-negatief geheel getal dat UTF-16-code-eenheden telt. Een lege tekenreeks heeft lengte 0. Dit is onderdeel van ECMAScript, geen Web-API.
Stel deze waarde niet gelijk aan het aantal Unicode-codepunten, door gebruikers waargenomen tekens of bytes. Een emoji die wordt weergegeven met een surrogaatpaar neemt twee eenheden in. Een letter gevolgd door een combinatieteken kan er ook uitzien als één teken, ondanks een lengte van 2.
De lengte van een bepaalde tekenreeks is onveranderlijk; toewijzen aan length kort de tekst niet in. Bij een String-wrapperobject is deze eigen eigenschap niet schrijfbaar, niet opsombaar en niet configureerbaar.
Let op de notatie: de letterlijke expressie String.length leest de lengte van de parameterlijst van de constructor String, niet de lengte van een tekenreeks. Zet om tekst te meten altijd de tekenreekswaarde vóór .length.
Voorbeelden
const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
console.log(text.length);
}Resultaat
0 3 2 2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.