URL()

URL() コンストラクターは、パラメーターによって定義された URL を表す、新しく生成された URL オブジェクトを返します。

与えられたベース URL または結果の URL が有効な URL でない場合、JavaScript の TypeError 例外がスローされます。

注: この機能は Web Worker 内で利用可能です

構文

url = new URL(url, [base])

パラメーター

url: 絶対 URL または相対 URL を表す USVString。url が相対 URL の場合、base は必須であり、ベース URL として使用されます。url が絶対 URL の場合、指定された base は無視されます。
base 省略可: url が相対 URL の場合に使用するベース URL を表す USVString。指定しない場合のデフォルトは '' です。

メモ: 既存の URL オブジェクトを base に使用することも可能で、オブジェクトの href プロパティにそれ自体を文字列化します。

例外

例外	説明
`TypeError`	`url` (絶対 URL の場合) または `base` + `url` (相対 URL の場合) が、有効な URL ではありません。

例

// ベース URL
var m = 'https://developer.mozilla.org';
var a = new URL("/", m);                                // => 'https://developer.mozilla.org/'
var b = new URL(m);                                     // => 'https://developer.mozilla.org/'

        new URL('en-US/docs', b);                      // => 'https://developer.mozilla.org/en-US/docs'
var d = new URL('/en-US/docs', b);                     // => 'https://developer.mozilla.org/en-US/docs'
        new URL('/en-US/docs', d);                     // => 'https://developer.mozilla.org/en-US/docs'
        new URL('/en-US/docs', a);                     // => 'https://developer.mozilla.org/en-US/docs'

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

        new URL('/en-US/docs', '');                    // '' は有効な URL ではないため、TypeError 例外が発生します
        new URL('/en-US/docs');                        // '/en-US/docs' は有効な URL ではないため、TypeError 例外が発生します
        new URL('http://www.example.com', );           // => 'http://www.example.com/'
        new URL('http://www.example.com', b);          // => 'http://www.example.com/'

        new URL("//foo.com", "https://example.com")    // => 'https://foo.com' (相対 URL を参照)

仕様

Specification
URL Standard # constructors

ブラウザーの互換性

BCD tables only load in the browser

構文

パラメーター

例外

例

仕様

ブラウザーの互換性

関連項目