ガイド
URL ParserとQuery Parserの使い分け
URL Parser は URL 全体の構造把握向き、Query Parser はパラメータ内容の確認向きです。見る対象を分けるとデバッグが速くなります。
データ整形読了目安 4 分
URL解析 - 構成要素を確認クエリ解析 - URLをJSON化URLエンコード - 変換
これは何か
URL Parser は URL 全体の構造把握向き、Query Parser はパラメータ内容の確認向きです。見る対象を分けるとデバッグが速くなります。
どんな時に使うか
- - ホスト名・パス・ハッシュまで含めて確認したい時。
- - クエリパラメータの値や重複キーだけを精査したい時。
- - リダイレクトURLの不具合を段階的に切り分けたい時。
よくある勘違い
- - どちらか一方だけで常に十分とは限りません。
- - Query Parser は URL 全体の妥当性チェックを代替しません。
- - URL Parser で値のデコード確認まで完結するとは限りません。
すぐ試す方法
- まず URL Parser で全体構造を確認します。
- 次に Query Parser へクエリを渡して値を確認します。
- 必要なら URL エンコード/デコードで個別値を検証します。
- 修正後の URL をもう一度両方で確認します。
例
入力例
https://example.com/search?q=cuvel%20tools&tag=web&tag=nuxt#top
出力例
URL Parser: host=example.com, path=/search
Query Parser: {"q":"cuvel tools","tag":["web","nuxt"]}注意点
- - 全体構造とパラメータ内容は別々に確認する方が早いです。
- - 重複キーは配列扱いになる想定で確認してください。
- - 値の異常はエンコード状態が原因のことが多いです。
よくある質問
最初にどちらを使うべきですか?
URL全体が怪しい時は URL Parser、値が怪しい時は Query Parser から始めるのが効率的です。
フルURLを Query Parser に入れても大丈夫ですか?
はい。対応していますが、構造確認は URL Parser 併用が確実です。
壊れたURLの切り分け手順は?
全体構造→クエリ内容→個別値のエンコード確認の順で見ると詰まりにくいです。