【Node.js24.x】Object::URLPattern()メソッドの使い方

URLPatternメソッドは、URLの構造をパターンとして定義し、指定されたURLがそのパターンに合致するかどうかを検証したり、パターンから特定の情報を抽出したりするメソッドです。

このメソッドは、Webアプリケーションにおけるルーティング処理や、APIリクエストのURL解析を効率的かつ堅牢に行うために設計されています。具体的には、URLのプロトコル、ホスト、ポート、パス名、検索パラメータ、ハッシュといった様々な要素に対して、柔軟なパターン定義をサポートしています。

定義されたパターンを用いて、与えられたURLがその構造に完全に適合するかを判定することが可能です。さらに、パターン内で名前付きのグループ（例: /users/:id の :id）を設定することで、実際に受け取ったURLから、そのグループに対応する値を簡単に抽出できます。例えば、/products/12345 というURLを /products/:productId というパターンで処理し、productId の値として 12345 を取得するといった動的な情報取得が容易になります。

URLPatternメソッドを利用することで、複雑な正規表現を直接記述する手間を省き、URLベースのルーティング設定の可読性とメンテナンス性を向上させることができます。Node.jsでWebサービスやAPIを開発するシステムエンジニアにとって、リクエストの振り分けやURLパラメータの効率的な処理を実現するための強力なツールとなるでしょう。

Copy
1const pattern = new URLPattern({ pathname: '/users/:id', hostname: 'example.com' });
2const url = 'https://example.com/users/123';
3const match = pattern.test(url);
4console.log(match);

input

• input: string | URLPattern | URL: パターンマッチングを行う対象のURLまたはURL文字列、あるいはURLPatternオブジェクト

URLPattern

URLPatternコンストラクタは、指定されたパターン文字列からURLPatternオブジェクトを生成して返します。このオブジェクトは、URLの構造を定義し、マッチングを行うための基盤となります。