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

アドレスバーやログからコピーした長い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"]]
順番にひも解くと次のとおりです。
protocolとhostnameから、まずプロトコルとホストが取り出されます。pathnameをスラッシュ(/)で分割し、空文字列を取り除きます。先頭のスラッシュが作る空の断片、連続したスラッシュ、末尾のスラッシュが作る空の断片は、ここですべて消えます。- 残った断片に前から 0、1、2 と番号を振ります。そのため上の例は
products(/0)、948213(/1)、reviews(/2)の3つになります。 ?以降のクエリはsearchParamsから別に読み取り、キーと値として扱います。パスの断片の数には含まれません。
最後に、各断片が変数かどうかを判定します。ルールはシンプルです。数字だけで構成されているか、長さが8文字を超える(9文字以上の)場合は変数に置き換え、そうでなければ元の文字列のままにします。上の例では 948213 だけが数字なので変数になり、products・reviews はそのまま残ります。
ぜひ私たちのツールで確認してみてください。
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.js | Next.js App Router |
|---|---|---|---|
users(/0) | 文字列・8文字以下 | users | users |
123(/1) | 数字のみ | :param1 | [param1] |
posts(/2) | 文字列・8文字以下 | posts | posts |
abc(/3) | 文字列・8文字以下 | abc | abc |
そのため、完成するルートは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を貼り付けるだけで、パスセグメント・クエリとExpress・Next.jsのルートパターンがすぐに計算されます。インストール・ログイン不要で無料で利用できます。
よくある質問
クエリパラメータ(? 以降)もパスセグメントとして数えますか?
いいえ。? 以降のクエリはパスではなくクエリ文字列なので、スラッシュで区切るセグメントには含まれません。クエリは searchParams から別に読み取られ、キーと値のテーブルとして表示されます。パスセグメントのインデックス(/0・/1 …)に続けて付くことはありません。
末尾にスラッシュがあると、セグメントのインデックスが1つずれますか?
ずれません。パスをスラッシュで分割したあとに空文字列を取り除くため、末尾のスラッシュや途中の連続したスラッシュが作る空の断片は消えます。そのため /a/b/、/a/b、/a//b はどれもセグメントが同じように取り出されます。
ある断片が変数になり、別の断片はそのままになる基準は何ですか?
2つの条件のうちどちらかに当てはまると変数に置き換わります。セグメントが数字だけで構成されている場合、または長さが8文字を超える(9文字以上の)場合です。この判定は値の意味ではなく、形だけを見ます。条件に当てはまらなくても、変数名の欄に名前を直接入力すればその断片は変数に変わります。
プロトコル(http/https)なしでパスだけ入力してもいいですか?
問題ありません。https:// で始まらない入力には一時的なホストを付けてパースするので、/users/123/posts/abc のようにパスだけを入れてもセグメントが分解されます。標準のパースが失敗する特殊な入力は、? と / で手動分割するフォールバックで処理されます。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む