location: replace() メソッド

replace() は Location インターフェイスのメソッドで、現在のリソースを指定された URL のもので置き換えます。 assign() メソッドとの違いは、 replace() を使用すると現在のページがセッションの History に保存されないことです。すなわち、ユーザーが［戻る］ボタンを使用して戻ることができなくなります。

セキュリティ違反のために代入ができない場合、 DOMException が SECURITY_ERROR 型で発生します。これは、メソッドを呼び出すスクリプトのオリジンが、 Location オブジェクトによって元々記述されていたページのオリジンと異なる場合に起こります。主に、スクリプトが異なるドメインでホストされている場合に起こります。

指定された URL が有効でない場合、 DOMException が SYNTAX_ERROR 型で発生します。

replace(url)

// このページを置き換えて、 Location.reload の記事に移動します。
window.location.replace(
  "https://developer.mozilla.org/en-US/docs/Web/API/Location.reload"
);