【Node.js24.x】URL::URL()関数の使い方
URL関数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
URL関数は、URL（Uniform Resource Locator）文字列を解析し、操作するためのURLオブジェクトを生成する関数です。Webアプリケーションやネットワーク通信において、URLの情報をプログラムで扱いやすくするために使用されます。
この関数を利用することで、与えられたURL文字列をプロトコル（例: http:）、ホスト名（例: www.example.com）、パス名（例: /path/to/resource）、クエリパラメータ（例: ?key=value）などの各要素に分解し、それぞれの部分に簡単にアクセスできるようになります。また、URLの妥当性を検証したり、新しいURLを構成したり、既存のURLのクエリパラメータを動的に追加・変更したりする際にも大変役立ちます。
例えば、HTTPリクエストを送信する際に、ベースURLに動的な検索条件を追加するといった複雑なURL操作を、安全かつ直感的に行えるよう設計されています。これにより、手動でURL文字列を連結する際に発生しがちなエラーを防ぎ、より堅牢なプログラム開発を支援します。Node.jsの環境において、外部のWebリソースにアクセスしたり、Web APIと連携したりするシステムを構築する際には、このURL関数が提供する機能が不可欠となります。
構文(syntax)
1new URL('https://www.example.com/path/to/resource?param=value#anchor');
引数(parameters)
input, base
- input: string | URL: URL の文字列、または既存の URL オブジェクト
- base: string | URL | undefined = undefined: input が相対 URL の場合に使用されるベース URL。指定しない場合は、input が絶対 URL である必要があります
戻り値(return)
URL
URLコンストラクタは、指定されたURL文字列または既存のURLオブジェクトから、新しいURLオブジェクトを生成して返します。このURLオブジェクトは、URLの各構成要素（プロトコル、ホスト、パスなど）にアクセスしたり、URLを操作したりするためのメソッドを提供します。