location: assign() メソッド
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/en-US/docs/Web/API/Location/reload"
);
仕様書
| Specification |
|---|
| HTML Standard # dom-location-assign-dev |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- 所属先の
Locationインターフェイス - 同様のメソッド:
Location.replace()およびLocation.reload()