String: length
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die length
Daten-Eigenschaft eines String
-Werts enthält die Länge des Strings in UTF-16-Codeeinheiten.
Probieren Sie es aus
Wert
Eine nicht-negative ganze Zahl.
Eigenschaften der String: length -Property |
|
---|---|
Schreibbar | nein |
Aufzählbar | nein |
Konfigurierbar | nein |
Beschreibung
Diese Eigenschaft gibt die Anzahl der Codeeinheiten im String zurück. JavaScript verwendet die UTF-16-Codierung, bei der jedes Unicode-Zeichen als eine oder zwei Codeeinheiten kodiert werden kann. Daher kann der von length
zurückgegebene Wert von der tatsächlichen Anzahl der Unicode-Zeichen im String abweichen. Für gängige Schriftsätze wie Latein, Kyrillisch, bekannte CJK-Zeichen usw. sollte dies kein Problem darstellen. Wenn Sie jedoch mit bestimmten Schriftsätzen wie Emojis, mathematischen Symbolen oder seltenen chinesischen Zeichen arbeiten, müssen Sie möglicherweise die Differenz zwischen Codeeinheiten und Zeichen berücksichtigen.
Die Sprachspezifikation erfordert, dass Strings eine maximale Länge von 253 - 1 Elementen haben, was die obere Grenze für genaue Ganzzahlen ist. Ein String mit dieser Länge benötigt jedoch 16384TiB Speicherplatz, was in keinem realistischen Gerät gespeichert werden kann, sodass Implementierungen im Allgemeinen die Grenze senken, sodass die Länge des Strings bequem in einem 32-Bit-Integer gespeichert werden kann.
- In V8 (verwendet von Chrome und Node) ist die maximale Länge 229 - 24 (~1GiB). Auf 32-Bit-Systemen beträgt die maximale Länge 228 - 16 (~512MiB).
- In Firefox beträgt die maximale Länge 230 - 2 (~2GiB). Vor Firefox 65 betrug die maximale Länge 228 - 1 (~512MiB).
- In Safari beträgt die maximale Länge 231 - 1 (~4GiB).
Wenn Sie mit großen Strings in anderen Zeichencodierungen (wie UTF-8-Dateien oder Blobs) arbeiten, beachten Sie, dass die Codierung immer UTF-16 wird, wenn Sie die Daten in einen JS-String laden. Die Größe des Strings kann sich von der Größe der Quelldatei unterscheiden.
const str1 = "a".repeat(2 ** 29 - 24); // Success
const str2 = "a".repeat(2 ** 29 - 23); // RangeError: Invalid string length
const buffer = new Uint8Array(2 ** 29 - 24).fill("a".codePointAt(0)); // This buffer is 512MiB in size
const str = new TextDecoder().decode(buffer); // This string is 1GiB in size
Für einen leeren String ist length
0.
Die statische Eigenschaft String.length
steht in keinem Zusammenhang zur Länge von Strings. Sie ist die Arity der String
-Funktion (im Allgemeinen die Anzahl ihrer formalen Parameter) und beträgt 1.
Da length
Codeeinheiten statt Zeichen zählt, können Sie, wenn Sie die Anzahl der Zeichen ermitteln möchten, den String zuerst mit seinem Iterator aufteilen, der Zeichen als Einheiten betrachtet:
function getCharacterLength(str) {
// The string iterator that is used here iterates over characters,
// not mere code units
return [...str].length;
}
console.log(getCharacterLength("A\uD87E\uDC04Z")); // 3
Wenn Sie Zeichen nach Graphem-Clustern zählen möchten, verwenden Sie Intl.Segmenter
. Sie können den String, den Sie aufteilen möchten, zuerst an die segment()
-Methode übergeben und dann über das zurückgegebene Segments
-Objekt iterieren, um die Länge zu erhalten:
function getGraphemeCount(str) {
const segmenter = new Intl.Segmenter("en-US", { granularity: "grapheme" });
// The Segments object iterator that is used here iterates over characters in grapheme clusters,
// which may consist of multiple Unicode characters
return [...segmenter.segment(str)].length;
}
console.log(getGraphemeCount("👨👩👧👧")); // 1
Beispiele
Grundlegende Verwendung
const x = "Mozilla";
const empty = "";
console.log(`${x} is ${x.length} code units long`);
// Mozilla is 7 code units long
console.log(`The empty string has a length of ${empty.length}`);
// The empty string has a length of 0
Strings mit einer Länge, die nicht der Anzahl der Zeichen entspricht
const emoji = "😄";
console.log(emoji.length); // 2
console.log([...emoji].length); // 1
const adlam = "𞤲𞥋𞤣𞤫";
console.log(adlam.length); // 8
console.log([...adlam].length); // 4
const formula = "∀𝑥∈ℝ,𝑥²≥0";
console.log(formula.length); // 11
console.log([...formula].length); // 9
Zuweisung zur Länge
Da String ein primitiver Datentyp ist, hat der Versuch, einen Wert der length
-Eigenschaft eines Strings zuzuweisen, keinen sichtbaren Effekt und führt im strikten Modus zu einem Fehler.
const myString = "bluebells";
myString.length = 4;
console.log(myString); // "bluebells"
console.log(myString.length); // 9
Spezifikationen
Specification |
---|
ECMAScript Language Specification # sec-properties-of-string-instances-length |
Browser-Kompatibilität
BCD tables only load in the browser