手動の正規表現や単純な split('/') による文字列分割は、Basic認証情報、明示的なポート番号、パーセントエンコードされたスラッシュ(%2F)、.co.jp や .co.uk のような複数階層を持つパブリックサフィックス(Public Suffix)、あるいはハッシュフラグメント内に含まれる疑問符(?)に遭遇すると頻繁に破綻します。仕様に準拠したパーサーは、個々のコンポーネントをデコードする前に、厳密な構文順序に従ってデリミタをスキャンします。
認証情報、複数階層のサブドメイン、非デフォルトのTLSポート、エンコードされたパスセグメント、クエリパラメータ、およびフラグメントアンカーを含む複雑なWebhook配信URLの例を見てみましょう。
https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
このURIを分解すると、個別に編集可能な以下のプロパティが抽出されます。
{
"href": "https://deploy:tok_9f8a@staging.api.example.co.uk:8443/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log",
"protocol": "https:",
"scheme": "https",
"username": "deploy",
"password": "tok_9f8a",
"origin": "https://staging.api.example.co.uk:8443",
"host": "staging.api.example.co.uk:8443",
"hostname": "staging.api.example.co.uk",
"subdomain": "staging.api",
"domain": "example.co.uk",
"tld": "co.uk",
"port": "8443",
"pathname": "/v2/orgs/acme%20corp/webhooks",
"pathSegments": ["v2", "orgs", "acme corp", "webhooks"],
"search": "?event=push&active=true",
"queryParams": {
"event": "push",
"active": "true"
},
"hash": "#delivery-log"
}
エスケープを壊さずに構成要素を変更する
複数の環境をまたいでデバッグを行う際、パスのエンコード状態や署名付きクエリペイロードを正確に保持したまま、キャプチャした本番環境やステージング環境のコールバックURLをローカルのサーバーに向け直したいケースがよくあります。scheme を http、hostname を localhost、port を 3000 に変更し、username と password をクリアすると、以下のようにクリーンに再構築されます。
http://localhost:3000/v2/orgs/acme%20corp/webhooks?event=push&active=true#delivery-log
3番目のパスセグメント(acme corp)は pathname 内で自動的に %20 のパーセントエンコーディングを維持するため、HTTPリクエストラインやMarkdownログにおける空白文字での意図しない切断を防ぎます。