The baseURI
read-only property returns the absolute base URL of a Node
.
The base URL is used to resolve relative URLs when the browser needs to obtain an absolute URL, for example when processing the HTML <img>
element's src
attribute or XML xlink:href
attribute.
In most cases the base URL is simply the location of the document, but it can be affected by many factors, including the <base>
element in HTML and the xml:base
attribute in XML.
Syntax
var nodeBaseURI = node.baseURI;
Value
A DOMString
representing the base URL of the specified Node
. It may be null
if unable to obtain an absolute URI. Although this property is read-only, its value may change in certain situations (see below).
Details
The base URL of a document
The base URL of a document defaults to the document's address (as displayed by the browser and available in window.location
), but it can be changed:
- When an HTML
<base>
tag is found in the document - When the document is new (created dynamically)
See the Base URLs section of the HTML Living standard for details.
You can use document
.baseURI to obtain the base URL of a document. Note that obtaining the base URL for a document may return different URLs over time if the <base>
tags or the document's location change.
The base URL of an element
The base URL of an element in HTML normally equals the base URL of the document the node is in.
If the document contains xml:base
attributes (which you shouldn't do in HTML documents), the element.baseURI
takes the xml:base
attributes of element's parents into account when computing the base URL. See xml:base for details.
You can use element
.baseURI to obtain the base URL of an element.
Specifications
Specification | Status | Comment |
---|---|---|
DOMThe definition of 'Node: baseURI' in that specification. | Living Standard |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
baseURI
|
Chrome
Full support Yes |
Edge
Full support 12 |
Firefox
Full support 1 |
IE
No support No |
Opera
Full support Yes |
Safari
Full support Yes |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
Full support 4 |
Opera Android
Full support Yes |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
See also
<base>
element (HTML)xml:base
attribute (XML documents).Node.baseURIObject
- a variant of this API for Mozilla add-ons and internal code. Returns the base URL as annsIURI
.
Node.baseURI by Mozilla Contributors is licensed under CC-BY-SA 2.5.