window.location.replace

Summary

Similar to window.location.assign, except that it “replaces” the current document, removing the previous one from the back button history.

Method of apis/locationapis/location

Syntax

var  = window.location.replace(url);

Parameters

url

Data-type

String

The new URL to navigate to.

Return Value

Returns an object of type

Examples

//force a new page to load and replace the current one
window.location.replace("http://www.example.com");

Notes

It is generally advisable to use window.location.assign becuse it retains the back button history. The replace method removes the current page from the back history, and therefore may confuse the user.

Related specifications

Window Object 1.0

W3C Working Draft