location: replace() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

構文

js
replace(url)

引数

url

文字列で、移動先のページの URL です。

例外

SyntaxError DOMException

指定された url 引数が有効な URL ではなかった場合。

返値

なし (undefined)。

例

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

仕様書

Specification
HTML Standard
# dom-location-replace-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報