location: assign() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
Location.assign() メソッドは、指定された URL の文書をウィンドウに読み込んで表示します。移動した後、ユーザーは「戻る」ボタンを押すことによって Location.assign() を呼び出したページに戻ることができます。
セキュリティ違反のために代入ができない場合は、 DOMException が SECURITY_ERROR 型で発生します。これは、メソッドを呼び出すスクリプトのオリジンが、 Location オブジェクトによって元々記述されていたページのオリジンと異なる場合に起こります。主に、スクリプトが異なるドメインでホストされている場合に起こります。
指定された URL が有効でない場合、 DOMException が SYNTAX_ERROR 型で発生します。
構文
js
assign(url)
引数
url-
文字列で、移動先のページの URL です。
返値
なし (undefined)。
例
js
// Location.reload の記事へ移動
window.location.assign(
"https://developer.mozilla.org/ja/docs/Web/API/Location/reload",
);
仕様書
| 仕様書 |
|---|
| HTML # dom-location-assign-dev |
ブラウザーの互換性
関連情報
- 所属先の
Locationインターフェイス - 同様のメソッド:
Location.replace()およびLocation.reload()