エスケープ・アンエスケープ変換

4つの形式で文字列を変換

入力したテキストについて、選んだ形式のエスケープ結果とアンエスケープ結果を並べて確認できます。形式は JavaScript、JSON、HTML、URL の4種類です。ここでいうエスケープは、文字を特定の構文やURI部品で表せる形に置き換える処理です。暗号化や文字コードのバイト変換とは異なります。

モードを選ぶと、入力の変更に応じて両方の結果が更新されます。どちらを使うかは貼り付け先の形式と位置で決めてください。同じ引用符やアンパサンドでも、JavaScript文字列、HTML、URLパラメーターでは規則が異なります。

JSONは文字列の中身を出力

JSONモードのエスケープ結果には、JSON文字列を囲む外側の二重引用符が含まれません。たとえば 彼は「はい」と言った のような入力では、引用符などをJSON文字列内で表せる形にします。オブジェクトや配列に入れる場合は、適切な引用符や区切り記号を含めた全体のJSONを別途組み立てて確認します。

JSONはJavaScriptのコードそのものではなく、データ交換用の形式です。RFC 8259は文字列の区切りやエスケープ規則を定めています。JavaScriptモードの出力をJSONとして使えると決めつけず、対象の形式で検証してください。

URLは値や部品ごとに処理

URLモードは入力全体を1つのURIコンポーネントとして変換します。たとえば検索語 coffee & tea は coffee%20%26%20tea のように表せます。クエリーの値を作る場合は値だけを変換し、? や & などURLの区切りはそのまま組み立てます。完全なURLを貼り付けて丸ごと変換する用途ではありません。

HTMLとJavaScriptの対応範囲

HTMLモードは &、<、>、二重引用符、アポストロフィを文字参照に変換します。解除時に認識するのも <、>、"、'、& の5種類です。HTML全体の解析や任意の名前付き参照の復元はしません。

JavaScriptモードはバックスラッシュ、改行、復帰、タブ、フォームフィード、バックスペース、引用符を簡易的に扱います。Unicodeエスケープやテンプレートリテラルを含むJavaScript文法全体を変換する機能ではありません。

入力から必要な表現を取り出す

1. 変換したい文字列を入力欄に貼り付けるか入力します。改行も文字列の一部として扱われます。

2. JavaScript、JSON、HTML、URLから、実際に使う場所に合ったモードを選びます。

3. 表示されたエスケープ結果とアンエスケープ結果を確認します。入力が既に変換済みなら、解除結果が意図した文字列になるか照合します。

4. 該当する結果欄からコピーし、対象のコードや文書に組み込んだ後、全体の構文や表示を別途確認します。

短い例で使い分ける

URLクエリーの検索語が 猫 & 犬 の場合、URLモードで語句だけを処理し、結果を ?q=... の値に入れます。JSONへ入れる文章はJSONモードを使い、返された文字列部分を引用符の内側に置きます。HTML本文に山括弧を文字として表示したい場合はHTMLモードを選びます。

変換結果についての質問

変換だけで安全性は確認できない

エスケープは暗号化でも、入力の検証やHTMLのサニタイズでもありません。HTML本文、属性値、JavaScript文字列、URLパラメーターはそれぞれ適用する規則が異なります。出力をそのまま使えると判断せず、実際の挿入位置に適した処理を行い、組み込んだ結果を検証してください。HTMLの変換範囲とJavaScriptの簡易規則にも限りがあります。

規格を確認するための資料