String.prototype.isWellFormed()

Syntax

isWellFormed()

Parameter

Keine.

Rckgabewert

Gibt true zurck, wenn diese Zeichenkette keine lone surrogates enthlt, andernfalls false.

Beschreibung

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 ausfhrlich erlutert werden.

isWellFormed() ermglicht es Ihnen zu testen, ob eine Zeichenkette wohlgeformt ist (d.h. keine lone surrogates enthlt). Im Vergleich zu einer benutzerdefinierten Implementierung ist isWellFormed() effizienter, da Engines direkt auf die interne Reprsentation von Zeichenketten zugreifen knnen. Wenn Sie eine Zeichenkette in eine wohlgeformte Zeichenkette umwandeln mssen, 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 ungltig.

Beispiele

Verwendung von isWellFormed()

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 lst 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.

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.
}

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von String.prototype.isWellFormed in core-js
• es-shims Polyfill von String.prototype.isWellFormed
• String.prototype.toWellFormed()
• String.prototype.normalize()