CKTIS / JavaScript
String.length — Zeichenkettenlänge in UTF-16-Codeeinheiten
Die length-Eigenschaft einer Zeichenkette gibt die Anzahl ihrer UTF-16-Codeeinheiten zurück, nicht unbedingt die Zahl der für Menschen wahrnehmbaren Zeichen. Lies sie als text.length, ohne Klammern.
Version: 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.lengthDieser Eintrag zu String.length beschreibt die Längeneigenschaft eines Zeichenkettenwerts: Verwende text.length, nicht text.length(). Das Ergebnis ist eine nichtnegative Ganzzahl, die UTF-16-Codeeinheiten zählt. Eine leere Zeichenkette hat die Länge 0. Dies gehört zu ECMAScript und ist keine Web-API.
Setze diesen Wert nicht mit der Anzahl der Unicode-Codepoints, der für Menschen wahrnehmbaren Zeichen oder der Bytes gleich. Ein Emoji, das durch ein Surrogatpaar dargestellt wird, belegt zwei Einheiten. Auch ein Buchstabe mit einem darauf folgenden kombinierenden Zeichen kann wie ein einzelnes Zeichen aussehen, obwohl die Länge 2 beträgt.
Die Länge einer bestimmten Zeichenkette ist unveränderlich; eine Zuweisung an length kürzt den Text nicht. Bei einem String-Wrapperobjekt ist diese eigene Eigenschaft nicht beschreibbar, nicht aufzählbar und nicht konfigurierbar.
Achte auf die Schreibweise: Der wörtliche Ausdruck String.length liest die Länge der Parameterliste des Konstruktors String, nicht die Länge einer Zeichenkette. Um Text zu messen, muss der Zeichenkettenwert immer vor .length stehen.
Beispiele
const samples = ["", "abc", "\uD83D\uDE00", "e\u0301"];
for (const text of samples) {
console.log(text.length);
}Ergebnis
0 3 2 2
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.