location: replace() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
replace() は Location インターフェイスのメソッドで、現在のリソースを指定された URL のもので置き換えます。 assign() メソッドとの違いは、 replace() を使用すると現在のページがセッションの History に保存されないことです。すなわち、ユーザーが［戻る］ボタンを使用して戻ることができなくなります。
構文
js
replace(url)
引数
url-
文字列で、移動先のページの URL です。
例外
SyntaxErrorDOMException-
指定された
url引数が有効な URL ではなかった場合。
返値
なし (undefined)。
例
js
// このページを置き換えて、 Location.reload の記事に移動します。
window.location.replace(
"https://developer.mozilla.org/ja/docs/Web/API/Location.reload",
);
仕様書
| 仕様書 |
|---|
| HTML # dom-location-replace-dev |
ブラウザーの互換性
関連情報
- 所属先の
Locationインターフェイス - 同様のメソッド:
Location.assign()およびLocation.reload()