A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/isWellFormed below:

String.prototype.isWellFormed() - JavaScript | MDN

String.prototype.isWellFormed()

Baseline 2023

Newly available

isWellFormed() は String 値のメソッドで、この文字列に孤立サロゲートがあるかどうかを示す論理値を返します。

構文 引数

なし。

返値

この文字列に孤立サロゲートがない場合は true、そうでなれば false。

解説

JavaScript の文字列は UTF-16 エンコードです。UTF-16 エンコーディングには「サロゲートペア」の概念があり、UTF-16 文字、Unicode コードポイント、書記素クラスターの節で詳しく紹介されています。

isWellFormed() を使うと、文字列が整形式であるかどうか(つまり、孤立サロゲートを含まないかどうか)をテストすることができます。 カスタム実装と比べると、isWellFormed() は、エンジンが文字列の内部表現に直接アクセスできるので、より効率的です。 文字列を整形式文字列に変換する必要がある場合は、toWellFormed() メソッドを使ってください。 isWellFormed() を使うと、整形式でない文字列を整形式文字列とは異なる形で扱うことができ、例えば、エラーを発生させたり、無効としたりすることができます。

例 isWellFormed() の使用
const strings = [
  // 孤立上位サロゲート
  "ab\uD800",
  "ab\uD800c",
  // 孤立下位サロゲート
  "\uDFFFab",
  "c\uDFFFab",
  // 整形式
  "abc",
  "ab\uD83D\uDE04c",
];

for (const str of strings) {
  console.log(str.isWellFormed());
}
// Logs:
// false
// false
// false
// false
// true
// true
encodeURI() のエラーを回避

encodeURI は渡された文字列が整形式でなかった場合にエラーが発生します。これは isWellFormed() を使用して、文字列を encodeURI() に渡す前に検査することで回避できます。

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("整形式でない文字列に遭遇しました。"); // 整形式でない文字列に遭遇しました。
}
仕様書 ブラウザーの互換性 関連情報

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4