diff options
Diffstat (limited to 'files/zh-cn/web/api/url')
-rw-r--r-- | files/zh-cn/web/api/url/createobjecturl/index.html | 98 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/hash/index.html | 60 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/host/index.html | 66 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/hostname/index.html | 54 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/href/index.html | 55 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/index.html | 142 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/origin/index.html | 112 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/pathname/index.html | 59 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/port/index.html | 57 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/protocol/index.html | 55 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/revokeobjecturl/index.html | 68 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/search/index.html | 63 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/searchparams/index.html | 56 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/tojson/index.html | 54 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/tostring/index.html | 63 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/url/index.html | 102 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/username/index.html | 61 | ||||
-rw-r--r-- | files/zh-cn/web/api/url/密码/index.html | 57 |
18 files changed, 1282 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/url/createobjecturl/index.html b/files/zh-cn/web/api/url/createobjecturl/index.html new file mode 100644 index 0000000000..bfa0e79d46 --- /dev/null +++ b/files/zh-cn/web/api/url/createobjecturl/index.html @@ -0,0 +1,98 @@ +--- +title: URL.createObjectURL() +slug: Web/API/URL/createObjectURL +tags: + - API + - DOM + - URL + - URL API + - 方法 +translation_of: Web/API/URL/createObjectURL +--- +<div>{{ApiRef("URL")}}</div> + +<p><strong><code>URL.createObjectURL()</code></strong> 静态方法会创建一个 {{domxref("DOMString")}},其中包含一个表示参数中给出的对象的URL。这个 URL 的生命周期和创建它的窗口中的 {{domxref("document")}} 绑定。这个新的URL 对象表示指定的 {{domxref("File")}} 对象或 {{domxref("Blob")}} 对象。</p> + +<p>{{AvailableInWorkers}}</p> + +<div class="note"> +<p><strong>注意:</strong>此特性在 <a href="/zh-CN/docs/Web/API/Service_Worker_API">Service Worker</a> 中不可用,因为它有可能导致内存泄漏。</p> +</div> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>objectURL</em> = URL.createObjectURL(<em>object</em>); +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>object</code></dt> + <dd>用于创建 URL 的 {{domxref("File")}} 对象、{{domxref("Blob")}} 对象或者 {{domxref("MediaSource")}} 对象。</dd> +</dl> + +<h3 id="返回值">返回值</h3> + +<p>一个{{domxref("DOMString")}}包含了一个对象URL,该URL可用于指定源 <code>object</code>的内容。</p> + +<h2 id="示例">示例</h2> + +<p>查看<a href="/zh-CN/docs/Using_files_from_web_applications#Example.3A_Using_object_URLs_to_display_images" title="https://developer.mozilla.org/en/Using_files_from_web_applications#Example:_Using_object_URLs_to_display_images">使用对象URL显示图片</a>.</p> + +<h2 id="Notes" name="Notes">附注</h2> + +<h3 id="内存管理">内存管理</h3> + +<p>在每次调用 <code>createObjectURL()</code> 方法时,都会创建一个新的 URL 对象,即使你已经用相同的对象作为参数创建过。当不再需要这些 URL 对象时,每个对象必须通过调用 {{domxref("URL.revokeObjectURL()")}} 方法来释放。</p> + +<p>浏览器在 document 卸载的时候,会自动释放它们,但是为了获得最佳性能和内存使用状况,你应该在安全的时机主动释放掉它们。</p> + +<h3 id="使用相对URLs作为媒体流">使用相对URLs作为媒体流</h3> + +<p>在旧版本的媒体资源规范中,添加流作为{{HTMLElement("video")}}元素需要创建一个关于 {{domxref("MediaStream")}}的对象URL。现已没必要这样做了,浏览器已经移除了该操作的支持。</p> + +<div class="blockIndicator warning"> +<p>重要:如果你为了去添加流作为媒体元素,而仍旧使用着依赖{{domxref("URL.createObjectURL", "createObjectURL()")}} 的代码,你需要更新的代码,仅需要设定{{domxref("HTMLMediaElement.srcObject", "srcObject")}} 到`<code>MediaStream</code> `即可。</p> +</div> + +<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('File API', '#dfn-createObjectURL', 'createObjectURL()')}}</td> + <td>{{Spec2('File API')}}</td> + <td>Initial definition.</td> + </tr> + <tr> + <td>{{SpecName('Media Source Extensions', '#dom-url-createobjecturl', 'URL')}}</td> + <td>{{Spec2('Media Source Extensions')}}</td> + <td> + <p>MediaSource extension.</p> + + <p>Older versions of this specification used <code>createObjectURL()</code> for {{domxref("MediaStream")}} objects; this is no longer supported.</p> + </td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.createObjectURL")}}</p> + +<h2 id="See_also" name="See_also">相关链接</h2> + +<ul> + <li><a href="/zh-CN/docs/Using_files_from_web_applications" title="Using files from web applications">在web应用程序中使用文件</a></li> + <li><a href="/en-US/docs/Using_files_from_web_applications#Example_Using_object_URLs_to_display_images" title="https://developer.mozilla.org/en/Using_files_from_web_applications#Example:_Using_object_URLs_to_display_images">Using object URLs to display images</a></li> + <li>{{domxref("URL.revokeObjectURL()")}}</li> + <li>{{domxref("HTMLMediaElement.srcObject")}}</li> + <li>{{domxref("FileReader.readAsDataURL()")}}</li> +</ul> diff --git a/files/zh-cn/web/api/url/hash/index.html b/files/zh-cn/web/api/url/hash/index.html new file mode 100644 index 0000000000..e84ba5251e --- /dev/null +++ b/files/zh-cn/web/api/url/hash/index.html @@ -0,0 +1,60 @@ +--- +title: URL.hash +slug: Web/API/URL/hash +tags: + - API + - Hash + - URL +translation_of: Web/API/URL/hash +--- +<div>{{ APIRef("URL API") }}</div> + +<p><span class="seoSummary">{{domxref("URL")}} 接口的 <strong><code>hash</code></strong> 属性返回一个 {{domxref("USVString")}},其中会包含URL标识中的 <code>'#'</code> 和 fragment 标识符(fragment 即我们通常所说的 URL hash)。</span></p> + +<p>这里 fragment 不会经过<a href="/en-US/docs/Glossary/percent-encoding">百分比编码</a>(URL编码)。如果 URL 中没有 fragment,该属性会包含一个空字符串 —— <code>""</code>.</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.hash; +<em>object</em>.hash = <em>string</em>; +</pre> + +<h3 id="返回值">返回值</h3> + +<p>{{domxref("USVString")}}.</p> + +<h2 id="示例">示例</h2> + +<pre class="brush: html">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/href#Examples'); +url.hash // Returns '#Examples'</pre> + +<h2 id="详情">详情</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-hash', 'URL.hash')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容">浏览器兼容</h2> + +<div class="hidden">本页面的兼容性表格是由结构化数据生成的。如果你愿意为这些数据做点贡献,请在 github <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 检出代码,然后发送 pull request 给我们。</div> + +<p>{{Compat("api.URL.hash")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>所属的 {{domxref("URL")}} 接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/host/index.html b/files/zh-cn/web/api/url/host/index.html new file mode 100644 index 0000000000..4db9e53887 --- /dev/null +++ b/files/zh-cn/web/api/url/host/index.html @@ -0,0 +1,66 @@ +--- +title: URL.host +slug: Web/API/URL/host +translation_of: Web/API/URL/host +--- +<div>{{ApiRef("URL API")}}</div> + +<p>{{domxref("URL")}} 接口的 <strong><code>host</code></strong> 属性是一个 {{domxref("USVString")}} 值,包含了主机信息,也就是 <em>主机名(hostname)</em>,还有,如果 URL 接口不为空,也会包含冒号 <code>':'</code> 和 URL 的 <em>端口(port)</em>。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.host; +<em>object.<code>host</code></em> = <em>string</em>; +</pre> + +<p> </p> + +<h3 id="返回值">返回值</h3> + +<p>{{domxref("USVString")}}.</p> + +<p> </p> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/host'); +var result = url.host // "developer.mozilla.org" + +var url = new URL('https://developer.mozilla.org:443/en-US/docs/Web/API/URL/host'); +var result = url.host // "developer.mozilla.org" +// The port number is not included because 443 is the scheme's default port + +var url = new URL('https://developer.mozilla.org:4097/en-US/docs/Web/API/URL/host'); +var result = url.host // "developer.mozilla.org:4097" +</pre> + +<h2 id="详情">详情</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-host', 'URL.host')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初始定义</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容">浏览器兼容</h2> + +<div class="hidden">本页面的兼容性表格是由结构化数据生成的。如果你愿意为这些数据做点贡献,请在 github <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 检出代码,然后发送 pull request 给我们。</div> + +<p>{{Compat("api.URL.host")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>所属的 {{domxref("URL")}} 接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/hostname/index.html b/files/zh-cn/web/api/url/hostname/index.html new file mode 100644 index 0000000000..b2646188e1 --- /dev/null +++ b/files/zh-cn/web/api/url/hostname/index.html @@ -0,0 +1,54 @@ +--- +title: URL.hostname +slug: Web/API/URL/hostname +translation_of: Web/API/URL/hostname +--- +<div>{{ApiRef("URL API")}}</div> + +<p>{{domxref("URL")}} 接口的 <strong><code>hostname</code></strong> 属性是一个 {{domxref("USVString")}} 值,包含有 URL 中的域名。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.hostname; +<em>object.</em>hostname = <em>string</em>; +</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/hostname'); +var result = url.hostname; // Returns:'developer.mozilla.org'</pre> + +<h2 id="详情">详情</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-hostname', 'URL.hostname')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初始定义</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容">浏览器兼容</h2> + +<div class="hidden">本页面的兼容性表格是由结构化数据生成的。如果你愿意为这些数据做点贡献,请在 github <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 检出代码,然后发送 pull request 给我们。</div> + +<p>{{Compat("api.URL.hostname")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>属的 {{domxref("URL")}} 接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/href/index.html b/files/zh-cn/web/api/url/href/index.html new file mode 100644 index 0000000000..7bb80eb628 --- /dev/null +++ b/files/zh-cn/web/api/url/href/index.html @@ -0,0 +1,55 @@ +--- +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> + +<div class="hidden">本页面的兼容性表格是由结构化数据生成的。如果你愿意为这些数据做点贡献,请在 github <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 检出代码,然后发送 pull request 给我们。</div> + +<p>{{Compat("api.URL.href")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>所属的 {{domxref("URL")}} 接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/index.html b/files/zh-cn/web/api/url/index.html new file mode 100644 index 0000000000..2dddb9e669 --- /dev/null +++ b/files/zh-cn/web/api/url/index.html @@ -0,0 +1,142 @@ +--- +title: URL +slug: Web/API/URL +translation_of: Web/API/URL +--- +<div>{{APIRef("URL API")}}</div> + +<p><strong><code>URL</code></strong>接口用于解析,构造,规范化和编码 {{glossary("URL", "URLs")}}。 它通过提供允许您轻松阅读和修改URL组件的属性来工作。 通常,通过在调用URL的构造函数时将URL指定为字符串或提供相对URL和基本URL来创建新的URL对象。 然后,您可以轻松读取URL的已解析组成部分或对URL进行更改。</p> + +<p>如果浏览器尚不支持{{domxref("URL.URL", "URL()")}}构造函数,则可以使用{{domxref("Window")}}中的{{domxref("Window.URL")}}属性。 确保检查您的任何目标浏览器是否要求对此添加前缀。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="构造器">构造器</h2> + +<dl> + <dt>{{domxref("URL.URL", "new URL()")}}</dt> + <dd>创建并返回一个<code>URL</code>对象,该URL对象引用使用绝对URL字符串,相对URL字符串和基本URL字符串指定的URL。</dd> +</dl> + +<h2 id="属性">属性</h2> + +<dl> + <dt>{{domxref("URL.hash", "hash")}}</dt> + <dd>包含<code>'#'</code>的{{domxref("USVString")}},后跟URL的片段标识符。</dd> + <dt>{{domxref("URL.host", "host")}}</dt> + <dd>一个{{domxref("USVString")}},其中包含域(即主机名),后跟(如果指定了端口)“:”和URL的端口。</dd> + <dt>{{domxref("URL.hostname", "hostname")}}</dt> + <dd>包含 URL 域名的 {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.href", "href")}}</dt> + <dd>包含完整 URL 的 {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.origin", "origin")}} {{readonlyInline}}</dt> + <dd>返回一个包含协议名、域名和端口号的 {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.password", "password")}}</dt> + <dd>包含在域名前面指定的密码的 {{domxref("USVString")}} 。</dd> + <dt>{{domxref("URL.pathname", "pathname")}}</dt> + <dd>以 '/' 起头紧跟着 URL 文件路径的 {{domxref("DOMString")}}。</dd> + <dt>{{domxref("URL.port", "port")}}</dt> + <dd>包含 URL 端口号的 {{domxref("USVString")}}。</dd> + <dt>{{domxref("URL.protocol", "protocol")}}</dt> + <dd>包含 URL 协议名的 {{domxref("USVString")}},末尾带 <code>':'。</code></dd> + <dt>{{domxref("URL.search", "search")}}</dt> + <dd>一个{{domxref("USVString")}} ,指示URL的参数字符串; 如果提供了任何参数,则此字符串包括所有参数,并以开头的“?”开头 字符。</dd> + <dt>{{domxref("URL.searchParams", "searchParams")}} {{readonlyInline}}</dt> + <dd>{{domxref("URLSearchParams")}}对象,可用于访问<code>search</code>中找到的各个查询参数。</dd> + <dt>{{domxref("URL.username","username")}}</dt> + <dd>包含在域名前面指定的用户名的 {{domxref("USVString")}}。</dd> +</dl> + +<dl> +</dl> + +<h2 id="方法">方法</h2> + +<dl> + <dt>{{domxref("URL.toString", "toString()")}}</dt> + <dd>返回包含整个URL的{{domxref("USVString")}}。 它是{{domxref("URL.href")}}的同义词,尽管它不能用于修改值。</dd> + <dt>{{domxref("URL.toJSON", "toJSON()")}}</dt> + <dd>返回包含整个URL的{{domxref("USVString")}}。 它返回与<code>href</code>属性相同的字符串。</dd> +</dl> + +<h2 id="静态方法">静态方法</h2> + +<dl> + <dt>{{domxref("URL.createObjectURL", "createObjectURL()")}}</dt> + <dd>返回一个{{domxref("DOMString")}} ,包含一个唯一的blob链接(该链接协议为以blob:,后跟唯一标识浏览器中的对象的掩码)。</dd> + <dt>{{domxref("URL.revokeObjectURL", "revokeObjectURL()")}}</dt> + <dd>销毁之前使用{{ domxref("URL.createObjectURL()") }}方法创建的URL实例。</dd> +</dl> + +<h2 id="使用说明">使用说明</h2> + +<p>如果<code>url</code>参数是相对URL,则构造函数将使用<code>url</code>参数和可选的<code>base</code>参数作为基础。</p> + +<pre>const url = new URL('../cats', 'http://www.example.com/dogs'); +console.log(url.hostname); // "www.example.com" +console.log(url.pathname); // "/cats" +</pre> + +<p>可以设置URL属性以构造URL:</p> + +<pre>url.hash = 'tabby'; +console.log(url.href); // "http://www.example.com/cats#tabby" +</pre> + +<p>URL根据 {{RFC(3986)}}中的规则进行编码。 例如:</p> + +<pre>url.pathname = 'démonstration.html'; +console.log(url.href); // "http://www.example.com/d%C3%A9monstration.html" +</pre> + +<p>{{domxref("URLSearchParams")}}接口可用于构建和处理URL查询字符串。</p> + +<p>要从当前窗口的URL获取搜索参数,可以执行以下操作:</p> + +<pre>// https://some.site/?id=123 +const parsedUrl = new URL(window.location.href); +console.log(parsedUrl.searchParams.get("id")); // "123" +</pre> + +<p>URL的{{domxref("URL.toString", "toString()")}}方法仅返回{{domxref("URL.href", "href")}} 属性的值,因此构造函数可以 用于直接对URL进行规范化和编码。</p> + +<pre>const response = await fetch(new URL('http://www.example.com/démonstration.html'));</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('File API', '#creating-revoking', 'URL')}}</td> + <td>{{Spec2('File API')}}</td> + <td>Added the static methods <code>URL.createObjectURL()</code> and <code>URL.revokeObjectURL</code><code>()</code>.</td> + </tr> + <tr> + <td>{{SpecName('URL', '#api', 'Node')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition (implements <code>URLUtils</code>).</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div class="hidden"> +<p>此页面上的兼容性表是根据结构化数据生成的。 如果您想提供数据,请查看<a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>并向我们发送请求请求。</p> +</div> + +<p>{{Compat("api.URL")}}</p> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/API/URL_API">URL API</a></li> + <li><a href="https://wiki.developer.mozilla.org/en-US/docs/Learn/Common_questions/What_is_a_URL">What is a URL?</a></li> + <li>Property to obtain a <code>URL</code> object: {{domxref("Window.URL")}}.</li> + <li>{{domxref("URLSearchParams")}}.</li> +</ul> diff --git a/files/zh-cn/web/api/url/origin/index.html b/files/zh-cn/web/api/url/origin/index.html new file mode 100644 index 0000000000..182ae919ea --- /dev/null +++ b/files/zh-cn/web/api/url/origin/index.html @@ -0,0 +1,112 @@ +--- +title: URL.origin +slug: Web/API/URL/origin +translation_of: Web/API/URL/origin +--- +<p>{{APIRef("URL API")}}</p> + +<p><code><strong>URL</strong></code><strong><code>.origin</code></strong> 是一个只读属性,返回一个 {{domxref("USVString")}} 类型值,包含 URL 源经过 Unicode 序列化之后的值, 也就是:</p> + +<ul> + <li>对于使用 <code>http</code> 或者 <code>https</code> 协议的 URL, 返回协议名, 然后是 <code>'://'</code>, 然后是域, 然后是 <code>':'</code>, 最后是端口号 (默认端口是 <code>80</code> 和 <code>443</code>);</li> + <li>对于使用 <code>file:</code> 协议的 URL, 返回值因浏览器而异;</li> + <li>对于使用 <code>blob:</code> 协议的 URL, 返回值是 <code>blob:</code> 后跟随的源地址. 例如 <code>"blob:https://mozilla.org"</code> 将会返回 <code>"https://mozilla.org".</code></li> +</ul> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>URLObject</em>.origin; +</pre> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var result = new URL("blob:https://mozilla.org:443/").origin; +// 返回:'https://developer.mozilla.org:443' +</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-origin', 'URL.origin')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器支持">浏览器支持</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Edge</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatChrome(52)}}</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatGeckoDesktop("26.0")}} [2][3]</td> + <td>{{CompatNo}} [1]</td> + <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{CompatNo}}</span> [1]</td> + <td>{{CompatNo}} [1]</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android Webview</th> + <th>Chrome for Android</th> + <th>Edge</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatChrome(52)}}</td> + <td>{{CompatChrome(52)}}</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatGeckoMobile("26.0")}} [2][3]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + </tr> + </tbody> +</table> +</div> + +<p>[1] Though not grouped in a single abstract interface, this method is directly available on the interfaces that implement it, if this interface is supported.</p> + +<p>[2] From Gecko 26 to Gecko 44, this property was on the <code>URLUtils</code> mixin. It has been moves either on the <code>HTMLHyperlinkElementUtils</code> mixin, or directly on the interface.</p> + +<p>[3] Before Gecko 49, results for URL using the <code>blob</code> scheme incorrectly returned <code>null</code>.</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>The {{domxref("HTMLHyperlinkElementUtils.origin")}} property</li> +</ul> diff --git a/files/zh-cn/web/api/url/pathname/index.html b/files/zh-cn/web/api/url/pathname/index.html new file mode 100644 index 0000000000..cb761610f6 --- /dev/null +++ b/files/zh-cn/web/api/url/pathname/index.html @@ -0,0 +1,59 @@ +--- +title: URL.pathname +slug: Web/API/URL/pathname +tags: + - API + - URL + - pathname +translation_of: Web/API/URL/pathname +--- +<div>{{ApiRef("URL API")}}</div> + +<p>{{domxref("URL")}}接口的<strong><code>pathname</code></strong>属性是一个{{domxref("USVString")}},包含一个初始 <code>'/'</code> 和URL的路径(如果没有路径,则为空字符串)</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.pathname; +<em>object</em>.pathname = <em>string</em>; +</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/pathname'); +var result = url.pathname; // Returns:"/en-US/docs/Web/API/URL/pathname" +</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-pathname', 'URL.pathname')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div class="hidden">该页面上的兼容性表是由结构化数据生成的。如果您想对数据做出贡献,请查看https://github.com/mdn/browser-compat-data,并向我们发送一个pull request。</div> + +<p>{{Compat("api.URL.pathname")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>它所属的{{domxref("URL")}}接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/port/index.html b/files/zh-cn/web/api/url/port/index.html new file mode 100644 index 0000000000..5a50e2daf1 --- /dev/null +++ b/files/zh-cn/web/api/url/port/index.html @@ -0,0 +1,57 @@ +--- +title: URL.port +slug: Web/API/URL/port +translation_of: Web/API/URL/port +--- +<div>{{ApiRef("URL API")}}</div> + +<div>{{domxref("URL")}} 接口的端口属性是包含了URL的端口号信息的{{domxref("USVString")}}值,如果URL中不包含明确的端口号,这个属性将为<code>''</code>.</div> + +<div></div> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法"><strong>语法</strong></h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.port; +<em>object</em>.port = <em>string</em>; +</pre> + +<h3 id="参数">参数</h3> + +<p>A {{domxref("USVString")}}.</p> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var url = new URL('<span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="cm-string">https://mydomain.com:80/svn/Repos/</span></span></span></span>'); +var result = url.port; // Returns:'80' +</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-port', 'URL.port')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.port")}}</p> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li>The {{domxref("URL")}} interface it belongs to.</li> +</ul> diff --git a/files/zh-cn/web/api/url/protocol/index.html b/files/zh-cn/web/api/url/protocol/index.html new file mode 100644 index 0000000000..2774282d7e --- /dev/null +++ b/files/zh-cn/web/api/url/protocol/index.html @@ -0,0 +1,55 @@ +--- +title: URL.protocol +slug: Web/API/URL/protocol +translation_of: Web/API/URL/protocol +--- +<div>{{ApiRef("URL API")}}</div> + +<div>{{domxref("URL")}}接口的<strong><code>protocol</code></strong>是一个包含URL协议的{{domxref("USVString")}}值,此值包含协议后的<code>':'</code>.</div> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.protocol; +<em>object</em>.protocol = <em>string</em>; +</pre> + +<h3 id="参数">参数</h3> + +<p>A {{domxref("USVString")}}.</p> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">var url = new URL('https://developer.mozilla.org/en-US/docs/Web/API/URL/protocol'); +var result = url.protocol; // Returns:"https:" +</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-protocol', 'protocol')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.protocol")}}</p> + +<h2 id="其他链接">其他链接</h2> + +<ul> + <li>The {{domxref("URL")}} interface it belongs to.</li> +</ul> diff --git a/files/zh-cn/web/api/url/revokeobjecturl/index.html b/files/zh-cn/web/api/url/revokeobjecturl/index.html new file mode 100644 index 0000000000..4619beb7e1 --- /dev/null +++ b/files/zh-cn/web/api/url/revokeobjecturl/index.html @@ -0,0 +1,68 @@ +--- +title: URL.revokeObjectURL() +slug: Web/API/URL/revokeObjectURL +tags: + - API + - URL + - URL API + - 方法 +translation_of: Web/API/URL/revokeObjectURL +--- +<div>{{ApiRef("URL")}}</div> + +<p><strong><code>URL.revokeObjectURL()</code> </strong> 静态方法用来释放一个之前已经存在的、通过调用 {{domxref("URL.createObjectURL()")}} 创建的 URL 对象。当你结束使用某个 URL 对象之后,应该通过调用这个方法来让浏览器知道不用在内存中继续保留对这个文件的引用了。</p> + +<p>你可以在 <code>sourceopen</code> 被处理之后的任何时候调用 <code>revokeObjectURL()</code>。这是因为 <code>createObjectURL()</code> 仅仅意味着将一个媒体元素的 <code>src</code> 属性关联到一个 {{domxref("MediaSource")}} 对象上去。调用<code>revokeObjectURL()</code> 使这个潜在的对象回到原来的地方,允许平台在合适的时机进行垃圾收集。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">window.URL.revokeObjectURL(object<em>URL</em>); +</pre> + +<h3 id="参数">参数</h3> + +<dl> + <dt><code>objectURL</code></dt> + <dd>一个 {{domxref("DOMString")}},表示通过调用 {{domxref("URL.createObjectURL()") }} 方法产生的 URL 对象。</dd> +</dl> + +<h3 id="Return_value">Return value</h3> + +<p>undefined</p> + +<h2 id="示例">示例</h2> + +<p>查看<a href="/zh-CN/docs/Using_files_from_web_applications#Example.3a_Using_object_URLs_to_display_images">使用对象 URL 显示图片</a>。</p> + +<h2 id="规范">规范</h2> + +<table> + <tbody> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">备注</th> + </tr> + <tr> + <td>{{SpecName('File API', '#dfn-revokeObjectURL', 'revokeObjectURL()')}}</td> + <td>{{Spec2('File API')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.revokeObjectURL")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li><a href="/zh-CN/docs/Using_files_from_web_applications">在 Web 应用程序中使用文件</a></li> + <li><a href="/zh-CN/docs/Using_files_from_web_applications#Example_Using_object_URLs_to_display_images">使用对象 URL 显示图像</a></li> + <li>{{domxref("URL.createObjectURL()") }}</li> +</ul> diff --git a/files/zh-cn/web/api/url/search/index.html b/files/zh-cn/web/api/url/search/index.html new file mode 100644 index 0000000000..7bbe118ad5 --- /dev/null +++ b/files/zh-cn/web/api/url/search/index.html @@ -0,0 +1,63 @@ +--- +title: URL.search +slug: Web/API/URL/search +tags: + - API + - Property + - Reference + - Search + - URL +translation_of: Web/API/URL/search +--- +<div>{{ApiRef("URL API")}}</div> + +<p>{{domxref("URL")}} 接口的<strong><code>search</code></strong> 属性是一个搜索字符串, 也称为查询字符串,这是一个{{domxref("USVString")}}包含一个 <code>'?'</code>后面跟着URL的参数</p> + +<p>现代浏览器提供{{domxref("URL.searchParams")}}属性,以便轻松解析查询字符串中的参数。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.search; +<em>object</em>.search = <em>string</em>; +</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/search?q=123'); +var queryString = url.search; // Returns:"?q=123" +</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-search', 'URL.search')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div class="hidden">该页面上的兼容性表是由结构化数据生成的。如果您想对数据做出贡献,请查看https://github.com/mdn/browser-compat-data,并向我们发送一个pull request。</div> + +<p>{{Compat("api.URL.search")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>它所属的{{domxref("URL")}}接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/searchparams/index.html b/files/zh-cn/web/api/url/searchparams/index.html new file mode 100644 index 0000000000..d4d775aed0 --- /dev/null +++ b/files/zh-cn/web/api/url/searchparams/index.html @@ -0,0 +1,56 @@ +--- +title: URL.searchParams +slug: Web/API/URL/searchParams +tags: + - API + - URL + - 参考 + - 只读 + - 只读属性 + - 属性 +translation_of: Web/API/URL/searchParams +--- +<div>{{APIRef("URL API")}}</div> + +<p>{{domxref("URL")}} 接口的 <strong><code>searchParams</code></strong> 属性返回一个 {{domxref("URLSearchParams")}} 对象,这个对象包含当前 URL 中解码后的 {{httpmethod("GET")}} 查询参数。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox notranslate">const <em>urlSearchParams</em> = <em>url</em>.searchParams</pre> + +<h3 id="属性值">属性值</h3> + +<p>一个 {{domxref("URLSearchParams")}} 对象。</p> + +<h2 id="例子">例子</h2> + +<p>如果你的 URL 是 <code>https://example.com/?name=Jonathan&age=18</code> ,你可以这样解析 URL,然后得到 <code>name</code> 和 <code>age</code> 的值。</p> + +<pre class="brush: js notranslate">let params = (new URL(document.location)).searchParams; +let name = params.get('name'); // is the string "Jonathan Smith". +let age = parseInt(params.get('age')); // is the number 18</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-searchparams', 'searchParams')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.searchParams")}}</p> diff --git a/files/zh-cn/web/api/url/tojson/index.html b/files/zh-cn/web/api/url/tojson/index.html new file mode 100644 index 0000000000..73e4eec754 --- /dev/null +++ b/files/zh-cn/web/api/url/tojson/index.html @@ -0,0 +1,54 @@ +--- +title: URL.toJSON() +slug: Web/API/URL/toJSON +tags: + - URL.toJSON() +translation_of: Web/API/URL/toJSON +--- +<p>{{APIRef("URL API")}}</p> + +<p>{{domxref("URL")}}接口的 <strong>toJSON() </strong>方法返回一个{{domxref("USVString")}},其中包含一个序列化的URL版本,尽管在实践中它似乎与{{domxref("URL.toString()")}}有相同的效果。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="notranslate">const <em>href</em> = <em>url</em>.toJSON()</pre> + +<h3 id="返回值">返回值</h3> + +<p>一个 {{domxref("USVString")}}.</p> + +<h2 id="例子">例子</h2> + +<pre class="notranslate">const url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"); +url.toJSON(); // 应该以字符串形式返回URL</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-tojson', 'toJSON()')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初步定义.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容">浏览器兼容</h2> + +<div class="hidden"> +<p>本页的兼容性表是由结构化数据生成的。如果你想为数据做出贡献,请查看<a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> ,并向我们发送拉取请求。</p> +</div> + +<p>{{Compat("api.URL.toJSON")}}</p> + +<div id="compat-desktop"></div> + +<div id="compat-mobile"></div> diff --git a/files/zh-cn/web/api/url/tostring/index.html b/files/zh-cn/web/api/url/tostring/index.html new file mode 100644 index 0000000000..090bdf2be1 --- /dev/null +++ b/files/zh-cn/web/api/url/tostring/index.html @@ -0,0 +1,63 @@ +--- +title: URL.toString() +slug: Web/API/URL/toString +tags: + - API + - URL + - 参考 + - 字符串 + - 方法 +translation_of: Web/API/URL/toString +--- +<div>{{ApiRef("URL API")}}</div> + +<p><strong><code>URL.toString()</code></strong> 字符串化方法返回一个包含完整 URL 的 {{domxref("USVString")}}。它的作用等同于只读的 {{domxref("URL.href")}}。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>url</em>.toString();</pre> + +<h3 id="参数">参数</h3> + +<p>无。</p> + +<h3 id="返回值">返回值</h3> + +<p>一个{{domxref("USVString")}}。</p> + +<h2 id="参考">参考</h2> + +<pre class="brush: js"><span class="message-body-wrapper"><span class="message-flex-body"><span class="devtools-monospace message-body"><span class="cm-keyword">const</span> <span class="cm-def">url</span> <span class="cm-operator">=</span> <span class="cm-keyword">new</span> <span class="cm-variable">URL</span>(<span class="cm-string">"https://developer.mozilla.org/en-US/docs/Web/API/URL/toString"</span>); +<span class="cm-variable">url</span>.<span class="cm-property">toString</span>() // 应当返回字符串形式的 URL</span></span></span> +</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', '#URL-stringification-behavior', 'stringifier')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.toString")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li>父级接口 {{domxref("URL")}}。</li> +</ul> diff --git a/files/zh-cn/web/api/url/url/index.html b/files/zh-cn/web/api/url/url/index.html new file mode 100644 index 0000000000..33cf3c7abf --- /dev/null +++ b/files/zh-cn/web/api/url/url/index.html @@ -0,0 +1,102 @@ +--- +title: URL() +slug: Web/API/URL/URL +tags: + - API + - URL + - URL API + - 参考 + - 构造器 +translation_of: Web/API/URL/URL +--- +<div>{{APIRef("URL API")}}</div> + +<p><code><strong>URL()</strong></code> 构造函数返回一个新创建的 {{domxref("URL")}} 对象,表示由一组参数定义的 URL。</p> + +<p>如果给定的基本 URL 或生成的 URL 不是有效的 URL 链接,则会抛出一个{{jsxref("TypeError")}}。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox notranslate">const <var>url</var> = new URL(<var>url</var> [, <var>base</var>]) +</pre> + +<h3 id="参数">参数</h3> + +<dl class="syntaxbox"> + <dt><code><var>url</var></code></dt> + <dd>是一个表示绝对或相对 URL 的 {{domxref("DOMString")}}。如果<code><var>url</var></code> 是相对 URL,则会将 <code><var>base</var></code> 用作基准 URL。如果 <code><var>url</var></code> 是绝对URL,则无论参数<code><var>url</var></code>是否存在,都将被忽略。</dd> + <dt><code><var>base</var></code> {{optional_inline}}</dt> + <dd>是一个表示基准 URL 的 {{domxref("DOMString")}},在 <em>url</em> 是相对 URL 时,它才会起效。如果未指定,则默认为 <code>''</code>。</dd> +</dl> + +<h3 id="异常">异常</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">异常</th> + <th scope="col">解释</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{jsxref("TypeError")}}</td> + <td><code><var>url</var></code>若为绝对 URL)或 <code><var>base</var></code> + <code><var>url</var></code>(若为相对 URL)是一个无效的 URL 链接。</td> + </tr> + </tbody> +</table> + +<h2 id="示例">示例</h2> + +<pre class="brush: js language-js notranslate">let m = 'https://developer.mozilla.org'; +let a = new URL("/", m); // => 'https://developer.mozilla.org/' +let b = new URL(m); // => 'https://developer.mozilla.org/' + + new URL('en-US/docs', b); // => 'https://developer.mozilla.org/en-US/docs' +let d = new URL('/en-US/docs', b); // => 'https://developer.mozilla.org/en-US/docs' + new URL('/en-US/docs', d); // => 'https://developer.mozilla.org/en-US/docs' + new URL('/en-US/docs', a); // => 'https://developer.mozilla.org/en-US/docs' + + new URL('/en-US/docs', "https://developer.mozilla.org/fr-FR/toto"); + // => 'https://developer.mozilla.org/en-US/docs' + + new URL('/en-US/docs', ''); // Raises a TypeError exception as '' is not a valid URL + new URL('/en-US/docs'); // Raises a TypeError exception as '/en-US/docs' is not a valid URL + new URL('http://www.example.com', ); // => 'http://www.example.com/' + new URL('http://www.example.com', b); // => 'http://www.example.com/' + + new URL("//foo.com", "https://example.com") // => 'https://foo.com' (see relative URLs) +</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">备注</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('URL', '#constructors', 'URL.URL()')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.URL.URL")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li>接口:{{domxref("URL")}}</li> +</ul> diff --git a/files/zh-cn/web/api/url/username/index.html b/files/zh-cn/web/api/url/username/index.html new file mode 100644 index 0000000000..9e49a28dce --- /dev/null +++ b/files/zh-cn/web/api/url/username/index.html @@ -0,0 +1,61 @@ +--- +title: URL.username +slug: Web/API/URL/username +tags: + - API + - Property + - Reference + - URL + - username +translation_of: Web/API/URL/username +--- +<div>{{ApiRef("URL API")}}</div> + +<p> {{domxref("URL")}}接口的username属性是{{domxref("USVString")}} ,其中包含域名前指定的<strong><code>username</code></strong> 。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.username; +<em>object</em>.username = <em>string</em>; +</pre> + +<h3 id="值">值</h3> + +<p>一个 {{domxref("USVString")}}.</p> + +<h2 id="例子">例子</h2> + +<pre class="brush: js">var url = new URL("https://anonymous:flabada@developer.mozilla.org/en-US/docs/Web/API/URL/username"); +var user = url.username; // 返回:“anonymous” +</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-username', 'username')}}</td> + <td>{{Spec2('URL')}}</td> + <td>初步定义</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div class="hidden">此页面上的兼容性表是根据结构化数据生成的。 如果您想为数据做出贡献,请查看https://github.com/mdn/browser-compat-data并向我们发送拉取请求。</div> + +<p>{{Compat("api.URL.username")}}</p> + +<h2 id="参考">参考</h2> + +<ul> + <li>所属的 {{domxref("URL")}}接口。</li> +</ul> diff --git a/files/zh-cn/web/api/url/密码/index.html b/files/zh-cn/web/api/url/密码/index.html new file mode 100644 index 0000000000..1592676a9d --- /dev/null +++ b/files/zh-cn/web/api/url/密码/index.html @@ -0,0 +1,57 @@ +--- +title: URL.密码 +slug: Web/API/URL/密码 +translation_of: Web/API/URL/password +--- +<div>{{ApiRef("URL API")}}</div> + +<p> {{domxref("URL")}}<span class="tlid-translation translation" lang="zh-CN"><span title="">接口的<strong><code>password</code></strong>属性为</span></span>{{domxref("USVString")}}<span class="tlid-translation translation" lang="zh-CN"><span title="">,其中包含在域名之前指定的密码。</span></span></p> + +<p><span class="tlid-translation translation" lang="zh-CN"><span title="">如果在未设置</span></span><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/API/URL/username">username</a><span class="tlid-translation translation" lang="zh-CN"><span title="">属性的情况下进行调用,默认失败。</span></span></p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox"><em>string</em> = <em>object</em>.password; +<em>object</em>.password = <em>string</em>; +</pre> + +<h3 id="值">值</h3> + +<p>A {{domxref("USVString")}}.</p> + +<h2 id="Examples">Examples</h2> + +<pre class="brush: js">var url = new URL('https://anonymous:flabada@developer.mozilla.org/en-US/docs/Web/API/URL/password'); +var result = url.password; // Returns:"flabada" +</pre> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('URL', '#dom-url-password', 'URL.password')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容">浏览器兼容</h2> + + + +<p>{{Compat("api.URL.password")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li>The {{domxref("URL")}} interface it belongs to.</li> +</ul> |