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
# dom-location-replace-dev

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
replace

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
User must explicitly enable this feature.

関連情報