【JavaScript ECMAScript】String::String.prototype.isWellFormedインスタンスメソッドの使い方

String.prototype.isWellFormed()メソッドは、対象の文字列が整形式であるかを判定し、その結果を真偽値で返すメソッドです。

JavaScriptの文字列は、内部的にはUTF-16という文字エンコーディング形式で表現されます。UTF-16では、一般的に1つの文字を1つの16ビットコードユニットで表しますが、絵文字や特定の記号など、Unicodeで定義される広い範囲の文字の一部は、2つの16ビットコードユニットの組み合わせ（これをサロゲートペアと呼びます）で表現されます。

「整形式」とは、これらのサロゲートペアがUnicodeの仕様に従って正しく構成されている状態を指します。具体的には、先行サロゲートの後に対応する後続サロゲートが正しく続くこと、また、単独の先行サロゲートや後続サロゲートが存在しないことなどが条件となります。

もし文字列が整形式でない場合、例えばサロゲートペアが不完全であったり、不正な順序で並んでいたりすると、文字列を表示した際に文字化けが発生したり、文字列を操作する関数が予期せぬ動作を引き起こしたり、さらにはセキュリティ上の問題につながる可能性もあります。

このisWellFormed()メソッドは、そのような潜在的な問題をデータ処理の前に検出するために使用されます。特に、外部からの入力データや、他のシステムから受け取った文字列の品質を検証する際に非常に有用です。文字列が整形式であればtrueを返し、そうでなければfalseを返すため、プログラム内で簡単に文字列の健全性を確認し、より堅牢なアプリケーションを開発することができます。

Copy
1const wellFormedString = "Hello, world! 😊";
2const notWellFormedString = "\uD800"; // 孤立した高位サロゲートコードポイント
3
4const isWellFormedResult1 = wellFormedString.isWellFormed();
5const isWellFormedResult2 = notWellFormedString.isWellFormed();

引数なし

引数はありません

boolean

このメソッドは、文字列がUnicodeの正規化形式（Normalization Form Canonical Decomposition (NFD)）に適合しているかどうかを判定し、適合している場合は true、そうでない場合は false を返します。