URLパスセグメントを抽出してルートに変換

公開ツールURLパスセグメントパサー

目次
  1. 長いURLをルートに移すとき、断片を数え間違える問題
  2. ツールを使わずブラウザだけで分解する方法
  3. 結果を読むときによくある誤解
  4. まとめ
  5. よくある質問

アドレスバーやログからコピーした長いURLを1行そのままルートに移すとき、どこまでがパスでどこからがクエリなのか、どの断片が変数になるのか、迷ってしまう方に向けた記事です。結論から言うと、URLの分解はいくつかのルールでぴたりと決まります。

インデックスが付くのはスラッシュで区切られたパスの断片だけであり、? 以降のクエリはパスセグメントとして数えません。そして、セグメントが変数になるかどうかは、決まった1つの条件で判定されます。この記事では、その計算が正確にどう行われるのか、結果をどう読むのかだけを扱います。

まとめ ① URLはプロトコル(https:)・ホスト名(hostname)・パスセグメント・クエリに分かれ、スラッシュで区切ったパスの断片にだけ /0・/1 の順でインデックスが付きます。 ② ? 以降のクエリはパスセグメントとして数えられず、別のキーと値のテーブルに分かれます。連続したスラッシュや末尾のスラッシュが作る空の断片は自動的に取り除かれます。 ③ セグメントが数字だけであるか、9文字以上であれば動的パラメータ(:変数 / [変数])に置き換わり、それ以外は元の文字列のまま残ります。

長いURLをルートに移すとき、断片を数え間違える問題

たとえば https://shop.example.com/products/948213/reviews/?sort=recent のようなURLをルートに移すとします。

ここでつまずきやすいポイントは3つあります。?sort=recent が1つのパスの断片なのか、末尾のスラッシュが空の断片をもう1つ作ってインデックスをずらすのか、そして 948213 のような値だけを変数として捉えるべきなのか、という点です。

この3つを勘で処理すると、ルートが実際のリクエストとずれてしまいがちです。ありがたいことに、この判定はすべて機械的なルールなので、原理さえ分かっていれば毎回同じ答えが出ます。

ツールを使わずブラウザだけで分解する方法

この計算は、ブラウザに組み込まれているURL APIでそのまま再現できます。開発者ツール(F12)のコンソールに以下を貼り付けてください。

const u = new URL("https://shop.example.com/products/948213/reviews/?sort=recent");
u.protocol;                            // "https:"
u.hostname;                            // "shop.example.com"
u.pathname;                            // "/products/948213/reviews/"
u.pathname.split("/").filter(Boolean); // ["products", "948213", "reviews"]
[...u.searchParams];                   // [["sort", "recent"]]

順番にひも解くと次のとおりです。

  1. protocol と hostname から、まずプロトコルとホストが取り出されます。
  2. pathname をスラッシュ(/)で分割し、空文字列を取り除きます。先頭のスラッシュが作る空の断片、連続したスラッシュ、末尾のスラッシュが作る空の断片は、ここですべて消えます。
  3. 残った断片に前から 0、1、2 と番号を振ります。そのため上の例は products(/0)、948213(/1)、reviews(/2)の3つになります。
  4. ? 以降のクエリは searchParams から別に読み取り、キーと値として扱います。パスの断片の数には含まれません。

最後に、各断片が変数かどうかを判定します。ルールはシンプルです。数字だけで構成されているか、長さが8文字を超える(9文字以上の)場合は変数に置き換え、そうでなければ元の文字列のままにします。上の例では 948213 だけが数字なので変数になり、products・reviews はそのまま残ります。

ぜひ私たちのツールで確認してみてください。

URLパスセグメントパサー

URLを貼り付けるだけで、パスセグメント・クエリとExpress・Next.jsのルートパターンがすぐに計算されます。インストール・ログイン不要で無料で利用できます。

結果を読むときによくある誤解

もっとも多い勘違いは、クエリパラメータをパスセグメントとして数えてしまうことです。?sort=recent はセグメントではなくクエリのテーブルに別途入るので、インデックス /2 の次に /3 として続くことはありません。

2つ目は、末尾のスラッシュがインデックスを1つずらすという誤解です。空の断片は取り除かれるため、/reviews と /reviews/ はセグメントの結果が同じになります。

3つ目は「idのような値はすべて変数になる」という期待です。判定が見るのは値の意味ではなく、形(数字かどうか・長さ)だけです。そのため短い文字列のid(abc など)はそのまま残り、必要であれば変数名の欄に名前を直接入力して変数に変えられます。

同じセグメントが2つのフレームワークでどう表記されるかは、ツールの初期例 https://example.com/users/123/posts/abc を基準にすると次のとおりです。

