diff options
Diffstat (limited to 'files/zh-cn/orphaned')
23 files changed, 1663 insertions, 0 deletions
diff --git a/files/zh-cn/orphaned/web/api/navigatorconcurrenthardware/hardwareconcurrency/index.html b/files/zh-cn/orphaned/web/api/navigatorconcurrenthardware/hardwareconcurrency/index.html new file mode 100644 index 0000000000..84cb1f561a --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorconcurrenthardware/hardwareconcurrency/index.html @@ -0,0 +1,70 @@ +--- +title: navigator.hardwareConcurrency +slug: orphaned/Web/API/NavigatorConcurrentHardware/hardwareConcurrency +translation_of: Web/API/NavigatorConcurrentHardware/hardwareConcurrency +original_slug: Web/API/NavigatorConcurrentHardware/hardwareConcurrency +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p>{{AvailableInWorkers}}</p> + +<p><code><strong>navigator.hardwareConcurrency </strong>指明当前浏览器环境所拥有的CPU核心数，这来自于操作系统提供的API来获取。</code></p> + +<h2 id="用法">用法</h2> + +<pre class="syntaxbox"><em>CPU核心数</em>= window.navigator.hardwareConcurrency +</pre> + +<h2 id="Value">Value</h2> + +<p>A {{jsxref("Number")}} indicating the number of logical processor cores.</p> + +<p>Modern computers have multiple physical processor cores in their CPU (two or four cores is typical), but each physical core is also usually able to run more than one thread at a time using advanced scheduling techniques. So a four-core CPU may offer eight <strong>logical processor cores</strong>, for example. The number of logical processor cores can be used to measure the number of threads which can effectively be run at once without them having to context switch.</p> + +<p>The browser may, however, choose to report a lower number of logical cores in order to represent more accurately the number of {{domxref("Worker")}}s that can run at once, so don't treat this as an absolute measurement of the number of cores in the user's system.</p> + +<h2 id="Examples">Examples</h2> + +<p>In this example, one {{domxref("Worker")}} is created for each logical processor reported by the browser and a record is created which includes a reference to the new worker as well as a Boolean value indicating whether or not we're using that worker yet; these objects are, in turn, stored into an array for later use. This creates a pool of workers we can use to process requests later.</p> + +<pre class="brush: js">let workerList = []; + +for (let i = 0; i < window.navigator.hardwareConcurrency; i++) { + let newWorker = { + worker: new Worker('cpuworker.js'), + inUse: false + }; + workerList.push(newWorker); +}</pre> + +<h2 id="Specification">Specification</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('HTML WHATWG', '#navigatorconcurrenthardware', 'NavigatorConcurrentHardware')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<div> + + +<p>{{Compat("api.NavigatorConcurrentHardware.hardwareConcurrency")}}</p> +</div> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("Navigator")}}</li> + <li>{{domxref("WorkerNavigator")}}</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorconcurrenthardware/index.html b/files/zh-cn/orphaned/web/api/navigatorconcurrenthardware/index.html new file mode 100644 index 0000000000..43e5ae1965 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorconcurrenthardware/index.html @@ -0,0 +1,72 @@ +--- +title: NavigatorConcurrentHardware +slug: orphaned/Web/API/NavigatorConcurrentHardware +tags: + - API + - Concurrency + - HTML DOM + - Interface + - Navigator + - NavigatorCPU + - NavigatorConcurrentHardware + - NeedsBrowserCompatibility + - NeedsTranslation + - Reference + - Threading + - Threads + - TopicStub + - WorkerNavigator + - Workers +translation_of: Web/API/NavigatorConcurrentHardware +original_slug: Web/API/NavigatorConcurrentHardware +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p>The <strong><code>NavigatorConcurrentHardware</code></strong> {{Glossary("mixin")}} adds to the {{domxref("Navigator")}} interface features which allow Web content to determine how many logical processors the user has available, in order to let content and Web apps optimize their operations to best take advantage of the user's CPU.</p> + +<p>{{AvailableInWorkers}}</p> + +<p>The number of <strong>logical processor cores</strong> is a way to measure the number of threads which can effectively be run at once without them having to share CPUs. Modern computers have multiple physical cores in their CPU (two or four cores is typical), but each physical core is also usually able to run more than one thread at a time using advanced scheduling techniques. So a four-core CPU may return 8. The browser may, however, choose to reduce the number in order to represent more accurately the number of {{domxref("Worker")}}s that can run at once</p> + +<h2 id="Properties">Properties</h2> + +<dl> + <dt>{{domxref("NavigatorConcurrentHardware.hardwareConcurrency")}} {{readonlyinline}}</dt> + <dd>Returns the number of logical processors which may be available to the user agent. This value is always at least 1, and will be 1 if the actual number of logical processors can't be determined.</dd> +</dl> + +<h2 id="Methods">Methods</h2> + +<p><em>The <code>NavigatorConcurrentHardware</code></em><em> mixin has no methods.</em></p> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#navigatorconcurrenthardware', 'NavigatorConcurrentHardware')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.NavigatorConcurrentHardware")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("Navigator")}}</li> + <li>{{domxref("WorkerNavigator")}}</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/appcodename/index.html b/files/zh-cn/orphaned/web/api/navigatorid/appcodename/index.html new file mode 100644 index 0000000000..5545fedd6a --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/appcodename/index.html @@ -0,0 +1,37 @@ +--- +title: NavigatorID.appCodeName +slug: orphaned/Web/API/NavigatorID/appCodeName +translation_of: Web/API/NavigatorID/appCodeName +original_slug: Web/API/NavigatorID/appCodeName +--- +<p>{{ ApiRef() }}</p> + +<h3 id="Summary" name="Summary">概述</h3> + +<p>返回所使用浏览器的内部名称.</p> + +<h3 id="Syntax" name="Syntax">语法</h3> + +<pre class="eval">codeName = window.navigator.appCodeName +</pre> + +<h3 id="Parameters" name="Parameters">参数</h3> + +<ul> + <li><code>codeName</code> 是一个字符串,表示浏览器内部名称.</li> +</ul> + +<h3 id="Example" name="Example">例子</h3> + +<pre>dump(window.navigator.appCodeName); +</pre> + +<h3 id="Notes" name="Notes">笔记</h3> + +<p>Mozilla, Netscape 6, 和 IE5 的内部名称都是 "Mozilla".</p> + +<h3 id="Specification" name="Specification">规范</h3> + +<p>{{ DOM0() }}</p> + +<p>{{ languages( { "en": "en/DOM/window.navigator.appCodeName","ja": "ja/DOM/window.navigator.appCodeName", "pl": "pl/DOM/window.navigator.appCodeName" } ) }}</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/appname/index.html b/files/zh-cn/orphaned/web/api/navigatorid/appname/index.html new file mode 100644 index 0000000000..14a1d147b3 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/appname/index.html @@ -0,0 +1,38 @@ +--- +title: NavigatorID.appName +slug: orphaned/Web/API/NavigatorID/appName +translation_of: Web/API/NavigatorID/appName +original_slug: Web/API/NavigatorID/appName +--- +<p>{{ ApiRef() }}</p> + +<h2 id="Summary" name="Summary">概述</h2> + +<p>返回所使用浏览器的名称。由于兼容性问题，HTML5 规范允许该属性返回 "Netscape" 。</p> + +<div class="note"><strong>注意：</strong>该属性并不一定能返回正确的浏览器名称。在基于 Gecko 的浏览器 （例如 Firefox）和基于 WebKit 的浏览器（例如 Chrome 和 Safari）中，返回的浏览器名称都是 "Netscape".</div> + +<h2 id="Syntax" name="Syntax">语法</h2> + +<pre class="eval">appName = window.navigator.appName +</pre> + +<h3 id="Parameters" name="Parameters">返回值</h3> + +<ul> + <li><code>appName</code> 是一个字符串，表示浏览器名称</li> +</ul> + +<h2 id="Example" name="Example">例子</h2> + +<pre class="brush: js">alert(window.navigator.appName); +// 显示浏览器名称 +</pre> + +<h2 id="Specification" name="Specification">规范</h2> + +<ul> + <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li> +</ul> + +<p>该属性起初属于 DOM Level 0 ，目前已经被添加到HTML5规范中。</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/appversion/index.html b/files/zh-cn/orphaned/web/api/navigatorid/appversion/index.html new file mode 100644 index 0000000000..a56fdd8216 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/appversion/index.html @@ -0,0 +1,43 @@ +--- +title: NavigatorID.appVersion +slug: orphaned/Web/API/NavigatorID/appVersion +translation_of: Web/API/NavigatorID/appVersion +original_slug: Web/API/NavigatorID/appVersion +--- +<p>{{APIRef("HTML DOM")}}{{deprecated_header}}</p> + +<h2 id="Summary" name="Summary">概述</h2> + +<p>返回一个字符串，表示所使用浏览器的版本号。它可能只包含一个版本数字，如 "5.0"，还可能包含一些其他的相关信息。由于兼容性问题，HTML5规范允许该属性返回 "4.0"。</p> + +<div class="note"><strong>注意：</strong>该属性并不一定能返回正确的浏览器版本号。在基于 Gecko 的浏览器 （例如 Firefox）和基于 WebKit 的浏览器（例如 Chrome 和 Safari）中，返回的浏览器版本号都是 "5.0"，后跟一些操作系统与语言信息，比如 "5.0 (Windows; zh-CN)"。在Opera 10及以上版本，该属性的返回值也不是实际的浏览器版本号。</div> + +<h2 id="Syntax" name="Syntax">语法</h2> + +<pre class="eval">ver = window.navigator.appVersion +</pre> + +<h3 id="Parameters" name="Parameters">返回值</h3> + +<ul> + <li><code>ver</code> 是一个字符串，表示浏览器版本号。</li> +</ul> + +<h2 id="Example" name="Example">例子</h2> + +<pre class="brush: js">alert("你的浏览器版本为" + navigator.appVersion); +</pre> + +<h2 id="Notes" name="Notes">备注</h2> + +<p><code>window.navigator.userAgent</code> 也包含一些浏览器的版本信息（比如："<code>Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape 6/6.1</code>"），但是你应该知道，修改浏览器的<code>userAgent字符串以及伪造它成为其他的浏览器、其他的操作系统等等是非常容易的。</code>而且，就算不伪造，浏览器提供商也不会保证这些数据就是准确的。</p> + +<p><code>window.navigator.appVersion</code>、<code>window.navigator.appName</code> 和 <code>window.navigator.userAgent </code>等属性都被用来编写一些"浏览器检测"的相关代码：脚本会尝试根据检测出的浏览器类型来相印的调整页面显示。种情况下，用户可以伪造相关的浏览器信息来查看一些本来不允许自己所使用的浏览器或平台查看的页面。</p> + +<h2 id="Specification" name="Specification">规范</h2> + +<ul> + <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li> +</ul> + +<p>该属性最初属于 DOM Level 0，目前已经被添加到 HTML5 规范中。</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/index.html b/files/zh-cn/orphaned/web/api/navigatorid/index.html new file mode 100644 index 0000000000..71bf69349a --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/index.html @@ -0,0 +1,121 @@ +--- +title: NavigatorID +slug: orphaned/Web/API/NavigatorID +translation_of: Web/API/NavigatorID +original_slug: Web/API/NavigatorID +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p><code><strong>NavigatorID</strong></code> 接口包含浏览器识别相关的方法和属性。</p> + +<p>没有一个 <code>NavigatorID</code> 类型的对象，他是其他接口，如 {{domxref("Navigator")}} 或 {{domxref("WorkerNavigator")}} 实现了该接口。</p> + +<h2 id="属性">属性</h2> + +<p><em><code>NavigatorID</code></em><em> 接口没有继承任何属性。</em></p> + +<dl> + <dt>{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}}{{experimental_inline}}</dt> + <dd>任何浏览器中，总是返回 <code>'Gecko'</code>。该属性仅仅是为了保持兼容性。</dd> + <dt>{{domxref("NavigatorID.appName")}} {{readonlyInline}}</dt> + <dd>返回浏览器的官方名称。不要指望该属性返回正确的值。</dd> + <dt>{{domxref("NavigatorID.appVersion")}} {{readonlyInline}}</dt> + <dd>返回一个字符串，表示浏览器的版本。不要指望该属性返回正确的值。</dd> + <dt>{{domxref("NavigatorID.platform")}} {{readonlyInline}}</dt> + <dd>返回一个字符串，表示浏览器的所在系统平台。</dd> + <dt>{{domxref("NavigatorID.product")}} {{readonlyInline}}</dt> + <dd>返回当前浏览器的产品名称（如，"Gecko"）。</dd> + <dt>{{domxref("NavigatorID.userAgent")}} {{readonlyInline}}</dt> + <dd>返回当前浏览器的用户代理字符串（user agent string）。</dd> +</dl> + +<h2 id="方法">方法</h2> + +<p><em><code>NavigatorID</code></em><em> 接口没有继承任何方法。</em></p> + +<dl> + <dt>{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline()}} {{experimental_inline}}</dt> + <dd>总是返回 <code>false</code>。JavaScript taint/untaint 函数在 JavaScript 1.2 中被移除了。该方法只是为了兼容性。</dd> +</dl> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#navigatorid', 'NavigatorID')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Added the <code>appCodeName</code> property and the <code>taintEnabled()</code> method, for compatibility purpose.</td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', '#navigatorid', 'NavigatorID')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td>Initial specification.</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>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Chrome for Android</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>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li>{{domxref("Navigator")}} 实现了该接口。</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/platform/index.html b/files/zh-cn/orphaned/web/api/navigatorid/platform/index.html new file mode 100644 index 0000000000..f1dc21fdea --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/platform/index.html @@ -0,0 +1,36 @@ +--- +title: NavigatorID.platform +slug: orphaned/Web/API/NavigatorID/platform +translation_of: Web/API/NavigatorID/platform +original_slug: Web/API/NavigatorID/platform +--- +<p>{{ ApiRef() }}</p> + +<h3 id="Summary" name="Summary">概述</h3> + +<p>返回一个字符串,表示浏览器所在的系统平台类型.</p> + +<h3 id="Syntax" name="Syntax">语法</h3> + +<pre class="eval"><em>platform</em> = <em>navigator</em>.platform +</pre> + +<p><code>platform</code> 可能是: "Win32", "Linux i686", "MacPPC", "MacIntel", 等.</p> + +<h3 id="Example" name="Example">例子</h3> + +<pre class="brush: js">alert(navigator.platform);</pre> + +<h3 id="Notes" name="Notes">备注</h3> + +<p>在普通网页中,如果about:config中存在<code>general.platform.override</code><code>项,则</code>该属性的值会返回about:config中<code>general.platform.override项的值.</code> 在特权代码中 (chrome上下文或者拥有"UniversalBrowserRead"特权的网页中),返回的还是真实的平台类型.(译者注:语句:netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserRead ")用来激活所在网页的UniversalBrowserRead特权.)</p> + +<h3 id="Specification" name="Specification">规范</h3> + +<ul> + <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li> +</ul> + +<p>该属性由DOM Level 0提出, 目前已经被添加到HTML5规范中.</p> + +<p>{{ languages( {"ja": "ja/DOM/window.navigator.platform", "en": "en/DOM/window.navigator.platform", "pl": "pl/DOM/window.navigator.platform" } ) }}</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/product/index.html b/files/zh-cn/orphaned/web/api/navigatorid/product/index.html new file mode 100644 index 0000000000..aae72af9db --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/product/index.html @@ -0,0 +1,35 @@ +--- +title: NavigatorID.product +slug: orphaned/Web/API/NavigatorID/product +translation_of: Web/API/NavigatorID/product +original_slug: Web/API/NavigatorID/product +--- +<div> + {{ApiRef}}</div> +<h2 id="Summary" name="Summary">概述</h2> +<p>该属性返回当前浏览器的产品名称。</p> +<div class="note"> + <strong>注意：</strong>该属性不一定返回一个真实的产品名称。Gecko 和 WebKit 浏览器返回 "Gecko" 作为该属性的值。</div> +<h2 id="Syntax" name="Syntax">语法</h2> +<pre class="syntaxbox"><i>productName</i> = window.navigator.product +</pre> +<ul> + <li><code>productName</code> 是一个字符串。</li> +</ul> +<h2 id="Example" name="Example">例子</h2> +<pre class="brush: html"><script> +function prod() { + dt = document.getElementById("d"); + dt.innerHTML = window.navigator.product; +} +</script> + +<button onclick="prod();">product</button> +<div id="d"> </div> +<!-- 返回 "Gecko" --> +</pre> +<h2 id="Notes" name="Notes">备注</h2> +<p>在基于 Gecko 的浏览器中，<code>product</code> 为完整的用户代理（user agent）字符串中紧跟着平台（platform）后的部分。例如，在 Netscape 6.1 的用户代理中，product 是 "<code>Gecko</code>"，完整的代理字符串是：<code>Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1</code>。</p> +<p>在基于 WebKit 的浏览器中，<code>product</code> 仍然返回 "<code>Gecko</code>"，即使完整用户代理字符串中平台（platform）后紧跟着：<code>(KHTML, like Gecko)</code>。</p> +<h2 id="Specification" name="Specification">规范</h2> +<p>{{dom0}}</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorid/useragent/index.html b/files/zh-cn/orphaned/web/api/navigatorid/useragent/index.html new file mode 100644 index 0000000000..9652c650da --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorid/useragent/index.html @@ -0,0 +1,80 @@ +--- +title: NavigatorID.userAgent +slug: orphaned/Web/API/NavigatorID/userAgent +translation_of: Web/API/NavigatorID/userAgent +original_slug: Web/API/NavigatorID/userAgent +--- +<div>{{ApiRef("HTML DOM")}}</div> + +<p><code><strong>NavigatorID.userAgent</strong></code> 只读属性返回当前浏览器的 user agent 字符串。</p> + +<div class="note"> +<p>这一规范要求浏览器通过这一属性提供尽可能少的信息。不要假定同一浏览器的这一属性值会在未来的版本中保持不变。尽量不要使用这一属性，或者仅仅在现有和更早的版本中使用。较新的浏览器可能开始使用相同或近似的 UA，对于早期的浏览器而言：你不能确保该浏览器是其 <code><strong>NavigatorID.userAgent</strong></code> 属性所宣称的浏览器。</p> + +<p>另外要记住，用户可以修改浏览器的此属性(UA 欺骗).</p> +</div> + +<p>基于 user agent 字符串来识别浏览器是<strong>不可靠</strong>的，<strong>不推荐使用</strong>，因为 user agent 字符串是用户可配置的。例如：</p> + +<ul> + <li>在 Firefox 浏览器中，你可以通过 <code>about:config</code> 页面的 <code>general.useragent.override</code> 字段修改 user agent。某些 FireFox 插件会更改此字段。 但这个字段只会影响到 http 请求的 header，不影响通过 Javascript 代码检测浏览器。</li> + <li>Opera 6+ 允许用户通过菜单设置浏览器辨识字符。</li> + <li>Microsoft Internet Explorer 通过修改 Windows 注册表修改 UA 。</li> + <li>Safari 和iCab 允许用户通过菜单选项将 UA 值修改为预设的Internet Explorer 或Netscape 浏览器 UA 。</li> +</ul> + +<h2 id="Syntax" name="Syntax">语法</h2> + +<pre class="syntaxbox notranslate">var <var>ua</var> = navigator.userAgent; +</pre> + +<h3 id="Value" name="Value">值</h3> + +<p>{{domxref("DOMString")}} 规定了浏览器提供给 {{Glossary("HTTP")}} headers 和其响应，以及其他与{{domxref("Navigator")}} 相关的方法的完整用户代理属性 。</p> + +<p>用户代理属性由几个信息段组成一个整齐的结构，每个信息段都取值于其他 {{domxref("Navigator")}} 属性，这些属性也可以是用户设置的。基于 Gecko 内核的浏览器的 UA 遵守下列通用结构规范。</p> + +<pre class="notranslate">userAgent = appCodeName/appVersion number (Platform; Security; OS-or-CPU; +Localization; rv: revision-version-number) product/productSub +Application-Name Application-Name-version +</pre> + +<h2 id="Example" name="Example">例子</h2> + +<pre class="brush:js notranslate">alert(window.navigator.userAgent) +// alerts "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1" +</pre> + +<ul> +</ul> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#dom-navigator-useragent', 'NavigatorID.userAgent')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.NavigatorID.userAgent")}}</p> + +<h2 id="See_also" name="See_also">更多</h2> + +<ul> + <li>{{httpheader("User-Agent")}} HTTP header</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorlanguage/index.html b/files/zh-cn/orphaned/web/api/navigatorlanguage/index.html new file mode 100644 index 0000000000..fdd35b2c8b --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorlanguage/index.html @@ -0,0 +1,69 @@ +--- +title: NavigatorLanguage +slug: orphaned/Web/API/NavigatorLanguage +tags: + - API + - HTML-DOM + - NeedsTranslation + - No Interface + - Reference + - TopicStub +translation_of: Web/API/NavigatorLanguage +original_slug: Web/API/NavigatorLanguage +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p><code><strong>NavigatorLanguage</strong></code> 包含涉及导航（<code><strong>Navigator</strong></code>）的语言特性的方法和属性。</p> + +<p>其实 <code>NavigatorLanguage</code> 这个对象并不存在，但是，一些其它的接口，如 {{domxref("Navigator")}} 或 {{domxref("WorkerNavigator")}}，实现了它。</p> + +<h2 id="属性">属性</h2> + +<p><em><code>NavigatorLanguage</code></em><em> 接口不继承任何属性。</em></p> + +<dl> + <dt>{{domxref("NavigatorLanguage.language")}} {{readonlyInline}}</dt> + <dd>返回一个 {{domxref("DOMString")}} 代表用户的首选语言，通常是浏览器 UI 的语言。若返回 <code>null</code> 值，则代表语言未知。</dd> + <dt>{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}}</dt> + <dd>返回一个 {{domxref("DOMString")}} 数组，代表用户已知的语言，不同语言按照谁更佳排序。</dd> +</dl> + +<h2 id="方法">方法</h2> + +<p><em><code>NavigatorLanguage</code></em><em> 接口不依赖任何接口和方法。</em></p> + +<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('HTML WHATWG', '#navigatorlanguage', 'NavigatorLanguage')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>从 {{SpecName('HTML5 W3C')}} 出现开始，<code>languages</code> 属性已经被添加。</td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', '#navigatorlanguage', 'NavigatorLanguage')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td>初始标准；出现在 {{SpecName('HTML WHATWG')}} 的早期版本。</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.NavigatorLanguage")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li>实现本对象的 {{domxref("Navigator")}} 接口。</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorlanguage/language/index.html b/files/zh-cn/orphaned/web/api/navigatorlanguage/language/index.html new file mode 100644 index 0000000000..c9e6e3615e --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorlanguage/language/index.html @@ -0,0 +1,65 @@ +--- +title: NavigatorLanguage.language +slug: orphaned/Web/API/NavigatorLanguage/language +tags: + - API + - NavigatorLanguage + - 参考 + - 只读 + - 多语言 + - 属性 + - 语言 +translation_of: Web/API/NavigatorLanguage/language +original_slug: Web/API/NavigatorLanguage/language +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p><strong><code>NavigatorLanguage.language</code></strong> 只读属性返回一个表示用户偏好语言的字符串，通常指浏览器 UI 的语言。</p> + +<h2 id="语法">语法</h2> + +<pre class="brush: js"><em>let lang</em> = navigator.language; +</pre> + +<h3 id="值">值</h3> + +<p>一个 {{domxref("DOMString")}}。<code>lang</code> 存储一个表示语言版本（在 <a href="http://www.ietf.org/rfc/bcp/bcp47.txt">BCP 47</a> 中定义）的字符串。合法的语言版本有 "zh-CN"、"en"、"en-US"、"fr"、"es-ES" 等。</p> + +<p>注意 macOS 和 iOS 平台上的 Safari（10.2 之前版本），国家代码为小写："zh-cn"、"en-us"、"fr-fr" 等。</p> + +<h2 id="示例">示例</h2> + +<pre class="brush: js">if ( window.navigator.language != 'zh-CN' ) { + doLangSelect(window.navigator.language); +} +</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('HTML WHATWG', '#dom-navigator-language', 'NavigatorLanguage: language')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>初次定义</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<p>{{Compat("api.NavigatorLanguage.language")}}</p> + +<h2 id="另请参阅">另请参阅</h2> + +<ul> + <li>{{domxref("NavigatorLanguage.languages", "navigator.languages")}}</li> + <li>{{domxref("navigator")}}</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorlanguage/languages/index.html b/files/zh-cn/orphaned/web/api/navigatorlanguage/languages/index.html new file mode 100644 index 0000000000..127403a1f9 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorlanguage/languages/index.html @@ -0,0 +1,65 @@ +--- +title: NavigatorLanguage.languages +slug: orphaned/Web/API/NavigatorLanguage/languages +tags: + - API + - languages + - 只读 + - 实验性 + - 属性 +translation_of: Web/API/NavigatorLanguage/languages +original_slug: Web/API/NavigatorLanguage/languages +--- +<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p> + +<p><code><strong>NavigatorLanguage.languages </strong></code>只读属性 ，返回一个 {{domxref("DOMString")}} 的数组，数组内容表示网站访客所使用的语言。 使用 <a href="http://tools.ietf.org/html/bcp47">BCP 47</a> 语言标签来描述不同的语言。 在返回的数组中，最适合当前用户的语言将会被排到数组的首位。</p> + +<p>{{domxref("NavigatorLanguage.language","navigator.language")}} 的值是该属性返回数组的第一个元素 [3]。（但它基于系统语言设置。）</p> + +<p>当该值发生改变，即最适合用户的语言被改变， 事件{{event("languagechange")}} 将会在 {{domxref("Window")}} 对象下触发。</p> + +<p>在每一个HTTP请求上的来自用户浏览器的HTTP协议头 <code>Accept-Language</code> 使用相同的来自 <code>navigator.languages</code> 属性的语言值，除了特殊的 <code>qvalues</code> （权重值） 字段 （如：<code>en-US;q=0.8）。</code></p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox notranslate"><em>preferredLanguages</em> = <em>globalObj</em>.navigator.languages +</pre> + +<h2 id="例子">例子</h2> + +<pre class="brush: js notranslate">navigator.language //"en-US" +navigator.languages //["en-US", "zh-CN", "ja-JP"] +</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('HTML5.1', '#dom-navigator-languages', 'NavigatorLanguage.languages') }}</td> + <td>{{ Spec2('HTML5.1') }}</td> + <td> + <p>初始化定义</p> + </td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + + + +<p>{{Compat("api.NavigatorLanguage.languages")}}</p> + +<h2 id="参见">参见</h2> + +<ul> + <li>{{domxref("NavigatorLanguage.language","navigator.language")}}</li> + <li>{{domxref("Navigator")}}</li> + <li>{{domxref("Window.onlanguagechange")}}</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatoronline/index.html b/files/zh-cn/orphaned/web/api/navigatoronline/index.html new file mode 100644 index 0000000000..b2a7f14cc9 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatoronline/index.html @@ -0,0 +1,127 @@ +--- +title: NavigatorOnLine +slug: orphaned/Web/API/NavigatorOnLine +tags: + - API + - HTML-DOM + - TopicStub +translation_of: Web/API/NavigatorOnLine +original_slug: Web/API/NavigatorOnLine +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p><code><strong>NavigatorOnLine</strong></code>接口包含了与浏览器网络连接状态相关的方法和属性。</p> + +<p>不存在<code>NavigatorOnLine类型的对象，</code>但是存在其他的接口，比如 {{domxref("Navigator")}} 或者 {{domxref("WorkerNavigator")}}，可以实现它。</p> + +<h2 id="属性">属性</h2> + +<p><em><code>NavigatorOnLine</code></em><em> 接口并不能继承任何属性。</em></p> + +<dl> + <dt>{{domxref("NavigatorOnLine.onLine")}} {{readonlyInline}}</dt> + <dd>返回一个 {{domxref("Boolean")}} 值指示浏览器是否为在线状态。</dd> +</dl> + +<h2 id="方法">方法</h2> + +<p><em><code>NavigatorOnLine</code></em><em> 接口既不能实现，也不能继承任何方法。</em></p> + +<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('HTML WHATWG', '#navigatoronline', 'NavigatorOnLine')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>对比最近的简况没有变化, {{SpecName('HTML5 W3C')}}</td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C', '#navigatoronline', 'NavigatorOnLine')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td>{{SpecName('HTML WHATWG')}} 原始标准的简况.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>特征</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>基本支持</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + <tr> + <td>在{{domxref("WorkerNavigator")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop(29)}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>特征</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>基本支持</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + <tr> + <td> {{domxref("WorkerNavigator")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile(29)}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="浏览相关">浏览相关</h2> + +<ul> + <li>可以实现它的 {{domxref("Navigator")}} 接口。</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatoronline/online/index.html b/files/zh-cn/orphaned/web/api/navigatoronline/online/index.html new file mode 100644 index 0000000000..ffc33f9d7a --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatoronline/online/index.html @@ -0,0 +1,88 @@ +--- +title: NavigatorOnLine.onLine +slug: orphaned/Web/API/NavigatorOnLine/onLine +tags: + - API + - DOM Reference +translation_of: Web/API/NavigatorOnLine/onLine +original_slug: Web/API/NavigatorOnLine/onLine +--- +<p>{{ApiRef("HTML DOM")}}</p> + +<p>返回浏览器的联网状态。正常联网（在线）返回 <code>true</code>，不正常联网（离线）返回 <code>false</code>。一旦浏览器的联网状态发生改变，该属性值也会随之变化。当用户点击链接或者脚本进行网络请求时，如果发现浏览器连接不上互联网，则该属性会被赋值为<code>false</code>。</p> + +<p>各浏览器对该属性的实现有些不同。</p> + +<p>在 Chrome 和 Safari 中，如果浏览器连接不上局域网（LAN）或者路由器，就是离线状态；否则就是在线状态。所以当该属性值为 <code>false </code>的时候，你可以说浏览器不能正常联网，但如果该属性值为true的时候，并不意味着浏览器一定能连接上互联网。还有其他一些可能引起误判的原因，比如你的电脑安装了虚拟化软件，可能会有一个虚拟网卡，这时它总是会显示正常联网。因此，如果你想得到浏览器确切的联网状态，应该使用其他额外的检查手段。</p> + +<p>在 Firefox 和 Internet Explorer 中，如果浏览器处于"脱机工作"状态，则返回 <code>false</code>。在 Firefox 41之前，所有其他条件都返回 <code>true</code> 值；在 Windows 上的 Nightly 68上测试实际行为表明，它仅查找类似 Chrome 和 Safari 的 LAN 连接，从而产生误报。</p> + +<p>你可以在 <a href="/zh-CN/docs/Web/API/document.ononline"><code>window.ononline</code></a> 和 <a href="/zh-CN/docs/Web/API/document.onoffline"><code>window.onoffline</code></a>上监听事件，来获取浏览器联网状态的改变情况。</p> + +<h2 id="语法">语法</h2> + +<pre><em>online</em> = <em>window</em>.navigator.onLine; +</pre> + +<h3 id="取值">取值</h3> + +<p><code>online</code> 是个布尔值 <code>true</code> 或 <code>false。</code></p> + +<h2 id="示例">示例</h2> + +<p>查看 <a class="external" href="http://html5-demos.appspot.com/static/navigator.onLine.html">在线演示</a>.</p> + +<p>想要查看你是否连接上了互联网，查询 <code>window.navigator.onLine</code> 的值，如下方示例：</p> + +<pre class="brush: js">if (navigator.onLine) { + alert('online') +} else { + alert('offline'); +} +</pre> + +<p>如果浏览器不支持 <code>navigator.onLine</code>，则上面的示例将始终显示为 <code>false</code> / <code>undefined</code>。</p> + +<p>要查看网络状态的变化，请使用 <code><a href="/zh-CN/docs/DOM/element.addEventListener">addEventListener</a></code> 侦听 <code>window.online</code> 和 <code>window.offline</code> 事件，如以下示例所示：</p> + +<pre class="brush: js">window.addEventListener("offline", function(e) {alert("offline");}) + +window.addEventListener("online", function(e) {alert("online");}) +</pre> + +<h2 id="规范">规范</h2> + +<table> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName("HTML WHATWG", "browsers.html#dom-navigator-online", "navigator.onLine")}}</td> + <td>{{Spec2("HTML WHATWG")}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("api.NavigatorOnLine.onLine")}}</p> + +<h2 id="备注">备注</h2> + +<p>See <a href="https://wiki.developer.mozilla.org/en-US/docs/Online_and_offline_events">Online/Offline Events</a> for a more detailed description of this property as well as new offline-related features introduced in Firefox 3.</p> + +<h2 id="查看更多">查看更多</h2> + +<ul> + <li><a href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html">HTML5 Rocks: Working Off the Grid With HTML5 Offline</a></li> + <li><a href="http://www.html5rocks.com/en/tutorials/offline/whats-offline/">HTML5 Rocks: "Offline": What does it mean and why should I care?</a></li> + <li><a href="http://hacks.mozilla.org/2010/01/offline-web-applications/">Mozilla Blog: Offline Web Applications</a></li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatoronline/online_and_offline_events/index.html b/files/zh-cn/orphaned/web/api/navigatoronline/online_and_offline_events/index.html new file mode 100644 index 0000000000..8b873aad6c --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatoronline/online_and_offline_events/index.html @@ -0,0 +1,120 @@ +--- +title: 在线和离线事件 +slug: orphaned/Web/API/NavigatorOnLine/Online_and_offline_events +tags: + - AJAX + - DOM + - HTML5 + - Web 开发 + - 离线 web 应用 +translation_of: Web/API/NavigatorOnLine/Online_and_offline_events +original_slug: Web/API/NavigatorOnLine/Online_and_offline_events +--- +<p>部分浏览器根据 <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/">WHATWG Web Applications 1.0 规范</a> 实现了<a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#offline">Online/Offline 事件</a>。</p> + +<h3 id="Overview" name="Overview">概述</h3> + +<p>为了构建一个支持离线的 web 应用，你需要知道你的应用何时真正处于离线状态。同时，你还需要知道应用何时重新回到了「在线」状态。实际上，我们可以把需求分解成如下内容：</p> + +<ol> + <li>你需要知道用户何时回到在线状态，这样你就可以与服务器重新同步。</li> + <li>你需要知道用户何时处于离线状态，这样你就可以将对服务器的请求放入队列中以便稍后使用。</li> +</ol> + +<p>这便是在线/离线事件所要处理的过程。</p> + +<p>你的 web 应用可能需要使得某个特定的文档在离线资源缓存中得到维护。 你可以在 <a href="/en/Offline_resources_in_Firefox" title="en/Offline_resources_in_Firefox">Firefox 中的离线资源</a> 这篇文章中了解到更多内容。</p> + +<h3 id="API" name="API">API</h3> + +<h4 id="navigator.onLine" name="navigator.onLine"><code>navigator.onLine</code></h4> + +<p><code><a href="/en/DOM/window.navigator.onLine" title="en/DOM/window.navigator.onLine">navigator.onLine</a></code> 是一个值为 <code>true</code>/<code>false</code> (<code>true</code> 表示在线， <code>false</code> 表示离线) 的属性。当用户通过选择对应的菜单项 (Firefox 中为 文件 -> 离线工作) 切换到「离线模式」时，这个值就会被更新。</p> + +<p>此外，当浏览器长时间无法连接到网络时，该值也会被更新。根据如下规范：</p> + +<blockquote cite="http://www.whatwg.org/specs/web-apps/current-work/#offline"><code>由于用户点击一个链接或是脚本请求一个远程页面(或者类似的操作失败了)从而导致户代理无法访问网络时， navigator.onLine</code> 属性返回 false ...</blockquote> + +<p>在 Firefox 2 中，当在浏览器的离线模式中来回切换时会更新该属性。 Windows, Linux, 和 OS X 上的 <a href="https://developer.mozilla.org/en-US/Firefox/Releases/41#Miscellaneous">Firefox 41</a> 会在操作系统报告网络连接变化时更新该属性。</p> + +<p>该属性存在于旧版本的 Firefox 与 Internet Explorer (规范就是以这些旧有实现为基础)，因此你现在就可以使用该属性。Firefox 2实现了网络状态自动检测。</p> + +<h4 id=".22online.22_and_.22offline.22_events" name=".22online.22_and_.22offline.22_events"><code>「online」与「</code><code>offline」</code> 事件</h4> + +<p><a href="/en/Firefox_3_for_developers" title="en/Firefox_3_for_developers">Firefox 3</a> 引入了两个新事件：「<code>online」与「</code><code>offline」。当浏览器从在线与离线状态中切换时，这两个事件会在页面的</code> <code><body></code> 上触发。此外，该事件会从 <code>document.body 冒泡到</code> <code>document 上，最后到达</code> <code>window。两个事件都无法被取消</code>(你无法阻止用户进入在线或离线状态)。</p> + +<p>你可以使用几种熟悉的方式来注册事件：</p> + +<ul> + <li>在 <code>window，</code><code>document，或<font face="Lucida Grande, Lucida Sans Unicode, DejaVu Sans, Lucida, Arial, Helvetica, sans-serif"><span style="line-height: 21px;"> </span></font></code><code>document.body 上使用 </code><code style="font-size: 14px;"><a href="/en/DOM/element.addEventListener" title="en/DOM/element.addEventListener">addEventListener</a></code></li> + <li>将 <code style="font-size: 14px;">document</code> 或 <code style="font-size: 14px;">document.body 的</code> <code>.ononline</code> 或 <code>.onoffline</code> 属性设置为一个 JavaScript <code>Function</code> 对象。(<strong>注意：</strong>由于兼容性原因，不能使用 <code>window.ononline</code> 或 <code>window.onoffline</code>。)</li> + <li>在 HTML 标记中的 <code style="font-size: 14px;"><body> 标签上指定</code> <code>ononline="..."</code> 或 <code>onoffline="..."</code> 特性。</li> +</ul> + +<h3 id="Example" name="Example">示例</h3> + +<p>运行这个<a class="link-https" href="https://bugzilla.mozilla.org/attachment.cgi?id=220609">简单的例子</a>来验证事件。</p> + +<p>这是 JavaScript 部分的代码：</p> + +<pre class="brush: js">window.addEventListener('load', function() { + var status = document.getElementById("status"); + var log = document.getElementById("log"); + + function updateOnlineStatus(event) { + var condition = navigator.onLine ? "online" : "offline"; + + status.className = condition; + status.innerHTML = condition.toUpperCase(); + + log.insertAdjacentHTML("beforeend", "Event: " + event.type + "; Status: " + condition); + } + + window.addEventListener('online', updateOnlineStatus); + window.addEventListener('offline', updateOnlineStatus); +});</pre> + +<p>再加上一点儿 CSS</p> + +<pre class="brush: css">#status { + position: fixed; + width: 100%; + font: bold 1em sans-serif; + color: #FFF; + padding: 0.5em; +} + +#log { + padding: 2.5em 0.5em 0.5em; + font: 1em sans-serif; +} + +.online { + background: green; +} + +.offline { + background: red; +} +</pre> + +<p>对应的 HTML<span class="comment">XXX When mochitests for this are created, point to those instead and update this example -nickolay</span></p> + +<pre class="brush: html"><div id="status"></div> +<div id="log"></div> +<p>This is a test</p> +</pre> + +<h3 id="References" name="References">注意</h3> + +<p>如果浏览器没有实现该 API，你可以使用其他方式来检测是否离线，包括 <a class="external" href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html#toc-appcache">AppCache 错误事件</a> 和 <a class="external" href="http://www.html5rocks.com/en/mobile/workingoffthegrid.html#toc-xml-http-request">XMLHttpRequest 的响应</a>。</p> + +<h3 id="References" name="References">参考</h3> + +<ul> + <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#offline">'Online/Offline events' section from the WHATWG Web Applications 1.0 Specification</a></li> + <li><a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=336359">The bug tracking online/offline events implementation in Firefox</a> and a <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=336682">follow-up</a></li> + <li><a class="link-https" href="https://bugzilla.mozilla.org/attachment.cgi?id=220609">A simple test case</a></li> + <li><a class="external" href="http://ejohn.org/blog/offline-events/">An explanation of Online/Offline events</a></li> + <li><a class="external" href="http://hacks.mozilla.org/2010/01/offline-web-applications/" title="http://hacks.mozilla.org/2010/01/offline-web-applications/">offline web applications</a> at hacks.mozilla.org - showcases an offline app demo and explains how it works.</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorplugins/index.html b/files/zh-cn/orphaned/web/api/navigatorplugins/index.html new file mode 100644 index 0000000000..3b0afd6396 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorplugins/index.html @@ -0,0 +1,106 @@ +--- +title: NavigatorPlugins +slug: orphaned/Web/API/NavigatorPlugins +translation_of: Web/API/NavigatorPlugins +original_slug: Web/API/NavigatorPlugins +--- +<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p> + +<p>The <code><strong>NavigatorPlugins</strong></code> interface contains methods and properties related to the plugins installed in the browser.</p> + +<p>There is no object of type <code>NavigatorPlugins</code>, but other interfaces, like {{domxref("Navigator")}}, implement it.</p> + +<h2 id="Properties">Properties</h2> + +<dl> + <dt>{{domxref("NavigatorPlugins.mimeTypes")}} {{readonlyInline}}{{experimental_inline}}</dt> + <dd>Returns an {{domxref("MimeTypeArray")}} listing the MIME types supported by the browser.</dd> + <dt>{{domxref("NavigatorPlugins.plugins")}} {{readonlyInline}}{{experimental_inline}}</dt> + <dd>Returns a {{domxref("PluginArray")}} listing the plugins installed in the browser.</dd> +</dl> + +<h2 id="Methods">Methods</h2> + +<p><em>The <code>NavigatorPlugins</code></em><em> interface doesn't inherit any method.</em></p> + +<dl> + <dt>{{domxref("NavigatorPlugins.javaEnabled")}} {{readonlyInline}}{{experimental_inline}}</dt> + <dd>Returns a {{domxref("Boolean")}} flag indicating whether the host browser is Java-enabled or not.</dd> +</dl> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#navigatorplugins', 'NavigatorPlugins')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Basic support</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Chrome for Android</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>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="See_also">See also</h2> + +<ul> + <li>The {{domxref("Navigator")}} interface that implements it.</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorplugins/javaenabled/index.html b/files/zh-cn/orphaned/web/api/navigatorplugins/javaenabled/index.html new file mode 100644 index 0000000000..746b108c8e --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorplugins/javaenabled/index.html @@ -0,0 +1,31 @@ +--- +title: NavigatorPlugins.javaEnabled +slug: orphaned/Web/API/NavigatorPlugins/javaEnabled +translation_of: Web/API/NavigatorPlugins/javaEnabled +original_slug: Web/API/NavigatorPlugins/javaEnabled +--- +<p>{{ APIRef("HTML DOM") }}</p> + +<h3 id="Summary" name="Summary">概述</h3> + +<p>该方法用来表明当前浏览器是否激活了Java.</p> + +<h3 id="Syntax" name="Syntax">语法</h3> + +<pre class="eval"><em>result</em> = window.navigator.javaEnabled() +</pre> + +<h3 id="Example" name="Example">例子</h3> + +<pre class="eval">if (window.navigator.javaEnabled()) { + // 浏览器中Java可用 +} +</pre> + +<h3 id="Notes" name="Notes">备注</h3> + +<p>该方法的返回值是用来表明浏览器的当前配置文件是否允许使用Java的, 而不是表明浏览器是否支持Java(安装有Java插件).</p> + +<h3 id="Specification" name="Specification">规范</h3> + +<p>{{ DOM0() }}</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorplugins/mimetypes/index.html b/files/zh-cn/orphaned/web/api/navigatorplugins/mimetypes/index.html new file mode 100644 index 0000000000..5b199ae666 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorplugins/mimetypes/index.html @@ -0,0 +1,40 @@ +--- +title: NavigatorPlugins.mimeTypes +slug: orphaned/Web/API/NavigatorPlugins/mimeTypes +translation_of: Web/API/NavigatorPlugins/mimeTypes +original_slug: Web/API/NavigatorPlugins/mimeTypes +--- +<div>{{ ApiRef("HTML DOM") }}</div> + +<div> </div> + +<h2 id="Summary" name="Summary">概述</h2> + +<p>返回一个{{domxref("MimeTypeArray")}}对象，其中包含可被当前浏览器识别的{{domxref("MimeType")}}对象的列表。</p> + +<h2 id="Syntax" name="Syntax">语法</h2> + +<pre class="syntaxbox"><var>mimeTypes</var> = navigator.mimeTypes; +</pre> + +<p><code>mimeTypes</code> 是一个 <code>MimeTypeArray</code> 对象，其中含有 <code>length</code> 属性、<code>item(index)</code> 和 <code>namedItem(name)</code> 方法。</p> + +<h2 id="Example" name="Example">示例</h2> + +<pre class="brush:js">function isJavaPresent() { + return 'application/x-java-applet' in navigator.mimeTypes; +} + +function getJavaPluginDescription() { + var mimetype = navigator.mimeTypes['application/x-java-applet']; + if (mimetype === undefined) { + // no Java plugin present + return undefined; + } + return mimetype.enabledPlugin.description; +} +</pre> + +<h2 id="Specification" name="Specification">Specification</h2> + +<p><em>mimeTypes 并未包含在任何规范中。</em></p> diff --git a/files/zh-cn/orphaned/web/api/navigatorplugins/plugins/index.html b/files/zh-cn/orphaned/web/api/navigatorplugins/plugins/index.html new file mode 100644 index 0000000000..a93bb6741c --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorplugins/plugins/index.html @@ -0,0 +1,96 @@ +--- +title: NavigatorPlugins.plugins +slug: orphaned/Web/API/NavigatorPlugins/plugins +tags: + - API + - DOM + - Navigator + - NavigatorPlugins + - Reference +translation_of: Web/API/NavigatorPlugins/plugins +original_slug: Web/API/NavigatorPlugins/plugins +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p>返回一个 {{ domxref("PluginArray") }} 类型的对象, 包含了当前所使用的浏览器安装的所有插件。</p> + +<div class="blockIndicator note"> +<p>在Firefox 29及之后的版本，出于隐私考虑，<code>navigator.plugins</code> 数组的枚举可能会被限制。如果一定要检查是否存在某个浏览器插件，应该用准确的插件名字查询 <code>navigator.plugins</code> 或 {{DOMxRef("navigator.mimeTypes")}} ，而不是枚举 <code>navigator.plugins</code> 数组，再对比每个插件的名字。 这项有关隐私的改变不会禁用任何插件，只是将插件名字从枚举中隐藏了而已。</p> +</div> + +<h2 id="Syntax" name="Syntax">语法</h2> + +<pre class="eval"><em>plugins</em> = navigator.plugins; +</pre> + +<p><code>plugins</code> 是一个 {{DOMxRef("PluginArray")}} 对象，通过名字或项目列表获取 {{DOMxRef("Plugin")}} 对象。</p> + +<p>返回值不是一个普通的JavaScript数组，但是它也有 <code>length</code> 属性,也可以使用<code>plugins</code>[<code><em>index</em></code>]来获取到每个元素的值, 例如(<code>plugins{{ mediawiki.external("2") }}</code>), 效果和使用 <code>item(<em>index</em>)</code> 以及 <code>namedItem(<em>"name"</em>)</code> 是一样的.</p> + +<h2 id="Example" name="Example">示例</h2> + +<p>下述示例中的函数返回Shockwave Flash插件的版本。</p> + +<pre>function getFlashVersion() { + var flash = navigator.plugins.namedItem('Shockwave Flash'); + if (typeof flash != 'object') { + // flash is not present + return undefined; + } + if(flash.version){ + return flash.version; + } else { + //No version property (e.g. in Chrome) + return flash.description.replace(/Shockwave Flash /,""); + } +} +</pre> + +<p>下述示例可显示已安装插件的信息。</p> + +<pre>var pluginsLength = navigator.plugins.length; + +document.body.innerHTML = pluginsLength + " Plugin(s)<br>" + + '<table id="pluginTable"><thead>' + +'<tr><th>Name</th><th>Filename</th><th>description</th><th>version</th></tr>' + +'</thead><tbody></tbody></table>'; + +var table = document.getElementById('pluginTable'); + +for(var i = 0; i < pluginsLength; i++) { + let newRow = table.insertRow(); + newRow.insertCell().textContent = navigator.plugins[i].name; + newRow.insertCell().textContent = navigator.plugins[i].filename; + newRow.insertCell().textContent = navigator.plugins[i].description; + newRow.insertCell().textContent = navigator.plugins[i].version?navigator.plugins[i].version:""; +} +</pre> + +<h2 id="Notes" name="Notes">备注</h2> + +<p>{{DOMxRef("Plugin")}}对象提供一个小型接口，用于获取浏览器中安装的各种插件的信息。你也可以进入 <code>about:plugins</code> 页面，来查看浏览器上安装的插件（Chrome已移除该入口）。</p> + +<h2 id="规范">规范</h2> + +<table> + <thead> + <tr> + <th scope="col">规范</th> + <th scope="col">状态</th> + <th scope="col">注释</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG', '#dom-navigator-plugins', 'NavigatorPlugins.plugins')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<p>{{Compat("api.NavigatorPlugins.plugins")}}</p> + +<p>In addition to listing each plugin as a pseudo-array by zero-indexed numeric properties, Firefox provides properties that are the plugin name directly on the <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/API/PluginArray">PluginArray</a> object.</p> diff --git a/files/zh-cn/orphaned/web/api/navigatorstorage/index.html b/files/zh-cn/orphaned/web/api/navigatorstorage/index.html new file mode 100644 index 0000000000..bc0ef8ba92 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorstorage/index.html @@ -0,0 +1,71 @@ +--- +title: NavigatorStorage +slug: orphaned/Web/API/NavigatorStorage +tags: + - API + - Interface + - Mixin + - Navigator + - NavigatorStorage + - NeedsTranslation + - Reference + - Secure context + - Storage + - Storage Standard + - TopicStub + - WorkerNavigator +translation_of: Web/API/NavigatorStorage +original_slug: Web/API/NavigatorStorage +--- +<p>{{securecontext_header}}{{APIRef("Storage")}}</p> + +<p>The <strong><code>NavigatorStorage</code></strong> {{Glossary("mixin")}} adds to the {{domxref("Navigator")}} and {{domxref("WorkerNavigator")}} interfaces the {{domxref("Navigator.storage")}} property, which provides access to the {{domxref("StorageManager")}} singleton used for controlling the persistence of data stores as well as obtaining information</p> + +<p>{{AvailableInWorkers}}</p> + +<p>There are many APIs which provide ways for Web content to store data on a user's computer, including {{Glossary("cookies")}}, the Web Storage API ({{domxref("Window.localStorage")}} and {{domxref("Window.sessionStorage")}}), and <a href="/en-US/docs/Web/API/IndexedDB_API">IndexedDB</a>. The Storage Standard is designed to serve as a common basis for the implementation of all of those APIs and storage technologies, so that their constraints and configurations can be understood and controlled using a common set of methods and properties.</p> + +<h2 id="Properties">Properties</h2> + +<dl> + <dt>{{domxref("NavigatorStorage.storage", "storage")}} {{readonlyinline}}{{securecontext_inline}}</dt> + <dd>Returns the {{domxref("StorageManager")}} singleton object which is used to access the Storage Manager. Through the returned object, you can control persistence of data stores as well as get estimates of how much space is left for your site or appliation to store data.</dd> +</dl> + +<h2 id="Methods">Methods</h2> + +<p><em>The <code>NavigatorStorage</code></em><em> mixin has no methods.</em></p> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('Storage')}}</td> + <td>{{Spec2('Storage')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility">Browser compatibility</h2> + + + +<p>{{Compat("api.NavigatorStorage")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li>{{domxref("Navigator")}}</li> + <li>{{domxref("navigator.storage")}}</li> + <li>{{domxref("WorkerNavigator")}}</li> + <li>{{domxref("StorageManager")}}</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/navigatorstorage/storage/index.html b/files/zh-cn/orphaned/web/api/navigatorstorage/storage/index.html new file mode 100644 index 0000000000..bfd2cc93d6 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/navigatorstorage/storage/index.html @@ -0,0 +1,57 @@ +--- +title: NavigatorStorage.storage +slug: orphaned/Web/API/NavigatorStorage/storage +tags: + - API + - Navigator + - WorkerNavigator + - 存储 + - 安全上下文 + - 属性 +translation_of: Web/API/NavigatorStorage/storage +original_slug: Web/API/NavigatorStorage/storage +--- +<p>{{securecontext_header}}{{APIRef("Storage")}}</p> + +<p><span class="seoSummary"> <code><strong>NavigatorStorage.storage</strong></code> 是一个只读属性，返回单例 {{domxref("StorageManager")}} 对象，用于访问当前网站或应用程序的浏览器整体存储功能的。 </span>通过返回的对象，您可以检查和配置数据存储的持久性，并了解您的浏览器使用的大约多少空间用于本地存储。</p> + +<h2 id="语法">语法</h2> + +<pre class="syntaxbox">var <em>storageManager</em> = navigator.storage; +</pre> + +<h3 id="返回值">返回值</h3> + +<p>返回 {{domxref("StorageManager")}} 您可以用来维护数据的持久化存储，以及大致确定有多少空间来存储数据。</p> + +<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('Storage', '#navigatorstorage', 'navigator.storage')}}</td> + <td>{{Spec2('Storage')}}</td> + <td>Initial definition.</td> + </tr> + </tbody> +</table> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<div> +<p>{{Compat("api.NavigatorStorage.storage")}}</p> +</div> + +<h2 id="相关链接">相关链接</h2> + +<ul> + <li>{{domxref("NavigatorStorage")}}</li> + <li>{{domxref("StorageManager")}}</li> + <li>{{domxref("Navigator")}}</li> + <li>{{domxref("WorkerNavigator")}}</li> +</ul> diff --git a/files/zh-cn/orphaned/web/api/xdomainrequest/index.html b/files/zh-cn/orphaned/web/api/xdomainrequest/index.html new file mode 100644 index 0000000000..a9d7eaf905 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/xdomainrequest/index.html @@ -0,0 +1,187 @@ +--- +title: XDomainRequest +slug: orphaned/Web/API/XDomainRequest +tags: + - AJAX + - API + - IE + - JavaScript + - Web + - 废弃 + - 微软 + - 非标准 +translation_of: Web/API/XDomainRequest +original_slug: Web/API/XDomainRequest +--- +<p>{{obsolete_header}}</p> + +<p>{{non-standard_header}}</p> + +<h2 id="摘要">摘要</h2> + +<p><span style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;">XDomainRequest是在IE8和IE9上的</span><a href="/en-US/docs/HTTP/Access_control_CORS" style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;">HTTP access control (CORS) </a>的实现，在IE10中被<span style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;"> 包含CORS的</span><a href="/en-US/docs/Web/API/XMLHttpRequest" style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;">XMLHttpRequest </a>取代了，如果你的开发目标是IE10或IE的后续版本，或想要支待其他的浏览器，你需要使用标准的<a href="/en-US/docs/Web/HTTP/Access_control_CORS" style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;">HTTP access control</a>。</p> + +<p>该接口可以发送GET和POST请求</p> + +<h2 id="语法">语法</h2> + +<pre>var xdr = new XDomainRequest();</pre> + +<p>返回<span style="font-family: Consolas,Monaco,'Andale Mono',monospace; font-size: 14.4444446563721px; line-height: 23.3333339691162px;">XDomainRequest的实例，该实例可以被用来生成或管理请求。</span></p> + +<h2 id="属性">属性</h2> + +<dl> + <dt>{{domxref("XDomainRequest.timeout")}}</dt> + <dd>获取或设置请求的过期时间。</dd> + <dt>{{domxref("XDomainRequest.responseText")}}</dt> + <dd>以字符串形式获取响应体。</dd> +</dl> + +<h2 id="方法">方法</h2> + +<dl> + <dt>{{domxref("XDomainRequest.open()")}}</dt> + <dd>根据指定的方法（GET或POST）和URL，打开请求。</dd> + <dt>{{domxref("XDomainRequest.send()")}}</dt> + <dd>发送请求。POST的数据会在该方法中被指定。</dd> + <dt>{{domxref("XDomainRequest.abort()")}}</dt> + <dd>中止请求。</dd> +</dl> + +<h2 id="事件处理程序">事件处理程序</h2> + +<dl> + <dt>{{domxref("XDomainRequest.onprogress")}}</dt> + <dd>当请求中发送方法和onload事件中有进展时的处理程序。</dd> + <dt>{{domxref("XDomainRequest.ontimeout")}}</dt> + <dd>当请求超时时的事件处理程序。</dd> + <dt>{{domxref("XDomainRequest.onerror")}}</dt> + <dd>当请求发生错误时的处理程序。</dd> + <dt>{{domxref("XDomainRequest.onload")}}</dt> + <dd>当服务器端的响应被完整接收时的处理程序。</dd> +</dl> + +<h2 id="例子">例子</h2> + +<pre class="brush: js">if(window.XDomainRequest){ + var xdr = new XDomainRequest(); + + xdr.open("get", "http://example.com/api/method"); + + xdr.onprogress = function () { + //Progress + }; + + xdr.ontimeout = function () { + //Timeout + }; + + xdr.onerror = function () { + //Error Occured + }; + + xdr.onload = function() { + //success(xdr.responseText); + } + + setTimeout(function () { + xdr.send(); + }, 0); +}</pre> + +<div> </div> + +<div class="note"> +<p><strong>注意： </strong>如果多个XDomainRequests同时被发送，一些请求可能会丢失，为避免这种情况，xdr.send()的调用应被包裹在setTimeout方法中（见{{domxref("window.setTimeout()")}}）。</p> +</div> + +<h2 id="安全">安全</h2> + +<p><span style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;">XDomainRequest为了确保安全构建，采用了多种方法。</span></p> + +<ul> + <li>安全协议源必须匹配请求的URL。（http到http，https到https）。如果不匹配，请求会报“拒绝访问”的错误。</li> + <li>被请求的URL的服务器必须带有<span style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;"> 设置为（“*”）或包含了请求方的</span><code style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;"><a href="/en-US/docs/Web/HTTP/Access_control_CORS#Access-Control-Allow-Origin" style="font-size: 14.4444446563721px; line-height: 23.3333339691162px;">Access-Control-Allow-Origin</a>的头部。</code></li> +</ul> + +<h2 id="标准">标准</h2> + +<p>该接口及其方法没有遵循标准。</p> + +<h2 id="浏览器兼容性">浏览器兼容性</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>XDomainRequest</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatNo() }}</td> + <td>8.0-9.x</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatNo() }}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Feature</th> + <th>Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>XDomainRequest</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatUnknown() }}</td> + <td>{{ CompatNo() }}</td> + <td>{{ CompatNo() }}</td> + </tr> + </tbody> +</table> +</div> + +<section id="Quick_Links"> +<ol> + <li data-default-state="open"><a href="#"><strong>Properties</strong></a> + + <ol> + <li>{{domxref("XDomainRequest.timeout")}}</li> + <li>{{domxref("XDomainRequest.responseText")}}</li> + </ol> + </li> + <li data-default-state="open"><a href="#"><strong>Methods</strong></a> + <ol> + <li>{{domxref("XDomainRequest.open()")}}</li> + <li>{{domxref("XDomainRequest.send()")}}</li> + <li>{{domxref("XDomainRequest.abort()")}}</li> + </ol> + </li> + <li data-default-state="open"><a href="#"><strong>Event handlers</strong></a> + <ol> + <li>{{domxref("XDomainRequest.onprogress")}}</li> + <li>{{domxref("XDomainRequest.ontimeout")}}</li> + <li>{{domxref("XDomainRequest.onerror")}}</li> + <li>{{domxref("XDomainRequest.onload")}}</li> + </ol> + </li> +</ol> +</section> diff --git a/files/zh-cn/orphaned/web/http/headers/index/index.html b/files/zh-cn/orphaned/web/http/headers/index/index.html new file mode 100644 index 0000000000..6268193b12 --- /dev/null +++ b/files/zh-cn/orphaned/web/http/headers/index/index.html @@ -0,0 +1,9 @@ +--- +title: Index +slug: orphaned/Web/HTTP/Headers/Index +translation_of: Web/HTTP/Headers/Index +original_slug: Web/HTTP/Headers/Index +--- +<div>{{HTTPSidebar}}</div> + +<p>{{Index("/en-US/docs/Web/HTTP/Headers")}}</p> |