【Node.js24.x】Object::Url()メソッドの使い方
Urlメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Urlメソッドは、Objectクラスに所属し、Node.js環境においてURL（Uniform Resource Locator）に関するさまざまな操作を実行するメソッドです。このメソッドは、主に文字列形式で与えられたURLを解析し、その構成要素（プロトコル、ホスト名、パス、クエリパラメータ、フラグメントなど）を個別のプロパティとして持つ構造化されたオブジェクト形式に変換する機能を提供します。これにより、開発者はURLの各部分にプログラムから簡単にアクセスし、必要な情報を抽出したり、あるいは特定の要素を変更して新しいURLを再構築したりすることが可能になります。
Webアプリケーション開発において、HTTPリクエストで送られてきたURLのパスやクエリパラメータを解析してビジネスロジックに利用したり、外部のRESTful APIエンドポイントURLを動的に生成してサービス間連携を行ったりする際に非常に有用です。また、URLのエンコードやデコードといった処理をサポートすることで、URLが含む特殊文字や日本語文字などを安全に扱えるようにします。Urlメソッドは、URLの複雑な構文を開発者が直接意識することなく、より堅牢で保守しやすいネットワーク関連処理を実装するための強力なツールとなります。
構文(syntax)
1new URL('https://example.com/path/to/resource?param=value#section');
引数(parameters)
input, base = undefined
- input: string | URL | URLSearchParams | Record<string, string | string[]> | null | undefined: URLを文字列、URLオブジェクト、URLSearchParamsオブジェクト、またはキーと値のペアのオブジェクトとして指定します。nullまたはundefinedを指定することもできます。
- base: string | URL | null | undefined = undefined: 相対URLを指定した場合の基準となるURLを指定します。文字列、URLオブジェクト、またはnull/undefinedを指定できます。デフォルトはundefinedです。
戻り値(return)
URL
URL オブジェクトを返します。このオブジェクトは、URL の各構成要素（プロトコル、ホスト、パスなど）にアクセスできるプロパティを提供します。