String: length

Eine nicht-negative ganze Zahl.

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 2⁵³ - 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 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 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

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

• Array: length