String.prototype.isWellFormed()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.

Die isWellFormed() Methode von String Werten gibt einen Booleschen Wert zurück, der anzeigt, ob diese Zeichenkette lone surrogates enthält.

In diesem Artikel

Syntax

isWellFormed()

Rückgabewert

Gibt true zurück, wenn diese Zeichenkette keine lone surrogates enthält, andernfalls false.

Zeichenketten in JavaScript sind UTF-16-kodiert. Die UTF-16-Kodierung hat das Konzept der Surrogatpaare, die im Abschnitt UTF-16-Zeichen, Unicode-Codierungen und Graphem-Cluster ausführlich erläutert werden.

isWellFormed() ermöglicht es Ihnen zu testen, ob eine Zeichenkette wohlgeformt ist (d.h. keine lone surrogates enthält). Im Vergleich zu einer benutzerdefinierten Implementierung ist isWellFormed() effizienter, da Engines direkt auf die interne Repräsentation von Zeichenketten zugreifen können. Wenn Sie eine Zeichenkette in eine wohlgeformte Zeichenkette umwandeln müssen, verwenden Sie die toWellFormed() Methode. isWellFormed() erlaubt es, fehlerhafte Zeichenketten anders zu behandeln als wohlgeformte, wie z.B. das Werfen eines Fehlers oder das Markieren als ungültig.

Beispiele

Verwendung von isWellFormed()

js
const strings = [
  // Lone leading surrogate
  "ab\uD800",
  "ab\uD800c",
  // Lone trailing surrogate
  "\uDFFFab",
  "c\uDFFFab",
  // Well-formed
  "abc",
  "ab\uD83D\uDE04c",
];

for (const str of strings) {
  console.log(str.isWellFormed());
}
// Logs:
// false
// false
// false
// false
// true
// true

Vermeidung von Fehlern in encodeURI()

encodeURI löst einen Fehler aus, wenn die übergebene Zeichenkette nicht wohlgeformt ist. Dies kann vermieden werden, indem isWellFormed() verwendet wird, um die Zeichenkette zu testen, bevor sie an encodeURI() übergeben wird.

js
const illFormed = "https://example.com/search?q=\uD800";

try {
  encodeURI(illFormed);
} catch (e) {
  console.log(e); // URIError: URI malformed
}

if (illFormed.isWellFormed()) {
  console.log(encodeURI(illFormed));
} else {
  console.warn("Ill-formed strings encountered."); // Ill-formed strings encountered.
}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
String
Konstruktor
1. String()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. length
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor

String.prototype.isWellFormed()

In diesem Artikel

Syntax

Parameter

Rückgabewert

Beschreibung

Beispiele

Verwendung von isWellFormed()

Vermeidung von Fehlern in encodeURI()

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN