[html5] r8462 - [cgiow] (0) Change navigator.getLanguages() to navigator.languages Fixing https: [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Feb 4 15:17:02 PST 2014
Author: ianh
Date: 2014-02-04 15:17:01 -0800 (Tue, 04 Feb 2014)
New Revision: 8462
Modified:
complete.html
index
source
Log:
[cgiow] (0) Change navigator.getLanguages() to navigator.languages
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=23517
Affected topics: DOM APIs
Modified: complete.html
===================================================================
--- complete.html 2014-02-04 21:10:47 UTC (rev 8461)
+++ complete.html 2014-02-04 23:17:01 UTC (rev 8462)
@@ -74265,7 +74265,7 @@
<pre class=idl>[NoInterfaceObject, Exposed=Window,Worker]
interface <dfn id=navigatorlanguage>NavigatorLanguage</dfn> {
readonly attribute DOMString? <a href=#dom-navigator-language title=dom-navigator-language>language</a>;
- DOMString[] <a href=#dom-navigator-getlanguages title=dom-navigator-getLanguages>getLanguages</a>();
+ readonly attribute DOMString[] <a href=#dom-navigator-languages title=dom-navigator-languages>languages</a>;
};</pre>
<dl class=domintro><dt><var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-language><a href=#dom-navigator-language>language</a></code></dt>
@@ -74273,7 +74273,7 @@
<p>Returns a language tag representing the user's preferred language.</p>
</dd>
- <dt><var title="">languages</var> = <var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-getLanguages><a href=#dom-navigator-getlanguages>getLanguages</a></code>()</dt>
+ <dt><var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-languages><a href=#dom-navigator-languages>languages</a></code></dt>
<dd>
<p>Returns an array of language tags representing the user's preferred languages, with the most preferred language first.</p>
<p>The most preferred language is the one returned by <code title=dom-navigator-language><a href=#dom-navigator-language>navigator.language</a></code>.</p>
@@ -74296,10 +74296,26 @@
<dd><p>Must return a valid BCP 47 language tag representing either <a href=#a-plausible-language>a plausible
language</a> or the user's most preferred language. <a href=#refsBCP47>[BCP47]</a></dd>
- <dt><dfn id=dom-navigator-getlanguages title=dom-navigator-getLanguages><code>getLanguages()</code></dfn></dt>
- <dd><p>Must return an array of valid BCP 47 language tags representing either one or more <a href=#a-plausible-language title="a plausible language">plausible languages</a>, or the user's preferred languages,
- ordered by preference with the most preferred language first. <a href=#refsBCP47>[BCP47]</a></dd>
+ <dt><dfn id=dom-navigator-languages title=dom-navigator-languages><code>languages</code></dfn></dt>
+ <dd>
+ <p>Must return a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array of valid BCP 47
+ language tags representing either one or more <a href=#a-plausible-language title="a plausible language">plausible
+ languages</a>, or the user's preferred languages, ordered by preference with the most
+ preferred language first. The same object must be returned until the user agent needs to return
+ different values, or values in a different order. <a href=#refsBCP47>[BCP47]</a></p>
+
+ <p>Whenever the user agent needs to make the <code title=dom-navigator-languages><a href=#dom-navigator-languages>navigator.languages</a></code> attribute of a <code><a href=#window>Window</a></code>
+ or <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object return a new set of language tags, the user agent must
+ <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-languagechange><a href=#event-languagechange>languagechange</a></code> at the <code><a href=#window>Window</a></code> or
+ <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object and wait until that task begins to be executed before
+ actually returning a new value.</p>
+
+ <p>The <a href=#task-source>task source</a> for this <a href=#concept-task title=concept-task>task</a> is the
+ <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
+
+ </dd>
+
</dl><p>To determine <dfn id=a-plausible-language>a plausible language</dfn>, the user agent should bear in mind the following:</p>
<ul><li>Any information in this API that varies from user to user can be used to profile or identify
@@ -74321,15 +74337,6 @@
<a href=#fingerprinting-vector class=fingerprint title="fingerprinting vector"><img src=http://images.whatwg.org/fingerprint.png width=46 alt="(This is a fingerprinting vector.)" height=64></a>
</p>
- <p>Whenever the <code title=dom-navigator-getLanguages><a href=#dom-navigator-getlanguages>navigator.getLanguages()</a></code> method
- of a <code><a href=#window>Window</a></code> or <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object would start returning a new set
- of language tags, the user agent must <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
- event</a> named <code title=event-languagechange><a href=#event-languagechange>languagechange</a></code> at the
- <code><a href=#window>Window</a></code> or <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object.</p>
-
- <p>The <a href=#task-source>task source</a> for this <a href=#concept-task title=concept-task>task</a> is the
- <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
-
</div>
Modified: index
===================================================================
--- index 2014-02-04 21:10:47 UTC (rev 8461)
+++ index 2014-02-04 23:17:01 UTC (rev 8462)
@@ -74265,7 +74265,7 @@
<pre class=idl>[NoInterfaceObject, Exposed=Window,Worker]
interface <dfn id=navigatorlanguage>NavigatorLanguage</dfn> {
readonly attribute DOMString? <a href=#dom-navigator-language title=dom-navigator-language>language</a>;
- DOMString[] <a href=#dom-navigator-getlanguages title=dom-navigator-getLanguages>getLanguages</a>();
+ readonly attribute DOMString[] <a href=#dom-navigator-languages title=dom-navigator-languages>languages</a>;
};</pre>
<dl class=domintro><dt><var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-language><a href=#dom-navigator-language>language</a></code></dt>
@@ -74273,7 +74273,7 @@
<p>Returns a language tag representing the user's preferred language.</p>
</dd>
- <dt><var title="">languages</var> = <var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-getLanguages><a href=#dom-navigator-getlanguages>getLanguages</a></code>()</dt>
+ <dt><var title="">window</var> . <code title=dom-navigator><a href=#dom-navigator>navigator</a></code> . <code title=dom-navigator-languages><a href=#dom-navigator-languages>languages</a></code></dt>
<dd>
<p>Returns an array of language tags representing the user's preferred languages, with the most preferred language first.</p>
<p>The most preferred language is the one returned by <code title=dom-navigator-language><a href=#dom-navigator-language>navigator.language</a></code>.</p>
@@ -74296,10 +74296,26 @@
<dd><p>Must return a valid BCP 47 language tag representing either <a href=#a-plausible-language>a plausible
language</a> or the user's most preferred language. <a href=#refsBCP47>[BCP47]</a></dd>
- <dt><dfn id=dom-navigator-getlanguages title=dom-navigator-getLanguages><code>getLanguages()</code></dfn></dt>
- <dd><p>Must return an array of valid BCP 47 language tags representing either one or more <a href=#a-plausible-language title="a plausible language">plausible languages</a>, or the user's preferred languages,
- ordered by preference with the most preferred language first. <a href=#refsBCP47>[BCP47]</a></dd>
+ <dt><dfn id=dom-navigator-languages title=dom-navigator-languages><code>languages</code></dfn></dt>
+ <dd>
+ <p>Must return a <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array of valid BCP 47
+ language tags representing either one or more <a href=#a-plausible-language title="a plausible language">plausible
+ languages</a>, or the user's preferred languages, ordered by preference with the most
+ preferred language first. The same object must be returned until the user agent needs to return
+ different values, or values in a different order. <a href=#refsBCP47>[BCP47]</a></p>
+
+ <p>Whenever the user agent needs to make the <code title=dom-navigator-languages><a href=#dom-navigator-languages>navigator.languages</a></code> attribute of a <code><a href=#window>Window</a></code>
+ or <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object return a new set of language tags, the user agent must
+ <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> named <code title=event-languagechange><a href=#event-languagechange>languagechange</a></code> at the <code><a href=#window>Window</a></code> or
+ <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object and wait until that task begins to be executed before
+ actually returning a new value.</p>
+
+ <p>The <a href=#task-source>task source</a> for this <a href=#concept-task title=concept-task>task</a> is the
+ <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
+
+ </dd>
+
</dl><p>To determine <dfn id=a-plausible-language>a plausible language</dfn>, the user agent should bear in mind the following:</p>
<ul><li>Any information in this API that varies from user to user can be used to profile or identify
@@ -74321,15 +74337,6 @@
<a href=#fingerprinting-vector class=fingerprint title="fingerprinting vector"><img src=http://images.whatwg.org/fingerprint.png width=46 alt="(This is a fingerprinting vector.)" height=64></a>
</p>
- <p>Whenever the <code title=dom-navigator-getLanguages><a href=#dom-navigator-getlanguages>navigator.getLanguages()</a></code> method
- of a <code><a href=#window>Window</a></code> or <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object would start returning a new set
- of language tags, the user agent must <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple
- event</a> named <code title=event-languagechange><a href=#event-languagechange>languagechange</a></code> at the
- <code><a href=#window>Window</a></code> or <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object.</p>
-
- <p>The <a href=#task-source>task source</a> for this <a href=#concept-task title=concept-task>task</a> is the
- <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
-
</div>
Modified: source
===================================================================
--- source 2014-02-04 21:10:47 UTC (rev 8461)
+++ source 2014-02-04 23:17:01 UTC (rev 8462)
@@ -83012,7 +83012,7 @@
<pre class="idl">[NoInterfaceObject, Exposed=Window,Worker]
interface <dfn>NavigatorLanguage</dfn> {
readonly attribute DOMString? <span data-x="dom-navigator-language">language</span>;
- DOMString[] <span data-x="dom-navigator-getLanguages">getLanguages</span>();
+ readonly attribute DOMString[] <span data-x="dom-navigator-languages">languages</span>;
};</pre>
<dl class="domintro">
@@ -83022,7 +83022,7 @@
<p>Returns a language tag representing the user's preferred language.</p>
</dd>
- <dt><var data-x="">languages</var> = <var data-x="">window</var> . <code data-x="dom-navigator">navigator</code> . <code data-x="dom-navigator-getLanguages">getLanguages</code>()</dt>
+ <dt><var data-x="">window</var> . <code data-x="dom-navigator">navigator</code> . <code data-x="dom-navigator-languages">languages</code></dt>
<dd>
<p>Returns an array of language tags representing the user's preferred languages, with the most preferred language first.</p>
<p>The most preferred language is the one returned by <code data-x="dom-navigator-language">navigator.language</code>.</p>
@@ -83051,12 +83051,28 @@
<dd><p>Must return a valid BCP 47 language tag representing either <span>a plausible
language</span> or the user's most preferred language. <a href="#refsBCP47">[BCP47]</a></p></dd>
- <dt><dfn data-x="dom-navigator-getLanguages"><code>getLanguages()</code></dfn></dt>
- <dd><p>Must return an array of valid BCP 47 language tags representing either one or more <span
- data-x="a plausible language">plausible languages</span>, or the user's preferred languages,
- ordered by preference with the most preferred language first. <a
- href="#refsBCP47">[BCP47]</a></p></dd>
+ <dt><dfn data-x="dom-navigator-languages"><code>languages</code></dfn></dt>
+ <dd>
+ <p>Must return a <span data-x="dfn-read-only-array">read only</span> array of valid BCP 47
+ language tags representing either one or more <span data-x="a plausible language">plausible
+ languages</span>, or the user's preferred languages, ordered by preference with the most
+ preferred language first. The same object must be returned until the user agent needs to return
+ different values, or values in a different order. <a href="#refsBCP47">[BCP47]</a></p>
+
+ <p>Whenever the user agent needs to make the <code
+ data-x="dom-navigator-languages">navigator.languages</code> attribute of a <code>Window</code>
+ or <code>WorkerGlobalScope</code> object return a new set of language tags, the user agent must
+ <span>queue a task</span> to <span>fire a simple event</span> named <code
+ data-x="event-languagechange">languagechange</code> at the <code>Window</code> or
+ <code>WorkerGlobalScope</code> object and wait until that task begins to be executed before
+ actually returning a new value.</p>
+
+ <p>The <span>task source</span> for this <span data-x="concept-task">task</span> is the
+ <span>DOM manipulation task source</span>.</p>
+
+ </dd>
+
</dl>
<p>To determine <dfn>a plausible language</dfn>, the user agent should bear in mind the following:</p>
@@ -83085,15 +83101,6 @@
<!--INSERT FINGERPRINT-->
</p>
- <p>Whenever the <code data-x="dom-navigator-getLanguages">navigator.getLanguages()</code> method
- of a <code>Window</code> or <code>WorkerGlobalScope</code> object would start returning a new set
- of language tags, the user agent must <span>queue a task</span> to <span>fire a simple
- event</span> named <code data-x="event-languagechange">languagechange</code> at the
- <code>Window</code> or <code>WorkerGlobalScope</code> object.</p>
-
- <p>The <span>task source</span> for this <span data-x="concept-task">task</span> is the
- <span>DOM manipulation task source</span>.</p>
-
</div>
More information about the Commit-Watchers
mailing list