URL: URL() コンストラクター

構文

new URL(url)
new URL(url, base)

引数

url

文字列または文字列化のあるその他のオブジェクトで、絶対またはベース URL に対する相対参照を表します。 url が相対参照である場合、base は必須であり、最終的な URL を解決するために使用されます。 url が絶対 URL である場合、指定された base は結果の URL を作成するためには使用されません。

base 省略可

文字列で、url が相対参照の場合に使用するベース URL を表します。 指定されなかった場合、既定値は undefined です。

base を指定した場合、解決した URL は単に url と base を結合したものではありません。 親ディレクトリーおよびカレントディレクトリーへの相対参照は、base URL の最後のスラッシュまでのパス部分をカレントディレクトリーとした相対で解決されます。ただし、最後のスラッシュ以降は含まれません。 ルートへの相対参照は、ベースを原点とした相対で解決されます。 詳細については、URL への相対参照の解決を参照してください。

例外

TypeError

url（絶対 URL の場合）または base + url（相対 URL の場合）が、有効な URL ではない場合。

例

コンストラクターを使用する例をいくつか示します。

// ベース URL:
let baseUrl = "https://developer.mozilla.org";

let A = new URL("/", baseUrl);
// => 'https://developer.mozilla.org/'

let B = new URL(baseUrl);
// => 'https://developer.mozilla.org/'

new URL("ja/docs", B);
// => 'https://developer.mozilla.org/ja/docs'

let D = new URL("/ja/docs", B);
// => 'https://developer.mozilla.org/ja/docs'

new URL("/ja/docs", D);
// => 'https://developer.mozilla.org/ja/docs'

new URL("/ja/docs", A);
// => 'https://developer.mozilla.org/ja/docs'

new URL("/ja/docs", "https://developer.mozilla.org/fr-FR/toto");
// => 'https://developer.mozilla.org/ja/docs'

こちらは無効な URL の例です。

new URL("/ja/docs", "");
// Raises a TypeError exception as '' is not a valid URL

new URL("/ja/docs");
// Raises a TypeError exception as '/ja/docs' is not a valid URL

// 他の例:

new URL("http://www.example.com");
// => 'http://www.example.com/'

new URL("http://www.example.com", B);
// => 'http://www.example.com/'

new URL("", "https://example.com/?query=1");
// => 'https://example.com/?query=1' （Edge 79 以前はクエリー引数を除去する）

new URL("/a", "https://example.com/?query=1");
// => 'https://example.com/a' (see relative URLs)

new URL("//foo.com", "https://example.com");
// => 'https://foo.com/' (see relative URLs)

仕様書

ブラウザーの互換性

関連情報

• URL.parse(): 例外を発生しないこのコンストラクターの代用
• URL のポリフィル (core-js)
• 所属しているインターフェイス: URL