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

与えられたベース URL 、または結果の URL が有効な URL ではない場合、SYNTAX_ERROR 型の DOMException がスローされます。

註: この機能は Web Workers 内で利用可能です。

構文

url = new URL(url, [base])

引数

url
絶対、または相対 URL を表す USVStringurl が相対 URL だった場合、base が必須であり、ベース URL として使用されます。url が絶対 URL だった場合、base は無視されます。
base Optional
url が相対 URL だった場合に使用するベース URL を表す USVString 。指定しない場合、既定値は '' となる。

注記: 既存の URLbase に使用することは可能であり、それ自体を文字列化してオブジェクトの href 属性にします。

例外

例外 説明
TypeError url (絶対 URL である場合) または base + url (相対 URL である場合) が、有効な URL ではない。

var a = new URL("/", "https://developer.mozilla.org"); // Creates a URL pointing to 'https://developer.mozilla.org/'
var b = new URL("https://developer.mozilla.org");      // Creates a URL pointing to 'https://developer.mozilla.org/'
var c = new URL('en-US/docs', b);                      // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
var d = new URL('/en-US/docs', b);                     // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
var f = new URL('/en-US/docs', d);                     // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
var g = new URL('/en-US/docs', "https://developer.mozilla.org/fr-FR/toto");
                                                       // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
var h = new URL('/en-US/docs', a);                     // Creates a URL pointing to 'https://developer.mozilla.org/en-US/docs'
var i = new URL('/en-US/docs', '');                    // Raises a TypeError exception as '' is not a valid URL
var j = new URL('/en-US/docs');                        // Raises a TypeError exception as '/en-US/docs' is not a valid URL
var k = new URL('http://www.example.com', 'https://developers.mozilla.com');
                                                       // Creates a URL pointing to 'http://www.example.com/'
var l = new URL('http://www.example.com', b);          // Creates a URL pointing to 'http://www.example.com/'

仕様

仕様 ステータス コメント
URL
URL.URL() の定義
現行の標準 初期定義。

ブラウザー実装状況

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応 あり1226 なし あり あり
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応 ? ? ? ? ? ? ?

関連項目

  • 所属しているインターフェース: URL

ドキュメントのタグと貢献者

このページの貢献者: yyss, dlwe, YuichiNukiyama
最終更新者: yyss,