コード整形 / MULTIVERTO

JSON をクエリ文字列に変換

URL クエリパラメータとして平坦な JSON オブジェクトを書きます。

変換ツール入力内容はこのブラウザ内にとどまり、変換のために送信されません。

ファイルはブラウザー内にとどまります。
ツールを連結

前の結果に各テキストツールを適用します。 テキスト変換ワークフロー ↗

このブラウザーには手順の名前とツールの順序だけを保存します。入力内容と結果は保存しません。

01 / 例

例

入力{"namae":"こんにちは","messeji":["ようこそ","こんにちは"]}
結果namae=%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF&messeji=%E3%82%88%E3%81%86%E3%81%93%E3%81%9D&messeji=%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF

02 / ガイド

JSON をクエリ文字列に変換 — 仕組み

変換の仕組み

URL クエリパラメータとして平坦な JSON オブジェクトを書きます。 URLSearchParams エンコーディングを使ってスカラーフィールドと配列項目を追加します。

具体的な変換例

入力例は {"name":"Hello","message":["Welcome","Hello"]} で、変換結果は name=Hello&message=Welcome&message=Hello です。結果を使う前に、区切り文字、フィールド名、値の型がどう変わったか確認してください。JSON からクエリ文字列への変換では、ファイルやリクエスト全体を変換する前に、小さなレコードを受け取り側のパーサーで確認してください。平坦な JSON オブジェクトを URL のクエリパラメータとして書き出します。

フォーマット規則と制限

クエリ文字列内のすべてはテキストです。JSON の数値を書き出しても戻すと文字列になるため、往復変換では JSON の型が保たれません。null、入れ子のオブジェクト、空配列には曖昧さのない表現がなく、拒否されます。エンコード済みのアンパサンドは値に属し、文字どおりのアンパサンドはパラメーターを区切ります。区切りを解析してからデコードし、エンコード済みの結果を再度エンコードしないでください。既存の URL パスにクエリを付ける前に、平坦な JSON レコードからフォーム形式のパラメーターを作ります。元データは平坦な JSON オブジェクトでなければなりません。各文字列、数値、真偽値がテキストのパラメーター値となり、空でない配列では項目ごとに同じ名前を出力します。null、入れ子のオブジェクト、空配列はこの対応付けで明確に表せないため拒否します。URLSearchParams がエスケープを扱い、空白は +、値の中の区切り記号はエンコードされる場合があります。結果は ? より後ろの部分だけです。意図的にパスへ付け、統合時には既存のクエリパラメーターも保持してください。

結果を確認

空白、アンパサンド、非 ASCII 文字を含む値でクエリパラメーターを試してください。生成文字列を再解析し、繰り返しキーが配列のままか確認します。クエリ文字列では JSON の数値型や真偽値型を保てないため、文字列としての値を比較してください。完全な URL が必要なら、クエリ専用の入力欄に URL 全体を貼らず、生成したクエリをパスの後に付けます。繰り返しキーになる配列と、空白またはアンパサンドを含む値を用意します。結果を再解析し、数値型や Boolean 型が残るとは期待しないでください。元データと結果は見た目が似ていても役割が異なります。上記の方法が定義するのは対応する範囲であり、その形式名のあらゆる拡張ではありません。厳格な受け取り側に渡すなら、多くの記録を変える前に小さな既知の例を試してください。検証に失敗した場合は元の入力と最初に報告されたエラーに戻ります。生成結果だけを編集すると原因が隠れることがあります。

入力から出力への変換過程
JSON 入力
構造を読み込み変換
クエリ文字列

ガイドを探す

変換ガイド

ガイドを探す