String: length

Eine nicht-negative ganze Zahl.

Diese Eigenschaft gibt die Anzahl der Codeeinheiten im String zurück. JavaScript verwendet die UTF-16-Kodierung, wobei jedes Unicode-Zeichen als eine oder zwei Codeeinheiten kodiert werden kann. Daher ist es möglich, dass der von length zurückgegebene Wert nicht mit der tatsächlichen Anzahl der Unicode-Zeichen im String übereinstimmt. Für gängige Schriftsysteme wie Latein, Kyrillisch, bekannte CJK-Zeichen usw. sollte dies kein Problem sein. Wenn Sie jedoch mit bestimmten Schriftsystemen wie Emojis, mathematischen Symbolen oder seltenen chinesischen Zeichen arbeiten, müssen Sie die Differenz zwischen Codeeinheiten und Zeichen berücksichtigen.

Die Sprachspezifikation schreibt vor, dass Strings eine maximale Länge von 2⁵³ - 1 Elementen haben dürfen, was das obere Limit für präzise Ganzzahlen darstellt. Ein String dieser Länge benötigt jedoch 16384TiB Speicherplatz, was in keinem vernünftigen Gerät Speicher finden würde. Implementierungen neigen dazu, diese Grenze zu senken, sodass die Länge des Strings bequem in einem 32-Bit-Ganzzahlwert gespeichert werden kann.

• In V8 (verwendet von Chrome und Node.js) beträgt die maximale Länge 2²⁹ - 24 (~1GiB). Auf 32-Bit-Systemen beträgt die maximale Länge 2²⁸ - 16 (~512MiB).
• In Firefox beträgt die maximale Länge 2³⁰ - 2 (~2GiB). Vor Firefox 65 betrug die maximale Länge 2²⁸ - 1 (~512MiB).
• In Safari beträgt die maximale Länge 2³¹ - 1 (~4GiB).

Wenn Sie mit großen Strings in anderen Kodierungen (wie UTF-8-Dateien oder Blobs) arbeiten, beachten Sie, dass die Kodierung beim Laden der Daten in einen JS-String immer zu UTF-16 wird. 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 hat length den Wert 0.

Die statische Eigenschaft String.length ist nicht mit der Länge von Strings verbunden. Sie gibt die Arity der String-Funktion an (lose definiert als die Anzahl ihrer formalen Parameter), die 1 beträgt.

Da length Codeeinheiten anstelle von Zeichen zählt, können Sie zur Bestimmung der Zeichenanzahl zuerst den String mit seinem Iterator aufteilen, der Zeichen iteriert:

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, 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

Da ein String ein primitiver Datentyp ist, hat der Versuch, den Wert der length-Eigenschaft eines Strings zuzuweisen, keine sichtbare Wirkung und führt im strict mode zu einem Fehler.

const myString = "bluebells";

myString.length = 4;
console.log(myString); // "bluebells"
console.log(myString.length); // 9

• Array: length