[Chapter 21] Reference: Location.replace()
Author: David Flanagan
Date: Fri Aug 29 11:17:32 1997

#

| Chapter 21 JavaScript Reference |

# Location.replace() Method

## Name

Location.replace() Method---replace one displayed document with another

## Availability

Navigator 3.0

## Synopsis

    location.replace(url)

### Arguments

`url`

  A string that specifies the URL of the new document that is to replace the current one.

### Returns

Nothing.

## Description

The `replace()` method of the Location object loads and displays a new document. Loading a document in this way is different than simply setting `location` or `location``.href` in one important respect: the `replace()` method does not generate a new entry in the History object. When you use `replace()`, the new URL overwrites the current entry in the History object. After calling `replace()`, that is, the browser's Back button will not return you to the previous URL; it will return you to the URL before that one.

## Usage

When you are working with multiple frames and/or JavaScript generated documents, you sometimes end up with quite a few temporary or transient documents. If there are more than just a few of these documents, it becomes annoying to the user to back out of your web site with the Back button. If you use the `replace()` method to load these documents, however, you can prevent this problem.

## See Also

"History", "Location", "Location.reload()"

Location.reload() |  | Location.search