セグメント(インデックス)判定Express.jsNext.js App Router
users(/0)文字列・8文字以下usersusers
123(/1)数字のみ:param1[param1]
posts(/2)文字列・8文字以下postsposts
abc(/3)文字列・8文字以下abcabc

そのため、完成するルートはExpressでは /users/:param1/posts/abc、Next.js App Routerでは app/users/[param1]/posts/abc/page.tsx になります。

デフォルトの変数名はインデックスに応じて param0、param1 のように自動で付きます。名前を変える前は :userId ではなく :param1 と出力され、欄に好きな名前を入力するとその時点で :userId(Express)と [userId](Next.js)にそろって変わります。introduction のように9文字以上の断片は、数字でなくても条件に該当して変数になります。

まとめ

  • URLはプロトコル・ホスト・パス・クエリに分かれ、スラッシュで区切ったパスの断片にだけ /0・/1 のインデックスが付きます。
  • ? 以降のクエリはパスセグメントではなく、別のキーと値として読み取られ、セグメントの数には含まれません。
  • 連続したスラッシュや末尾のスラッシュが作る空の断片は自動的に取り除かれるので、インデックスはずれません。
  • セグメントは数字だけで構成されているか9文字以上のときに変数に置き換わり、それ以外は元の文字列のまま残ります。自分で名前を入力すれば、条件に関係なく変数になります。
  • 同じセグメントは、Expressでは :変数、Next.js App Routerでは [変数] フォルダとして表記されます。
URLパスセグメントパサー

URLを貼り付けるだけで、パスセグメント・クエリとExpress・Next.jsのルートパターンがすぐに計算されます。インストール・ログイン不要で無料で利用できます。

よくある質問

クエリパラメータ(? 以降)もパスセグメントとして数えますか?

いいえ。? 以降のクエリはパスではなくクエリ文字列なので、スラッシュで区切るセグメントには含まれません。クエリは searchParams から別に読み取られ、キーと値のテーブルとして表示されます。パスセグメントのインデックス(/0・/1 …)に続けて付くことはありません。

末尾にスラッシュがあると、セグメントのインデックスが1つずれますか?

ずれません。パスをスラッシュで分割したあとに空文字列を取り除くため、末尾のスラッシュや途中の連続したスラッシュが作る空の断片は消えます。そのため /a/b/、/a/b、/a//b はどれもセグメントが同じように取り出されます。

ある断片が変数になり、別の断片はそのままになる基準は何ですか?

2つの条件のうちどちらかに当てはまると変数に置き換わります。セグメントが数字だけで構成されている場合、または長さが8文字を超える(9文字以上の)場合です。この判定は値の意味ではなく、形だけを見ます。条件に当てはまらなくても、変数名の欄に名前を直接入力すればその断片は変数に変わります。

プロトコル(http/https)なしでパスだけ入力してもいいですか?

問題ありません。https:// で始まらない入力には一時的なホストを付けてパースするので、/users/123/posts/abc のようにパスだけを入れてもセグメントが分解されます。標準のパースが失敗する特殊な入力は、? と / で手動分割するフォールバックで処理されます。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. URLエンコードとは?パーセントエンコーディングと文字化けの仕組みURLにスペースや日本語をそのまま使えない理由と、パーセントエンコーディングの規則、encodeURIとencodeURIComponentが予約文字を扱う違いで結果が変わる仕組みを解説します。
  2. User-Agentヘッダーの構造とモバイル・ボット判定を解説HTTPリクエストのUser-Agentヘッダーを構成する要素と、ブラウザ・端末・クローラーを見分ける正規表現の書き方、Client Hintsの標準仕様を解説します。
  3. CSS Gridのレイアウト設計式とfr単位・レスポンシブCSS Gridで2次元レイアウトを組むときのgrid-template-columns、fr単位の比率計算、grid-template-areasによる設計法と、メディアクエリなしで対応するコツを解説します。
  4. XML JSON変換で配列・属性が変わる理由JSONの配列がXMLで同じタグの繰り返しになり、XMLの属性がJSONで@attributesに分かれる理由を規則で説明します。変換ツールで実際に確認できます。
  5. well-formed XMLとは?HTMLとの違いとエラー確認方法ブラウザはHTMLの閉じ忘れタグを自動で補正しますが、XMLは1つでも規則を外れると文書全体を拒否します。well-formedの規則と理由、構文エラーの確認方法を解説します。
  6. YAMLをJSONに変換する方法|手作業のルールと注意点YAMLの設定値をJavaScriptやAPIリクエストで使うにはJSONが必要です。手で変換する際の3つのルール、つまずきやすい点、ブラウザで確認する方法をまとめました。

関連ツール