---
title: Node.baseURI
slug: Web/API/Node/baseURI
tags:
  - <base>
  - API
  - HTML
  - Node.baseURI
  - Property
  - base
translation_of: Web/API/Node/baseURI
---
<div>
<div>{{APIRef("DOM")}}</div>
</div>

<p><code><strong>Node.baseURI</strong></code> 是只读属性，返回一个节点的绝对基址 URL。</p>

<p>当浏览器要获取绝对 URL 时，就需要用基 URL 去解析相对 URL。例如，解析 HTML {{HTMLElement("img")}} 元素的 <code>src </code>属性时，或者 处理 XML <code><a href="https://developer.mozilla.org/en-US/docs/XLink">xlink</a>:href</code> 属性时—。</p>

<p>一般情况下，基 URL 是 document 的 location ，但是它受诸多方面因素的影响，例如 HTML 的 {{HTMLElement("base")}} 元素和 XML <code><a href="https://developer.mozilla.org/en-US/docs/XML/xml:base">xml:base</a></code> 属性。</p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox">var <em>baseURI</em> = <em>node</em>.baseURI;
</pre>

<ul>
 <li><code>baseURI</code> 是一个 {{ domxref("DOMString") }} 代表当前 {{domxref("Node", "节点")}} 所在文档的基 URI 。如果无法获取则可能返回 <code>null</code> 。</li>
 <li><code><em>node</em>.baseURI</code> 是只读的。</li>
 <li><code><em>node</em>.baseURI</code> 可能会随时间发生变化。</li>
</ul>

<h2 id="Details" name="Details">概述</h2>

<h3 id="文档的基_URL">文档的基 URL</h3>

<p><em>document</em> 的默认基 URL 是文档的地址（浏览器显示的地址，可以通过{{domxref("window.location")}} 获取），但是可以通过如下方法修改：</p>

<ul>
 <li>当在文档中找到一个 {{HTMLElement("base")}} 标签时；</li>
 <li>当一个文档被动态创建时。</li>
</ul>

<p>详细信息请参阅 <a href="http://developers.whatwg.org/urls.html#base-urls">HTML Living standard 中关于基 URL 的章节</a> 。</p>

<p>可以通过 <code><em>{{domxref("document")}}</em>.baseURI</code> 获取文档的基 URL 。注意检查文档的基 URL 可能会每次请求返回不同的结果，因为 {{HTMLElement("base")}} 标签或文档的 location 可能被改变了。</p>

<h3 id="Example" name="Example">元素的基 URL</h3>

<p>元素的基 URL 一般和其所在的文档相同。</p>

<p>如果文档中有 <code><a href="https://developer.mozilla.org/en-US/docs/XML/xml:base">xml:base</a></code> 属性（不要在 HTML 文档中这样做），在 <code><em>node</em>.baseURI </code>计算基 URL 时，会把 <code>xml:base</code> 属性考虑进去。参考 <a href="https://developer.mozilla.org/en-US/docs/XML/xml:base">xml:base</a> 来了解更多。</p>

<p>可以通过 <code><em>{{domxref("element")}}</em>.baseURI</code> 获取某个元素的基 URL。</p>

<h2 id="Specification" name="Specification">规范</h2>

<p>{{ spec("http://www.w3.org/TR/DOM-Level-3-Core/core.html#Node3-baseURI","DOM Level 3 Core: baseURI","REC") }}</p>

<h2 id="参考">参考</h2>

<ul>
 <li>{{HTMLElement("base")}} 元素（HTML）</li>
 <li><code><a href="https://developer.mozilla.org/en-US/docs/XML/xml:base">xml:base</a></code> 属性（XML 文档）</li>
 <li>{{domxref("Node.baseURIObject")}} - a variant of this API for Mozilla add-ons and internal code. Returns the base URL as an {{interface("nsIURI")}}.</li>
</ul>

<p>{{ languages( {"en": "en/DOM/Node.baseURI" } ) }}</p>