クエリ文字列 Parser

クエリ文字列 URL 内にあります ? 次の部分はサーバーへ parameter を渡すために使われ、1 個以上の要素で構成されます。 key=value 複数のパラメーター間で組み合わせて使用 & 分離。

例：
https://example.com/search?q=hello&page=2&sort=desc

Query String は q=hello&page=2&sort=desc, 3 つのパラメーターを含みます：q（検索キーワード）、ページ（ページ番号）、並べ替え（並べ替え）。

Query String は HTTP GET request で最も一般的なパラメータ受け渡し方法で、検索、filter、pagination、tracking など幅広い用途で使われます。

GET リクエスト parameter を URL の Query String（?key=value）、利点は次のとおり：
• bookmark を追加し、URL を直接 share できます。
• ブラウザーでキャッシュ可能
• search、navigation など side effect のない操作に適しています。

POST リクエスト HTTP Request Body へ parameter を置く主な利点は次のとおりです。
• parameter は URL に表示されないため、より安全です。
• 大量の data を転送できます（length limit なし）。
• 複数の Content-Type（JSON、Form、Multipart）に対応します。
• login や form submission など、副作用を伴う操作に適しています。

実用的な提案： 検索・読み取り操作には GET、新規作成や変更・削除には POST（または PUT / DELETE）を使用します。機密情報を扱う場合は、HTTPS を必ず使用し、URL へ露出しない方法を選んでください。

URL Encode（Percent-Encoding とも呼ばれます） URL 内の特殊文字を % さらに 2 桁の 16 進コード方式を使用します。

なぜエンコードが必要なのでしょうか。URL 内の一部の文字には特別な意味：
• ? → Query String を開始
• & → パラメーターを分離
• = → Key と Value を分離
• # → Fragment を開始
• スペース → URL では使用不可

parameter value にこれらの文字が含まれる場合は、encode が必要です：
• "hello world" → hello%20world
• "100% done" → 100%25%20done
• "a&b=1" → a%26b%3D1

JavaScript で利用可能 encodeURIComponent() および decodeURIComponent() エンコードとデコード。

Query Parameter を設計する際の主な推奨事項は次のとおりです。

1. 一貫した命名規則を使用します
camelCase を推奨（sortBy) または snake_case(sort_by）、どちらかを選び、統一して使用してください。

2. パラメーター名は内容が分かる名前にします
✅ sortOrder=desc ❌ s=d

3. 長すぎる URL を避けます
browser の URL length には制限（およそ 2,000～8,000 文字）があり、Query Parameter が多すぎると request に失敗する場合があります。

4. 機密情報を送信しない
Query String はブラウザー履歴、サーバーログ、Referer Header に残る場合があります。パスワードや token などの機密情報を Query String に入れないでください。

5. URL Encode の特殊文字
parameter value 内の特殊文字が正しく encode されていることを確認し、parsing error を避けてください。

6. 配列形式の使用を検討
複数値パラメーターには次を使用します key[]=val1&key[]=val2 または key=val1,val2 明確な形式を待っています。

はい、URL には長さ制限があります。 ただし、この制限は HTTP プロトコル自体によるものではありません。RFC では URL の最大長を規定しておらず、実際にはブラウザーやサーバー側の実装上の制限によって決まります：

• Internet Explorer: 約2,048文字（最も厳しい制限）
• Chrome: 約64,000文字
• Firefox: 約64,000文字
• Safari: 約64,000文字
• Apache/Nginx サーバー：デフォルトは約 8,000 文字です

実用的な提案： 最大限の互換性を確保するため、URL length は次の範囲に収めることをおすすめします。 2,000文字 以内です。大量のデータを送信する必要がある場合は POST リクエストを使い、データを Request Body に入れてください。

Query String は本質的には平坦な key-value 構造ですが、命名規則を使って array や nested object を擬似的に表現できます。

配列形式（一般的な記法多数）：
• tag=tech&tag=dev — Duplicate Key（最も一般的）
• tag[]=tech&tag[]=dev — PHP スタイル
• tag=tech,dev — カンマ区切り

ネストされたオブジェクト（一般的な方法）:
• filter[category]=books&filter[price]=10-20 — PHP/Rails スタイル
• filter.category=books&filter.price=10-20 — ドット区切り

ネストした Query String の解釈方法はバックエンドフレームワークごとに異なります。このツールは一般的なフラットな Key / Value として解析します。ネスト構造を扱う必要がある場合は、JSON 形式で受け渡すことを推奨します。

まったくありません。このツールは純フロントエンドアプリケーション、Query String の解析、編集、エンコード、デコード、形式変換はすべてブラウザー内でローカル処理され、データがサーバーへ送信されることはありません。オフラインでも動作します。