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
オブジェクトのプロトコルを返します。
search
オブジェクトのクエリを文字列で返します。
searchParams
オブジェクトのクエリのパラメータをURLSearchParamsで返します。
username
オブジェクトのユーザーネームを返します。
メソッド
createObjectURL()
Blob、Fileを参照するための一時的なURLを作成します。
revokeObjectURL()
createObjectURL()で作成したオブジェクトのURLを削除します。
toJSON()
URLアドレスの内容をJSONフォーマットのObjectに変換します。
定数
固有の定数はありません。
イベント
固有のイベントハンドラはありません。
サポート状況
クリックすると、バージョンごとの対応状況を確認できます。
Features | Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|---|
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+ |
関連記事
- URL.hostname
- hostnameは、URLのプロパティです。オブジェクトのホスト名を返します。
- URL.createObjectURL()
- createObjectURL()は、URLのメソッドです。Blob、Fileを参照するための一時的なURLを作成します。
- UIEvent()
- UIEvent()は、UIEventのコンストラクタです。新しいオブジェクトを作成します。
- Screen
- Screenは、デバイスのスクリーンの情報を管理するための機能を備えたインターフェイスです。