HTML | DOM Location replace() Method

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">w3wiki</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 w3wiki homepage
            location.replace(
              "https://ide.w3wiki.net");
        }
    </script>
</body>
 
</html>


Note: Run the above code on ide.w3wiki.net as the link used in the code is ide.w3wiki.net to allow framing. 

Output: 

Before pressing the button:

  

After pressing the button:

  

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

Contact Us