JSONアンエスケープ

JSONアンエスケープとは？

// Escaped input (copied from a log, quotes optional)
User said: \"it works!\"\nSession ended.

// Unescaped output — readable again
User said: "it works!"
Session ended.

// \uXXXX and surrogate pairs decode too
caf\u00e9 \ud83d\ude00  ->  café 😀

// JSON-in-JSON
{\"a\":1}  ->  {"a":1}

主な機能

例

"User said: \"it works!\"\nSession ended."

{\"event\":\"signup\",\"user\":{\"id\":42}}

caf\u00e9 \ud83d\ude00 r\u00e9sum\u00e9

function greet(name) {\n  return \"Hi \" + name;\n}

使い方

1. 1

   エスケープ済み文字列を貼り付ける

   JSONエスケープ済みの文字列を、囲みの二重引用符あり・なしのどちらでも入力または貼り付けます。デコード済みテキストが即座に表示されます。「例を読み込む」をクリックすると、エスケープ済みのログ行や \uXXXX エンコードされた文字列などのサンプルを試せます。

2. 2

   デコード済み出力を読む

   エスケープシーケンスが本物の文字になります。\n は改行に、\" は引用符に、\uXXXX はUnicodeになります。入力が不正な形式の場合、エラーバナーが問題を説明するので、問題のあるバックスラッシュを修正できます。

3. 3

   結果をコピーまたは検証する

   「コピー」をクリックして読みやすいテキストを取得するか、JSONフォーマッターに送って検証します。「方向を切り替え」をクリックするとその場で再エスケープし、ラウンドトリップが元の文字列と一致することを確認できます。

よくあるデコードの落とし穴

value: \q and \x41
// \q and \x hex are not valid JSON escapes -> error

value: \\q and \u0041
// literal backslash doubled; hex written as \u -> decodes

say "hi" there
// interior unescaped " breaks auto-wrapping -> error

say \"hi\" there
// interior quotes escaped -> decodes to: say "hi" there

path: C:\Users\Alice
// \U and \A are invalid escapes -> error

path: C:\\Users\\Alice
// doubled backslashes -> decodes to C:\Users\Alice

よくある使用例

構造化ログフィールドのデコード

JSONログ行から \n と \" だらけのメッセージフィールドをコピーしてアンエスケープし、エスケープシーケンスを目を凝らして見る代わりに、出力されたそのままの本物の複数行メッセージを読みます。

JSON-in-JSONペイロードを読む

エスケープ済み文字列フィールドとして保存された内側のJSONオブジェクトを本物のJSONに戻し、読んだりパーサーに貼り付けたりできます。Webhookエンベロープや監査ログでよく見られます。

ASCIIセーフ出力からUnicodeを復元

レガシーシステムの \uXXXX だらけの出力をアクセント付き文字・CJK文字・絵文字に戻し、純粋なASCIIに強制されたデータの人が読める形を復元します。

コードスニペットの平坦化を戻す

1つのJSON文字列に折りたたまれたスクリプトやクエリ（すべての改行が \n）を、適切に整形された複数行の読みやすいコードに戻します。

二重エンコードされたデータのデバッグ

値が \\n や \\\" のように見えるとき、一度アンエスケープして、上流で誤って2回エスケープされていないか調べ、生成側を修正します。よくある連携バグです。

APIエラーメッセージの検査

多くのAPIは、JSONエンベロープ内のエスケープ済み文字列としてエラー詳細を返します。メッセージをアンエスケープして、エスケープシーケンスの陰に隠れたスタックトレースやネストされたペイロードを読みます。

技術的な詳細

デコードアルゴリズム

ツールは入力をJSON文字列としてパースします。すでに二重引用符で囲まれていればそのままデコードし、そうでなければ生の入力を先に引用符で囲むので、引用符なしのエスケープ済み本文でもデコードできます。認識される各エスケープ（\n \r \t \b \f \" \\ \/ \uXXXX）はその文字にマッピングされます。これは準拠したJSONパーサーを反映しており、シリアライザーでエスケープされた任意の文字列が正確な元の形に戻ることを保証します。

サロゲートペアの再構築

\uXXXX エスケープは1つのUTF-16コード単位を生みます。上位サロゲート（\uD800–\uDBFF）の直後に下位サロゲート（\uDC00–\uDFFF）が続くとき、2つは基本多言語面を超える1つのコードポイントに結合されます。よって \ud83d\ude00 は、壊れた2つの半分ではなく、1つの文字 😀 にデコードされます。

検証とエラー処理

入力に無効なエスケープ（認識されない文字が続くバックスラッシュや、不正な形式の \u シーケンス）や、囲み処理を壊す不均衡な引用符が含まれる場合、デコードはきれいに失敗し、破損した出力を吐き出す代わりにエラーバナーが表示されます。有効な入力は常に正確なデコード済み文字列を生成し、無効な入力が紛らわしい部分的な結果を生むことは決してありません。

ベストプラクティス

引用符あり・なしのどちらでも貼り付け可能

囲み引用符を切り取る時間を無駄にしないでください。ツールは "hello\nworld" と hello\nworld を同一にデコードするので、コピーしたものをそのまま（より大きなドキュメントの途中から取り出した断片を含めて）貼り付けて結果を読めます。

一度アンエスケープし、二重エンコードを確認する

デコード済み出力にまだ \n のようなバックスラッシュシーケンスが見える場合、元は上流で二重エスケープされていました。もう一度アンエスケープして確認し、繰り返しのデコードに頼るのではなく、生成側が1回だけエスケープするよう修正します。

デコード済みJSONを検証する

JSON-in-JSONペイロードをアンエスケープした後、結果を当社のJSONフォーマッターに通して、有効であることを確認し整形します。アンエスケープはテキストを復元し、フォーマッターは構造を確認します。

スワップでラウンドトリップを検証する

「方向を切り替え」をクリックしてデコード済みテキストを再エスケープし、開始時の文字列と一致するか確認します。不一致は、不正な形式の入力や予期しないエスケープを指し示し、問題が伝播する前にデータの問題を表面化させます。

よくある質問