URL()

この記事は編集レビューを必要としています。ぜひご協力ください

これは実験段階の機能です。
この機能は複数のブラウザーで開発中の状態にあります。互換性テーブルをチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザーの将来のバージョンで変更になる可能性があることに注意してください。

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

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

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

構文

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

引数

urlString
絶対、または相対 URL を表す DOMStringurlString が相対 URL だった場合、baseURLstringbaseURLobject のいずれか存在する方がベース URL として使用されます。urlString が絶対 URL だった場合、baseURLstringbaseURLobject は無視されます。
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
URL.URL() の定義
現行の標準 初期定義。

ブラウザー実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) 26.0 (26.0) 未サポート (有) (有)
機能 Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート ? 26.0 (26.0) 未サポート ? (有)

関連項目

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

 

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

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