Include the processId in webNavigation events

chrome/common/extensions/docs/extensions/webNavigation.html

Index: chrome/common/extensions/docs/extensions/webNavigation.html
diff --git a/chrome/common/extensions/docs/extensions/webNavigation.html b/chrome/common/extensions/docs/extensions/webNavigation.html
index 795156e277e2c2ddffdda0e5791d43c0c085211c..597862fe6a065ac0ef6fdb03a471ada0958d97ae 100644
--- a/chrome/common/extensions/docs/extensions/webNavigation.html
+++ b/chrome/common/extensions/docs/extensions/webNavigation.html
@@ -217,7 +217,11 @@
               <ol>
               </ol>
             </li><li>
-              <a href="#H2-6">Transition types and qualifiers</a>
+              <a href="#H2-6">A note about frame and process IDs</a>
+              <ol>
+              </ol>
+            </li><li>
+              <a href="#H2-7">Transition types and qualifiers</a>
               <ol>
               </ol>
             </li>
@@ -319,6 +323,11 @@ time after <code>onDOMContentLoaded</code>, even after
 <code>onCompleted</code>.
 </p>
 <p>
+If the history API is used to modify the state of a frame (e.g. using
+<code>history.pushState()</code>, a <code>onHistoryStateUpdated</code> event is
+fired. This event can fire any time after <code>onDOMContentLoaded</code>.
+</p>
+<p>
 If a navigation was triggered via <a href="https://support.google.com/chrome/bin/answer.py?answer=177873">Chrome
 Instant</a> or <a href="https://support.google.com/chrome/bin/answer.py?answer=1385029">Instant
 Pages</a>, a completely loaded page is swapped into the current tab. In that
@@ -356,7 +365,24 @@ offset between them, but comparing them to the current time inside the
 extension (via <code>(new Date()).getTime()</code>, for instance) might give
 unexpected results.
 </p>
-<a name="H2-6"></a><h2>Transition types and qualifiers</h2>
+<a name="H2-6"></a><h2>A note about frame and process IDs</h2>
+<p>
+Due to the multi-process nature of Chrome, a tab might use different processes
+to render the source and destination of a web page. Therefore, if a navigation
+takes place in a new process, you might receive events both from the new and
+the old page until the new navigation is committed (i.e. the
+<code>onCommitted</code> event is send for the new main frame). Because frame
+IDs are only unique for a given process, the webNavigation events include a
+process ID, so you can still determine which frame a navigation came from.
+</p>
+<p>
+Also note that during a provisional load the process might be switched several
+times. This happens when the load is redirected to a different site. In this
+case, you will receive repeated <code>onBeforeNavigate</code> and
+<code>onErrorOccurred</code> events, until you receive the final
+<code>onCommitted</code> event.
+</p>
+<a name="H2-7"></a><h2>Transition types and qualifiers</h2>
 <p>
 The webNavigation API's <code>onCommitted</code> event has a
 <code>transitionType</code> and a <code>transitionQualifiers</code> property.
@@ -929,6 +955,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->
@@ -943,7 +992,7 @@ The following transition qualifiers exist:
                 </div>
               </em>
           </dt>
-          <dd>0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab.</dd>
+          <dd>0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique for a given tab and process.</dd>
           <!-- OBJECT PROPERTIES -->
           <!-- OBJECT METHODS -->
           <!-- OBJECT EVENT FIELDS -->
@@ -1075,6 +1124,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->
@@ -1276,6 +1348,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->
@@ -1397,6 +1492,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>sourceProcessId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for the source tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>sourceFrameId</var>
               <em>
                 <!-- TYPE -->
@@ -1589,6 +1707,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->
@@ -1735,6 +1876,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->
@@ -1904,6 +2068,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->
@@ -2105,6 +2292,29 @@ The following transition qualifiers exist:
               </div><div>
                 <div>
           <dt>
+            <var>processId</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span id="typeTemplate">
+                      <span>
+                        <span>integer</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>The ID of the process runs the renderer for this tab.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>frameId</var>
               <em>
                 <!-- TYPE -->