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 Dateneigenschaft eines String-Wertes enthält die Länge des Strings in UTF-16 Code-Einheiten.

Probieren Sie es aus

const str = "Life, the universe and everything. Answer:";

console.log(`${str} ${str.length}`);
// Expected output: "Life, the universe and everything. Answer: 42"

Wert

Eine nicht-negative ganze Zahl.

Eigenschaften von `String: length`
Schreibbar	nein
Aufzählbar	nein
Konfigurierbar	nein

Diese Eigenschaft gibt die Anzahl der Code-Einheiten im String zurück. JavaScript verwendet die UTF-16 Kodierung, bei der jedes Unicode-Zeichen als eine oder zwei Code-Einheiten kodiert werden kann. Daher kann es vorkommen, 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 etc. sollte dies kein Problem darstellen, aber wenn Sie mit bestimmten Schriftsystemen arbeiten, etwa Emojis, mathematischen Symbolen oder obskuren chinesischen Zeichen, müssen Sie möglicherweise den Unterschied zwischen Code-Einheiten und Zeichen berücksichtigen.

Die Sprachspezifikation erfordert, dass Strings eine maximale Länge von 2⁵³ - 1 Elementen haben, was das obere Limit für präzise Ganzzahlen darstellt. Ein String mit dieser Länge benötigt jedoch 16384TiB Speicher, was in kein vernünftiges Gerätespeicher passt, daher neigen Implementierungen dazu, den Schwellenwert zu senken, sodass die Länge des Strings bequem in einer 32-Bit-Ganzzahl gespeichert werden kann.

In V8 (verwendet von Chrome und Node) 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 arbeiten (wie UTF-8-Dateien oder Blobs), beachten Sie, dass beim Laden der Daten in einen JS-String die Kodierung immer 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 ist length 0.

Die statische Eigenschaft String.length steht in keinem Zusammenhang zur Länge von Strings. Es ist die Stelligkeit der String-Funktion (vereinfacht gesagt, die Anzahl der formalen Parameter), die 1 beträgt.

Da length Code-Einheiten anstelle von Zeichen zählt, können Sie, wenn Sie die Anzahl der Zeichen ermitteln möchten, zunächst den String mit seinem Iterator aufteilen, der zeichenweise 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 zuerst den String, den Sie aufteilen möchten, an die Methode segment() ü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

Zuweisen an length

Da String ein primitiver Datentyp ist, hat der Versuch, der length-Eigenschaft eines Strings einen Wert zuzuweisen, keine beobachtbare 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

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-properties-of-string-instances-length

Browser-Kompatibilität

Siehe auch

Array: length