SYNCERのロゴ
アイキャッチ画像

URL - URLアドレス

URLは、URLアドレスの情報を管理するための機能を備えたインターフェイスです。

概要

名前
URL
IDL
[Constructor(USVString url, optional USVString base),
 Exposed=(Window,Worker),
 LegacyWindowAlias=webkitURL]
interface URL {
  stringifier attribute USVString href;
  readonly attribute USVString origin;
  attribute USVString protocol;
  attribute USVString username;
  attribute USVString password;
  attribute USVString host;
  attribute USVString hostname;
  attribute USVString port;
  attribute USVString pathname;
  attribute USVString search;
  [SameObject] readonly attribute URLSearchParams searchParams;
  attribute USVString hash;

  USVString toJSON();
};
// File API
[Exposed=(Window,DedicatedWorker,SharedWorker)]
partial interface URL {
  static DOMString createObjectURL(Blob blob);
  static void revokeObjectURL(DOMString url);
};
仕様書
https://url.spec.whatwg.org/#url
https://w3c.github.io/FileAPI/#creating-revoking (File API)

チュートリアル

URLは、コンストラクタで作成できます。引数にはURLを文字列で指定して下さい。

var url = new URL( "https://syncer.jp/page.html?hoge=1&fuga=2" ) ;

url.hostname ;	// "syncer.jp"
url.href ;	// "https://syncer.jp/page.html?hoge=1&fuga=2"
url.origin ;	// "https://syncer.jp"
url.searchParams ;	// URLSearchParams

第1引数に相対URLを指定する場合は、第2引数にはベースとなるURLを指定します。

var url = new URL( "./hoge/", "https://syncer.jp/page.html" ) ;

url.href ;	// "https://syncer.jp/hoge/"

コンストラクタ

URL()

新しいURLのオブジェクトを作成します。

プロパティ

hash

オブジェクトのハッシュを返します。

host

オブジェクトのホスト名とポート番号を返します。

hostname

オブジェクトのホスト名を返します。

href

オブジェクトの完全なアドレスを返します。

origin

オブジェクトのオリジンを返します。

password

オブジェクトのパスワードを返します。

pathname

オブジェクトのパス名を返します。

port

オブジェクトのポート番号を返します。

protocol

オブジェクトのプロトコルを返します。

オブジェクトのクエリを文字列で返します。

searchParams

オブジェクトのクエリのパラメータをURLSearchParamsで返します。

username

オブジェクトのユーザーネームを返します。

メソッド

createObjectURL()

BlobFileを参照するための一時的なURLを作成します。

revokeObjectURL()

createObjectURL()で作成したオブジェクトのURLを削除します。

toJSON()

URLアドレスの内容をJSONフォーマットのObjectに変換します。

定数

固有の定数はありません。

イベント

固有のイベントハンドラはありません。

サポート状況

クリックすると、バージョンごとの対応状況を確認できます。

FeaturesChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
URL 23+ 7.1+ 10+ 15+ 8.3+ 4.4+
createObjectURL() 6.0+ 10+ 15+ 6.0+ 4.0+
hash 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
host 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
hostname 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
href 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
origin 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
password 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
pathname 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
port 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
protocol 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
revokeObjectURL() 6.0+ 10+ 15+ 6.0+ 4.0+
search 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
searchParams 51+ 29+ 10+×× 38+ 10.0+×
toJSON()× 54+ 11.0+××× 11.0+×
URL() 23+ 26+ 7.1+× 26+ 7.0+×
username 25+ 26+ 7.1+× 19+ 8.3+ 4.4+
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月20日 (金)
コンテンツを公開しました。