[agiow] (1) Revamp pushState() to work like Firefox 4, since that act…

…ually makes the API useful. See also http://hacks.mozilla.org/2011/03/history-api-changes-in-firefox-4/, WHATWG mail, and the bug below.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=12277

git-svn-id: http://svn.whatwg.org/webapps@5964 340c8d12-0b0e-0410-8428-c7bf67bfef74

complete.html

  <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
   <hgroup><h1>Web Applications 1.0</h1>
    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 24 March 2011</h2>
    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 25 March 2011</h2>
   </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
   <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
   <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->

  <pre class=idl>interface <dfn id=history-0>History</dfn> {
  readonly attribute long <a href=#dom-history-length title=dom-history-length>length</a>;
  readonly attribute any <a href=#dom-history-state title=dom-history-state>state</a>;
  void <a href=#dom-history-go title=dom-history-go>go</a>(in optional long delta);
  void <a href=#dom-history-back title=dom-history-back>back</a>();
  void <a href=#dom-history-forward title=dom-history-forward>forward</a>();

   </dd>

   <dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-state><a href=#dom-history-state>state</a></code></dt>

   <dd>

    <p>Returns the current <a href=#state-object>state object</a>.</p>

   </dd>

   <dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-go><a href=#dom-history-go>go</a></code>( [ <var title="">delta</var> ] )</dt>

   <dd>

  <p>The actual entries are not accessible from script.</p>

  <p>The <dfn id=dom-history-state title=dom-history-state><code>state</code></dfn>
  attribute of the <code><a href=#history-0>History</a></code> interface must return the last
  value it was set to by the user agent. Initially, its value must be
  null.</p>

  <p>When the <dfn id=dom-history-go title=dom-history-go><code>go(<var title="">delta</var>)</code></dfn> method is invoked, if the
  argument to the method was omitted or has the value zero, the user
  agent must act as if the <code title=dom-location-reload><a href=#dom-location-reload>location.reload()</a></code> method was

   <li>

     <p>If the <a href=#current-document-readiness>current document readiness</a> is not yet set
     to the string "complete", let the <code><a href=#document>Document</a></code>'s
     <a href=#pending-state-object>pending state object</a> be another <a href=#structured-clone>structured
     clone</a> of the specified <var title="">data</var>. (If there
     was already a <a href=#pending-state-object>pending state object</a>, the previous one
     is discarded.)</p>

     <p class=note>This ensures that the <code title=event-popstate><a href=#event-popstate>popstate</a></code> event that will be fired
     when the document finally loads will accurately reflect the
     pushed or replaced state object.</p>
     <p>Set <code title=dom-history-state><a href=#dom-history-state>history.state</a></code> to
     another <a href=#structured-clone>structured clone</a> of the specified <var title="">data</var>.</p>

   </li>

   document.forms.F.I.value = newI;
 }
&lt;/SCRIPT&gt;
&lt;BODY ONPOPSTATE="recover(event.state)"&gt;
&lt;BODY ONPOPSTATE="set(event.state)"&gt;
&lt;FORM NAME=F&gt;
State: &lt;OUTPUT NAME=I&gt;1&lt;/OUTPUT&gt; &lt;INPUT VALUE="Increment" TYPE=BUTTON ONCLICK="inc()"&gt;
&lt;/FORM&gt;</pre>
   state object. Otherwise, let <var title="">state</var> be
   null.</li>

   <li>

    <p>Run the appropriate steps according to the conditions
    described:</p>
   <li><p>Set <code title=dom-history-state><a href=#dom-history-state>history.state</a></code> to <var title="">state</var>.</li>

    <dl class=switch><dt>If the <a href=#current-document-readiness>current document readiness</a> is set to the
     string "complete"</dt>
   <li><p>Fire a <code title=event-popstate><a href=#event-popstate>popstate</a></code> event at
   the <code><a href=#window>Window</a></code> object of the <code><a href=#document>Document</a></code>, using
   the <code><a href=#popstateevent>PopStateEvent</a></code> interface, with the <code title=dom-PopStateEvent-state><a href=#dom-popstateevent-state>state</a></code> attribute set to the
   value of <var title="">state</var>. This event must bubble but not
   be cancelable and has no default action.</li>

     <dd><p><a href=#queue-a-task>Queue a task</a> to fire a <code title=event-popstate><a href=#event-popstate>popstate</a></code> event at the
     <code><a href=#window>Window</a></code> object of the <code><a href=#document>Document</a></code>, using
     the <code><a href=#popstateevent>PopStateEvent</a></code> interface, with the <code title=dom-PopStateEvent-state><a href=#dom-popstateevent-state>state</a></code> attribute set to the
     value of <var title="">state</var>. This event must bubble but
     not be cancelable and has no default action.</dd>

     <dt>Otherwise</dt>

     <dd><p>Let the <code><a href=#document>Document</a></code>'s <a href=#pending-state-object>pending state
     object</a> be <var title="">state</var>. (If there was already
     a <a href=#pending-state-object>pending state object</a>, the previous one is
     discarded.)</p>

     <p class=note>The event will then be fired just after the <code title=event-load>load</code> event.</dd>

    </dl></li>

   <li><p>If <var title="">hash changed</var> is true, then
   <a href=#queue-a-task>queue a task</a> to fire a <code title=event-hashchange><a href=#event-hashchange>hashchange</a></code> event at the
   <li><p>If <var title="">hash changed</var> is true, then fire a
   <code title=event-hashchange><a href=#event-hashchange>hashchange</a></code> event at the
   <a href=#browsing-context>browsing context</a>'s <code><a href=#window>Window</a></code> object, using
   the <code><a href=#hashchangeevent>HashChangeEvent</a></code> interface, with the <code title=dom-HashChangeEvent-oldURL><a href=#dom-hashchangeevent-oldurl>oldURL</a></code> attribute set to
   <var title="">old URL</var> and the <code title=dom-HashChangeEvent-newURL><a href=#dom-hashchangeevent-newurl>newURL</a></code> attribute set to
   <li><p>The <a href=#current-entry>current entry</a> is now the <i>specified
   entry</i>.</li>

  </ol><p>The <dfn id=pending-state-object>pending state object</dfn> is used to keep track of what
  state object to use in the inital <code title=event-popstate><a href=#event-popstate>popstate</a></code> event fired by the parser
  once it <a href=#stop-parsing title="stop parsing">stops parsing</a>. The
  <a href=#pending-state-object>pending state object</a> must be initially null.</p>

  <p>The <a href=#task-source>task source</a> for the tasks mentioned above is the
  </ol><p>The <a href=#task-source>task source</a> for the tasks mentioned above is the
  <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>


   attribute set to false. This event must not bubble, must not be
   cancelable, and has no default action.</li>

   <li><p>If the <code><a href=#document>Document</a></code> is in a <a href=#browsing-context>browsing
   context</a>, then <a href=#queue-a-task>queue a task</a> to fire a <code title=event-popstate><a href=#event-popstate>popstate</a></code> event at the
   <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object using the
   <code><a href=#popstateevent>PopStateEvent</a></code> interface, with the <code title=dom-PopStateEvent-state><a href=#dom-popstateevent-state>state</a></code> attribute set to the
   current value of the <a href=#pending-state-object>pending state object</a>. This event
   must bubble but not be cancelable and has no default
   action.</li>

   <li><p>If the <code><a href=#document>Document</a></code> has any <a href=#pending-application-cache-download-process-tasks>pending
   application cache download process tasks</a>, then <a href=#queue-a-task title="queue a task">queue</a> each such <a href=#concept-task title=concept-task>task</a> in the order they were added to
   the list of <a href=#pending-application-cache-download-process-tasks>pending application cache download process

index

  <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
   <hgroup><h1 class=allcaps>HTML</h1>
    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 24 March 2011</h2>
    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 25 March 2011</h2>
   </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
   <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
   <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->

  <pre class=idl>interface <dfn id=history-0>History</dfn> {
  readonly attribute long <a href=#dom-history-length title=dom-history-length>length</a>;
  readonly attribute any <a href=#dom-history-state title=dom-history-state>state</a>;
  void <a href=#dom-history-go title=dom-history-go>go</a>(in optional long delta);
  void <a href=#dom-history-back title=dom-history-back>back</a>();
  void <a href=#dom-history-forward title=dom-history-forward>forward</a>();

   </dd>

   <dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-state><a href=#dom-history-state>state</a></code></dt>

   <dd>

    <p>Returns the current <a href=#state-object>state object</a>.</p>

   </dd>

   <dt><var title="">window</var> . <code title=dom-history><a href=#dom-history>history</a></code> . <code title=dom-history-go><a href=#dom-history-go>go</a></code>( [ <var title="">delta</var> ] )</dt>

   <dd>

  <p>The actual entries are not accessible from script.</p>

  <p>The <dfn id=dom-history-state title=dom-history-state><code>state</code></dfn>
  attribute of the <code><a href=#history-0>History</a></code> interface must return the last
  value it was set to by the user agent. Initially, its value must be
  null.</p>

  <p>When the <dfn id=dom-history-go title=dom-history-go><code>go(<var title="">delta</var>)</code></dfn> method is invoked, if the
  argument to the method was omitted or has the value zero, the user
  agent must act as if the <code title=dom-location-reload><a href=#dom-location-reload>location.reload()</a></code> method was

   <li>

     <p>If the <a href=#current-document-readiness>current document readiness</a> is not yet set
     to the string "complete", let the <code><a href=#document>Document</a></code>'s
     <a href=#pending-state-object>pending state object</a> be another <a href=#structured-clone>structured
     clone</a> of the specified <var title="">data</var>. (If there
     was already a <a href=#pending-state-object>pending state object</a>, the previous one
     is discarded.)</p>

     <p class=note>This ensures that the <code title=event-popstate><a href=#event-popstate>popstate</a></code> event that will be fired
     when the document finally loads will accurately reflect the
     pushed or replaced state object.</p>
     <p>Set <code title=dom-history-state><a href=#dom-history-state>history.state</a></code> to
     another <a href=#structured-clone>structured clone</a> of the specified <var title="">data</var>.</p>

   </li>

   document.forms.F.I.value = newI;
 }
