【Node.js24.x】Object::URL()メソッドの使い方
URLメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
URLメソッドは、ウェブアドレス（URL）を解析し、その構成要素（プロトコル、ホスト、パスなど）にアクセスしたり、新しいURLを構築したりするための機能を提供するメソッドです。このメソッドは、Node.jsの組み込み（builtin）機能として提供され、Objectクラスに属するとされています。しかし、一般的にはnew URL()のようにコンストラクタとして呼び出すことで、URLを表すオブジェクトの新しいインスタンスを生成します。
生成されたURLオブジェクトは、URLの各部分をプロパティとして持ち、例えばurl.hostnameでホスト名を取得したり、url.pathnameでパス名を取得したりできます。また、url.hrefプロパティからは完全なURL文字列を取得することも可能です。この機能は、複雑なURLの操作を簡単に行えるように設計されており、システム開発において外部リソースへのアクセスやAPIリクエストのURL構築などで頻繁に利用されます。URLメソッドを使用することで、URLの文字列操作を自前で行うよりも安全で効率的なコードを書くことができます。
構文(syntax)
1const myUrl = new URL('https://www.example.com/path/to/resource?query=value#fragment');
引数(parameters)
url, base = undefined
- url: string: 解析するURL文字列
- base: string | URL | null = undefined: URLのベースとなるURL文字列またはURLオブジェクト。省略された場合は、urlが相対パスとして解釈されます。
戻り値(return)
URL
URL クラスのコンストラクタです。URL オブジェクトを生成します。