URL()

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

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

構文

url = new URL(urlString, [baseURLstring])
url = new URL(urlString, baseURLobject)

引数

urlString

絶対、または相対 URL を表す DOMString。urlString が相対 URL だった場合、baseURLstring か baseURLobject のいずれか存在する方がベース URL として使用されます。urlString が絶対 URL だった場合、baseURLstring と baseURLobject は無視されます。

baseURLstring Optional

urlString が相対 URL だった場合に使用するベース URL を表す DOMString。指定せず、引数として baseURLobject も渡されなかった場合、既定値は 'about:blank' となる。無効な絶対 URL だった場合、コンストラクターは SYNTAX_ERROR 型の DOMException をスローする。

baseURLobject

urlString が相対 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 SYNTAX ERROR exception as '/en-US/docs' is not valid
var j = new URL('/en-US/docs');                        // Raises a SYNTAX ERROR exception as 'about:blank/en-US/docs' is not valid
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。