URLクエリパラメータ解析・生成ツール｜追加・編集・削除

このツールでできること

HTTP・HTTPSのURLまたはクエリ文字列をキーと値の一覧へ分解し、追加、編集、削除、上下移動後に再生成できます。同じキーの複数行、空のキー、空の値も別々のパラメータとして扱い、一覧の順序をそのまま出力へ反映します。

使い方

1. 入力形式から「URL」または「クエリ文字列」を選びます。
2. URLまたはクエリ文字列を入力し、「解析する」を押します。
3. キーと値を編集し、必要に応じて行の追加、削除、上下移動を行います。
4. 「生成する」を押し、結果を確認してコピーします。

自動コピーできない場合は、結果欄から手動でコピーできます。

入力形式または元入力を変更すると一覧と生成結果を消去し、一覧を編集すると古い生成結果とコピー状態を無効にします。「クリア」ではURLモードの初期状態へ戻ります。

入力例・出力例

URLモードで次を解析します。

https://example.com/search?q=tool&page=2#result

一覧にはqがtool、pageが2の2行が表示されます。pageの行を削除し、末尾へキーlang、値jaの行を追加すると、生成結果は次のとおりです。

https://example.com/search?q=tool&lang=ja#result

パスと#resultは維持され、編集した行の順序でクエリが再生成されます。クエリ文字列モードの出力には、先頭の?は付きません。

よくある利用場面

• 長いURLのクエリを一覧で確認し、不要なパラメータだけを削除するとき
• 同名パラメータや空値を残したまま、送信順を入れ替えるとき
• 日本語、空白、+、&等を含むキー・値をURL用に符号化して追加するとき

処理仕様

解析する単位と順序

URLモードは前後の空白を除き、大文字・小文字を問わず正しいhttp://またはhttps://から始まる絶対URLだけを受け付けます。クエリ文字列モードは先頭の?を1文字だけ省略でき、空入力と生の#を受け付けません。値に#を含める場合は%23と入力します。

クエリは&で行へ分け、各行の最初の=だけをキーと値の境界にします。例えばtoken=a=bはキーtoken、値a=bです。同名キー、空キー、空値、入力順は保持され、キーと値の前後空白も自動では削除しません。flagのように=がない項目は空値として解析され、再生成時はflag=になります。連続する&や末尾の&が表す空項目も、空キー・空値の行として解析され、再生成時は=になります。

デコードと再エンコード

解析時は+を空白として扱い、パーセント表記をUTF-8としてデコードします。再生成にはブラウザ標準のURLSearchParamsを使い、空白は+、文字としての+は%2B、キーや値の&、=、#、%はそれぞれパーセント表記になります。日本語や絵文字もUTF-8のパーセント表記へ変換されます。

不正なパーセント表記やUTF-8がある場合は、部分的な一覧を残さずエラーにします。HTMLエンティティの解釈や復元は行いません。値としての&は%26amp%3Bと表現され、文字列の\nや必要なバックスラッシュも改行へ置換せず文字のまま扱います。

再生成、エラー、状態の扱い

URLモードではクエリ以外の構成要素とフラグメントを維持し、全行を削除した場合はクエリのないURLを生成します。ただしブラウザのURL APIにより、スキームやホスト名の大文字・小文字、デフォルトポート、パス、パーセント表記等が意味の等しい形式へ正規化される場合があります。クエリ文字列モードは1行以上が必要で、全行を削除した空結果は生成・コピーできません。空キー・空値の行を1行追加した場合は、1パラメータとして=を生成します。

URLの存在確認や通信確認は行いません。

入力データについて

処理にはVanilla JavaScriptとブラウザ標準のURL API、URLSearchParamsだけを使用し、外部ライブラリは読み込みません。入力したURLやクエリパラメータをToolRollのサーバーや外部サービスへ送信せず、Cookie、Web Storage、IndexedDBへ保存しません。Clipboard APIへ渡すのは「結果をコピー」を押したときの生成結果だけです。