1. Web
  2. Web APIs
  3. URL
  4. href

URL: 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 September 2016.

Note: This feature is available in Web Workers.

The href property of the URL interface is a string containing the whole URL.

Value

A string.

Examples

Full URL with path

js
const url = new URL(
  "https://developer.mozilla.org/en-US/docs/Web/API/URL/href",
);
console.log(url.href); // https://developer.mozilla.org/en-US/docs/Web/API/URL/href

Origin-only URL

For hierarchical schemes such as https:, the pathname must always be non-empty. When the URL has no path (for example, only an origin), the URL parser sets the pathname to "/", so href includes a trailing slash. See the pathname property for more details.

js
const url = new URL("https://developer.mozilla.org");
console.log(url.href); // https://developer.mozilla.org/

Specifications

Specification
URL
# dom-url-href

Browser compatibility

See also

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content