---
title: URL.href
slug: Web/API/URL/href
translation_of: Web/API/URL/href
---
<div>{{ApiRef("URL API")}}</div>

<p>{{domxref("URL")}} 接口的 <strong><code>href</code></strong> 属性是一个包含完整 URL 的 {{domxref("USVString")}} 值。</p>

<p>{{AvailableInWorkers}}</p>

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

<pre class="syntaxbox"><em>string</em> = <em>object</em>.href;
<em>object<code>.href = </code></em><code><em>string</em>;</code>
</pre>

<h3 id="返回值">返回值</h3>

<p>{{domxref("USVString")}}.</p>

<h2 id="示例">示例</h2>

<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href');
var result = url.href; // Returns: 'https://developer.mozilla.org/en-US/docs/Web/API/URL/href'
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">意见</th>
  </tr>
  <tr>
   <td>{{SpecName('URL', '#dom-url-href', 'URL.href')}}</td>
   <td>{{Spec2('URL')}}</td>
   <td>初始定义</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容">浏览器兼容</h2>

<p>{{Compat("api.URL.href")}}</p>

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

<ul>
 <li>所属的 {{domxref("URL")}} 接口。</li>
</ul>