【Node.js24.x】Object::URL()メソッドの使い方
URLメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
URLメソッドは、ウェブアドレス（URL）を解析し、構造化されたURLオブジェクトを生成するメソッドです。このメソッドは、WHATWG URL標準に準拠しており、Node.jsのグローバルスコープ、またはurlモジュールを通じて利用できます。具体的には、new URL(input, base)のような形式で呼び出すことで、与えられたURL文字列（input）を解析し、必要に応じて基準URL（base）を適用して、新しいURLオブジェクトを作成します。
生成されたURLオブジェクトは、protocol、hostname、port、pathname、search、hashといったURLの各構成要素を個別のプロパティとして保持しています。これにより、複雑なURLの文字列操作を手動で行うことなく、安全かつプログラム的にURLの各部分にアクセスしたり、変更したりすることが可能になります。例えば、クエリパラメータの追加や削除はsearchParamsプロパティを通じて直感的に行えます。また、hrefプロパティを使えば、完全なURL文字列を簡単に再構築できます。この機能は、Webアプリケーション開発やネットワーク関連の処理において、URLの取り扱いを標準化し、堅牢なシステムを構築するために不可欠な要素です。
構文(syntax)
1const myUrl = new URL('https://example.com/path?query=value#hash'); 2console.log(myUrl.href);
引数(parameters)
input, base = undefined
- input: string | URL | URLSearchParams | null | undefined: 解析するURL、またはURLに変換できるオブジェクト
- base: string | URL | URLSearchParams | null | undefined = undefined: inputが相対URLの場合のベースURL
戻り値(return)
戻り値なし
戻り値はありません