JSON文字列エスケープ

JSONエスケープとは？

// Input text
She said "hi"
then left.

// Escaped (Wrap on) — identical to JSON.stringify(input)
"She said \"hi\"\nthen left."

// Escaped (Wrap off) — just the body, for hand-built JSON
She said \"hi\"\nthen left.

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

主な機能

例

{"event":"signup","user":{"id":42,"name":"Alice"}}

function greet(name) {
  return `Hello, ${name}!`;
}

She said "hello"	then left.

Price: 9.99€ — café société

使い方

1. 1

   テキストまたはJSONを貼り付ける

   入力欄に何でも入力または貼り付けます。JSONオブジェクト、コードスニペット、ログ行、普通のテキストなど。エスケープ済みの結果が即座に表示されます。「例を読み込む」をクリックすると、JSON-in-JSONペイロードや複数行関数などのサンプルを試せます。

2. 2

   エスケープオプションを選ぶ

   完全なJSON文字列リテラル（JSON.stringify と同じ）が欲しいときは「二重引用符で囲む」をオンに、エスケープ済み本文だけが欲しいときはオフにします。純粋なASCIIの \uXXXX 出力には「非ASCIIをエスケープ」を、HTMLの <script> タグ内にJSONをインライン化するときは「スラッシュをエスケープ」を切り替えます。

3. 3

   エスケープ済み文字列をコピーする

   「コピー」をクリックすると結果が取得でき、JSONドキュメント・RESTリクエストボディ・設定ファイルにそのまま貼り付けられます。「方向を切り替え」をクリックするとアンエスケープモードに反転し、無損失のラウンドトリップを検証できます。

よくあるエスケープの落とし穴

Input already escaped: line1\nline2
Escaped again -> line1\\nline2  (literal backslash-n)

Raw input: line1
line2
Escaped once -> line1\nline2  (real newline encoded)

{"msg": hello \"world\"}
// Missing quotes around the value -> invalid JSON

{"msg": "hello \"world\""}
// Wrap on supplies the quotes -> valid JSON

café  ->  caf\u00e9   (no downstream need; just noise)

café  ->  café         (valid JSON, readable, smaller)

よくある使用例

JSON-in-JSONのWebhookペイロード

リクエストボディをエスケープして、Webhookエンベロープ・Kafkaメッセージ・監査ログ内の文字列フィールドとして保存できるようにします。「Wrap」をオンにしておけば、外側のドキュメントのキーにそのまま代入できる出力になります。

設定内の複数行スニペット

複数行のシェルスクリプト・SQLクエリ・コードスニペットを1つのJSON文字列値に変換します。すべての改行が \n になるので、JSON設定ファイルは1行でも有効なまま保たれます。

手書きのRESTリクエストボディ

JSON文字列をエスケープしてから curl --data 引数やHTTPクライアントに渡すので、引用符や改行がシェルと通信路を生き延び、リクエストが壊れません。

ログセーフな文字列エンコード

ユーザー提供のコンテンツを構造化ログ行に書き込む前にエスケープし、注入された引用符や改行がログ形式や下流のJSONログパーサーを破損させるのを防ぎます。

ASCII限定のレガシー連携

SOAPゲートウェイ・メールヘッダー・転送中にUTF-8を壊す古いシステム向けに純粋なASCIIの \uXXXX 出力を生成しつつ、あらゆる現代のJSONパーサーで完全にデコード可能なまま保ちます。

HTMLへのJSONインライン化

スラッシュをエスケープして、サーバーレンダリングページの <script> タグ内にJSONブロブを直接埋め込めるようにします。データ内の </script> がタグを早く閉じることはありません。

技術的な詳細

エスケープアルゴリズム

このツールは、JSON仕様の文字列規則で入力をシリアライズします。U+0022 (") → \"、U+005C (\) → \\、U+0008 → \b、U+000C → \f、U+000A → \n、U+000D → \r、U+0009 → \t、そしてその他の U+0020 未満の文字 → \u00XX です。「Wrap」オンで囲みの二重引用符が含まれ、オフで取り除かれます。これは準拠したシリアライザーの出力と正確に一致し、無損失のラウンドトリップを保証します。

Unicodeとサロゲートペア

デフォルトでは、U+007F を超える文字はリテラルなUTF-8として出力され、これはJSONが許可します。「非ASCIIをエスケープ」オンにすると、そのような各文字がUTF-16コード単位を使って \uXXXX に変換されます。基本多言語面の外の文字（絵文字、希少な文字体系）は2つの \uXXXX エスケープのサロゲートペアとしてエンコードされます。たとえば 😀 (U+1F600) は \ud83d\ude00 になり、これはJSONシリアライザーが生成するのと同じ表現です。

スラッシュとHTMLコンテキスト

JSONは / のエスケープを要求しないため、デフォルトでは保持されます。「スラッシュをエスケープ」が有効なとき、すべての / が \/ になります。これを行う唯一の実用的な理由はHTML埋め込みです。<script> タグ内では、リテラルの部分文字列 </script> がJSONコンテキストに関係なくタグを閉じてしまうため、スラッシュを <\/script> にエスケープすると、インライン化されたJSONを保ちつつ仕様にも準拠したままになります。

ベストプラクティス

完全なリテラルには Wrap をオンに保つ

コードで代入する値や、JSONでコロンの後に貼り付ける値が必要なときは「二重引用符で囲む」をオンに保ちます。出力は JSON.stringify と同一の、完全でパース可能なJSON文字列です。囲み引用符を自分で手入力する場合のみオフにします。

必要でない限りUnicodeエスケープはオフに

生のUTF-8は有効なJSONであり、はるかに読みやすいです。「非ASCIIをエスケープ」は、UTF-8を正しく扱えない特定の下流システム（レガシーSOAP、一部のログパイプライン、ASCII限定のソースファイル）のためだけに有効にします。デフォルトですべてをエスケープすると、出力が騒がしくなるだけです。

スラッシュはHTML埋め込みのときだけエスケープ

スラッシュエスケープが意味を持つのはちょうど1か所、HTMLの <script> タグにインライン化されたJSONです。その文脈の外では利点なしに雑然とするだけなので、RESTボディ・設定ファイル・メッセージペイロードではオフにしておきます。

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

エスケープ済みデータをパイプラインに出荷する前に、「方向を切り替え」をクリックしてアンエスケープし、元のテキストが戻ることを確認します。これにより、意図せぬ二重エスケープ（\n のつもりが \\n になる頻出の原因）を検出できます。逆変換はいつでも当社のJSONアンエスケープツールで行えます。

よくある質問