Open In App

HTML | DOM Location replace() Method

Last Updated : 05 May, 2025
Comments
Improve
Suggest changes
Like Article
Like
Report

The DOM Location replace() Method in HTML is used to replace the current document with the specified one. This method is different from the assign() method as this removes the current document from the document history, therefore it is not possible to go back to the previous document using the 'back' button. 

Syntax:

location.replace( newUrl );

Parameters:

  • newUrl: This is the URL to replace the current page with. This is a required parameter.

Note: The URL to be replaced must allow framing. 

Return Value: No return value. 

Example: 

html
<!DOCTYPE html>
<html lang="en">

<head>
    <title>DOM Location replace() Method</title>
</head>

<body>
    <h1 style="color: green">GeeksforGeeks</h1>
    <b>DOM Location replace() Method</b>

    <p>Click the button to replace 
      the current document with a new one.</p>

    <button onclick="changePage()">
      Change Page
    </button>

    <script>
        function changePage() {

            // change the document to
            // the GeeksforGeeks homepage
            location.replace(
             "https://www.geeksforgeeks.org/community/");
        }
    </script>
</body>

</html>

Output: 

Before pressing the button:

 before-click 

After pressing the button:

 after-click 

Supported Browsers: The browser supported by DOM Location replace() Method are listed below:

  • Google Chrome 1
  • Edge 12
  • Internet Explorer 5.5
  • Firefox 1
  • Opera 3
  • Safari 1

Next Article

Similar Reads