String isWellFormed() and toWellFormed() | Frontend Practical Guide

Newly available 主要ブラウザの最新版で対応済み。古いブラウザが対象外なら使用可能。

対応ブラウザ

機能	デスクトップ				モバイル
機能	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`String.isWellFormed`	111	111	119	16.4	111	16.4
`String.toWellFormed` toWellFormed() は String 値のメソッドで、この文字列のすべての孤立サロゲートを Unicode 置換文字 U+FFFD に置き換えた文字列を返します。	111	111	119	16.4	111	16.4

1+対応 (バージョン) 未対応 ※注釈ありサブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

JAVASCRIPT

'Hello'.isWellFormed();          // true
'\uD800'.isWellFormed();         // false (isolated surrogate)
'\uD800'.toWellFormed();         // '\uFFFD'

isWellFormed を使って、文字列に不完全なサロゲートペアが含まれていないかチェックします。

toWellFormed を使い、不正な文字を置換文字（）に変換して安全に扱えるようにします。

通常の文字列（絵文字含む）が正常な形式であることを確認します。

String isWellFormed() and toWellFormed() の活用

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