Skip to content

Commit

Permalink
Remove navigator.yieldForStorageUpdates() due to lack of implementation
Browse files Browse the repository at this point in the history
Also rename NavigatorStorageUtils to NavigatorCookies.

Fixes #334
  • Loading branch information
foolip committed Dec 15, 2015
1 parent 920c918 commit eff2e1b
Showing 1 changed file with 3 additions and 54 deletions.
57 changes: 3 additions & 54 deletions source
Expand Up @@ -637,11 +637,6 @@
be thought of as completely serialising the execution of all scripts in all <span data-x="browsing
context">browsing contexts</span>.</p>

<p class="note">The <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method, in
this model, is equivalent to allowing other scripts to run while the calling script is
blocked.</p>

</div>


Expand Down Expand Up @@ -88922,10 +88917,6 @@ scheduleWork(); // queues a task to do lots of work</pre>

<p>Displays a modal alert with the given message, and waits for the user to dismiss it.</p>

<p>A call to the <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
implied when this method is invoked.</p>

</dd>

<dt><var>result</var> = <var>window</var> . <code subdfn data-x="dom-confirm">confirm</code>(<var>message</var>)</dt>
Expand All @@ -88934,10 +88925,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
<p>Displays a modal OK/Cancel prompt with the given message, waits for the user to dismiss it,
and returns true if the user clicks OK and false if the user clicks Cancel.</p>

<p>A call to the <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
implied when this method is invoked.</p>

</dd>

<dt><var>result</var> = <var>window</var> . <code subdfn data-x="dom-prompt">prompt</code>(<var>message</var> [, <var>default</var>] )</dt>
Expand All @@ -88947,10 +88934,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
and returns the value that the user entered. If the user cancels the prompt, then returns null
instead. If the second argument is present, then the given value is used as a default.</p>

<p>A call to the <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
implied when this method is invoked.</p>

</dd>

</dl>
Expand Down Expand Up @@ -89062,10 +89045,6 @@ scheduleWork(); // queues a task to do lots of work</pre>

<p>Prompts the user to print the page.</p>

<p>A call to the <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method is
implied when this method is invoked.</p>

</dd>

</dl>
Expand Down Expand Up @@ -89178,10 +89157,6 @@ scheduleWork(); // queues a task to do lots of work</pre>
<p>Prompts the user with the given page, waits for that page to close, and returns the return
value.</p>

<p>A call to the <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method
is implied when this method is invoked.</p>

</dd>

</dl>
Expand Down Expand Up @@ -89466,7 +89441,7 @@ interface <dfn>WindowModal</dfn> {
<span>Navigator</span> implements <span>NavigatorLanguage</span>;
<span>Navigator</span> implements <span>NavigatorOnLine</span>;
<span>Navigator</span> implements <span>NavigatorContentUtils</span>;
<span>Navigator</span> implements <span>NavigatorStorageUtils</span>;
<span>Navigator</span> implements <span>NavigatorCookies</span>;
<span>Navigator</span> implements <span>NavigatorPlugins</span>;</pre>

<!-- v2:
Expand Down Expand Up @@ -90365,12 +90340,11 @@ interface <dfn>NavigatorContentUtils</dfn> {



<h5>Manually releasing the storage mutex</h5>
<h5>Cookies</h5>

<pre class="idl">[NoInterfaceObject]
interface <dfn>NavigatorStorageUtils</dfn> {
interface <dfn>NavigatorCookies</dfn> {
readonly attribute boolean <span data-x="dom-navigator-cookieEnabled">cookieEnabled</span>;
void <span data-x="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates</span>();
};</pre>

<dl class="domintro">
Expand All @@ -90383,26 +90357,6 @@ interface <dfn>NavigatorStorageUtils</dfn> {

</dd>


<dt><var>window</var> . <code data-x="dom-navigator">navigator</code> . <code subdfn data-x="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates</code>()</dt>

<dd>

<p>If a script uses the <code data-x="dom-document-cookie">document.cookie</code> API, or the
<code data-x="dom-localStorage">localStorage</code> API, the browser will block other scripts
from accessing cookies or storage until the first script finishes.</p>

<p>Calling the <code
data-x="dom-navigator-yieldForStorageUpdates">navigator.yieldForStorageUpdates()</code> method
tells the user agent to unblock any other scripts that may be blocked, even though the script
hasn't returned.</p>

<p>Values of cookies and items in the <code>Storage</code> objects of <code
data-x="dom-localStorage">localStorage</code> attributes can change after calling this method,
whence its name.</p>

</dd>

</dl>

<div w-nodev>
Expand All @@ -90411,11 +90365,6 @@ interface <dfn>NavigatorStorageUtils</dfn> {
return true if the user agent attempts to handle cookies according to the cookie specification,
and false if it ignores cookie change requests. <ref spec=COOKIES></p>

<p>The <dfn><code data-x="dom-navigator-yieldForStorageUpdates">yieldForStorageUpdates()</code></dfn> method,
when invoked, must, if the <span>storage mutex</span> is owned by the <span>event loop</span> of
the <span data-x="concept-task">task</span> that resulted in the method being called, release the
<span>storage mutex</span> so that it is once again free. Otherwise, it must do nothing.</p>

</div>


Expand Down

0 comments on commit eff2e1b

Please sign in to comment.