HTMLBaseElement: 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.

See full compatibility

The href property of the HTMLBaseElement interface contains a string that is the URL to use as the base for relative URLs.

It reflects the href attribute of the <base> element.

Value

A string that contains a URL, or the empty string ("") if the corresponding <base> element does not include the href attribute.

Examples

HTML with base URL

This example demonstrates that the href attribute in <base> is reflected in the href property of HTMLBaseElement.

<pre id="log"></pre>

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = text;
}

#log {
  height: 20px;
}

HTML

html

<base href="https://developer.mozilla.org/example" />

JavaScript

const base = document.getElementsByTagName("base")[0];
log(`base.href="${base.href}"`);

Result

Specifications

Specification
HTML # dom-base-href

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`href`	Chrome – Full support Chrome 1 (Release date: 2008-12-11) footnote Full support	Edge – Full support Edge 12 (Release date: 2015-07-29) footnote Full support	Firefox – Full support Firefox 1 (Release date: 2004-11-09) footnote Full support	Opera – Full support Opera 12.1 (Release date: 2012-11-20) footnote Full support	Safari – Full support Safari 3 (Release date: 2007-10-26) footnote Full support	Chrome Android – Full support Chrome Android 18 (Release date: 2012-06-27) footnote Full support	Firefox for Android – Full support Firefox for Android 4 (Release date: 2011-03-29) footnote Full support	Opera Android – Full support Opera Android 12.1 (Release date: 2012-10-09) footnote Full support	Safari on iOS – Full support Safari on iOS 1 (Release date: 2007-06-29) footnote Full support	Samsung Internet – Full support Samsung Internet 1 (Release date: 2013-04-27) footnote Full support	WebView Android – Full support WebView Android 4.4 (Release date: 2013-12-09) footnote Full support	WebView on iOS – Full support WebView on iOS 1 (Release date: 2007-06-29) footnote Full support
`data:` and `javascript:` urls are not allowed	Chrome – No support Chrome footnote footnote See bug 40928991	Edge – No support Edge footnote footnote See bug 40928991	Firefox – Full support Firefox 127 (Release date: 2024-06-11) footnote Full support	Opera – No support Opera footnote footnote See bug 40928991	Safari – Full support Safari 17.2 (Release date: 2023-12-11) footnote Full support	Chrome Android – No support Chrome Android footnote footnote See bug 40928991	Firefox for Android – Full support Firefox for Android 127 (Release date: 2024-06-11) footnote Full support	Opera Android – No support Opera Android footnote footnote See bug 40928991	Safari on iOS – Full support Safari on iOS 17.2 (Release date: 2023-12-11) footnote Full support	Samsung Internet – No support Samsung Internet footnote footnote See bug 40928991	WebView Android – No support WebView Android footnote footnote See bug 40928991	WebView on iOS – Full support WebView on iOS 17.2 (Release date: 2023-12-11) footnote Full support
tab, newline, and < are not allowed (dangling markup prevention)	Chrome – Full support Chrome 61 (Release date: 2017-09-05) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – Full support Firefox 128 (Release date: 2024-07-09) footnote footnote See bug 1835157	Opera – Full support Opera 48 (Release date: 2017-09-27) footnote Full support	Safari – Full support Safari 16 (Release date: 2022-09-12) footnote footnote See bug 257349	Chrome Android – Full support Chrome Android 61 (Release date: 2017-09-05) footnote Full support	Firefox for Android – Full support Firefox for Android 128 (Release date: 2024-07-09) footnote footnote See bug 1835157	Opera Android – Full support Opera Android 45 (Release date: 2018-02-15) footnote Full support	Safari on iOS – Full support Safari on iOS 16 (Release date: 2022-09-12) footnote footnote See bug 257349	Samsung Internet – Full support Samsung Internet 8 (Release date: 2018-07-18) footnote Full support	WebView Android – Full support WebView Android 61 (Release date: 2017-09-05) footnote Full support	WebView on iOS – Full support WebView on iOS 16 (Release date: 2022-09-12) footnote footnote See bug 257349

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.

This page was last modified on Dec 19, 2024 by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.