&lt;/SCRIPT&gt;
&lt;BODY ONPOPSTATE="recover(event.state)"&gt;
&lt;BODY ONPOPSTATE="set(event.state)"&gt;
&lt;FORM NAME=F&gt;
State: &lt;OUTPUT NAME=I&gt;1&lt;/OUTPUT&gt; &lt;INPUT VALUE="Increment" TYPE=BUTTON ONCLICK="inc()"&gt;
&lt;/FORM&gt;</pre>
   state object. Otherwise, let <var title="">state</var> be
   null.</li>

   <li>

    <p>Run the appropriate steps according to the conditions
    described:</p>
   <li><p>Set <code title=dom-history-state><a href=#dom-history-state>history.state</a></code> to <var title="">state</var>.</li>

    <dl class=switch><dt>If the <a href=#current-document-readiness>current document readiness</a> is set to the
     string "complete"</dt>
   <li><p>Fire a <code title=event-popstate><a href=#event-popstate>popstate</a></code> event at
   the <code><a href=#window>Window</a></code> object of the <code><a href=#document>Document</a></code>, using
   the <code><a href=#popstateevent>PopStateEvent</a></code> interface, with the <code title=dom-PopStateEvent-state><a href=#dom-popstateevent-state>state</a></code> attribute set to the
   value of <var title="">state</var>. This event must bubble but not
   be cancelable and has no default action.</li>

     <dd><p><a href=#queue-a-task>Queue a task</a> to fire a <code title=event-popstate><a href=#event-popstate>popstate</a></code> event at the
     <code><a href=#window>Window</a></code> object of the <code><a href=#document>Document</a></code>, using
     the <code><a href=#popstateevent>PopStateEvent</a></code> interface, with the <code title=dom-PopStateEvent-state><a href=#dom-popstateevent-state>state</a></code> attribute set to the
     value of <var title="">state</var>. This event must bubble but
     not be cancelable and has no default action.</dd>

     <dt>Otherwise</dt>

     <dd><p>Let the <code><a href=#document>Document</a></code>'s <a href=#pending-state-object>pending state
     object</a> be <var title="">state</var>. (If there was already
     a <a href=#pending-state-object>pending state object</a>, the previous one is
     discarded.)</p>

     <p class=note>The event will then be fired just after the <code title=event-load>load</code> event.</dd>

    </dl></li>

   <li><p>If <var title="">hash changed</var> is true, then
   <a href=#queue-a-task>queue a task</a> to fire a <code title=event-hashchange><a href=#event-hashchange>hashchange</a></code> event at the
   <li><p>If <var title="">hash changed</var> is true, then fire a
   <code title=event-hashchange><a href=#event-hashchange>hashchange</a></code> event at the
   <a href=#browsing-context>browsing context</a>'s <code><a href=#window>Window</a></code> object, using
   the <code><a href=#hashchangeevent>HashChangeEvent</a></code> interface, with the <code title=dom-HashChangeEvent-oldURL><a href=#dom-hashchangeevent-oldurl>oldURL</a></code> attribute set to
   <var title="">old URL</var> and the <code title=dom-HashChangeEvent-newURL><a href=#dom-hashchangeevent-newurl>newURL</a></code> attribute set to
   <li><p>The <a href=#current-entry>current entry</a> is now the <i>specified
   entry</i>.</li>

  </ol><p>The <dfn id=pending-state-object>pending state object</dfn> is used to keep track of what
  state object to use in the inital <code title=event-popstate><a href=#event-popstate>popstate</a></code> event fired by the parser
  once it <a href=#stop-parsing title="stop parsing">stops parsing</a>. The
  <a href=#pending-state-object>pending state object</a> must be initially null.</p>

  <p>The <a href=#task-source>task source</a> for the tasks mentioned above is the
  </ol><p>The <a href=#task-source>task source</a> for the tasks mentioned above is the
  <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>


   attribute set to false. This event must not bubble, must not be
   cancelable, and has no default action.</li>

   <li><p>If the <code><a href=#document>Document</a></code> is in a <a href=#browsing-context>browsing
   context</a>, then <a href=#queue-a-task>queue a task</a> to fire a <code title=event-popstate><a href=#event-popstate>popstate</a></code> event at the
   <code><a href=#document>Document</a></code>'s <code><a href=#window>Window</a></code> object using the
   <code><a href=#popstateevent>PopStateEvent</a></code> interface, with the <code title=dom-PopStateEvent-state><a href=#dom-popstateevent-state>state</a></code> attribute set to the
   current value of the <a href=#pending-state-object>pending state object</a>. This event
   must bubble but not be cancelable and has no default
   action.</li>

   <li><p>If the <code><a href=#document>Document</a></code> has any <a href=#pending-application-cache-download-process-tasks>pending
   application cache download process tasks</a>, then <a href=#queue-a-task title="queue a task">queue</a> each such <a href=#concept-task title=concept-task>task</a> in the order they were added to
   the list of <a href=#pending-application-cache-download-process-tasks>pending application cache download process