Location: href property

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.

The href property of the Location interface is a stringifier that returns a string containing the whole URL, and allows the href to be updated.

Setting the value of href navigates to the provided URL. If you want redirection, use location.replace(). The difference from setting the href property value is that when using the location.replace() method, after navigating to the given URL, the current page will not be saved in session history — meaning the user won't be able to use the back button to navigate to it.

Value

A string.

Examples

js
// Lets imagine an <a id="myAnchor" href="https://developer.mozilla.org/en-US/Location/href"> element is in the document
const anchor = document.getElementById("myAnchor");
const result = anchor.href; // Returns: 'https://developer.mozilla.org/en-US/Location/href'

Specifications

Specification
HTML Standard
# dom-location-href-dev

Browser compatibility

BCD tables only load in the browser