Add read-only access to POST data for webRequest's onBeforeRequest

chrome/common/extensions/docs/extensions/webRequest.html

Index: chrome/common/extensions/docs/extensions/webRequest.html
diff --git a/chrome/common/extensions/docs/extensions/webRequest.html b/chrome/common/extensions/docs/extensions/webRequest.html
index 3185d2d0f51a269f49be3e2e215caf7a47fada45..ab86a7b29ab7275005bf53dd8df1ff4bf3d6ea2b 100644
--- a/chrome/common/extensions/docs/extensions/webRequest.html
+++ b/chrome/common/extensions/docs/extensions/webRequest.html
@@ -1766,6 +1766,89 @@ samples</a>.</p>
               </div><div>
                 <div>
           <dt>
+            <var>postData</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>object</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Experimental feature, only available in DEV or CANARY channels. Container for representations of data sent by the request via POST method. Only provided if extraInfoSpec contains 'postData'.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <dd>
+            <dl>
+              <div>
+                <div>
+          <dt>
+            <var>error</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span class="enum">enumerated</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>string</span>
+                        <span>["chunked_encoding"]</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Errors when obtaining POST data: 'chunked_encoding' means that the data is uploaded chunked, which is not currently supported by the WebRequest API.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
+            <var>form</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>object</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>If the POST data is a sequence of key-value pairs, encoded as either multipart/form-data, or application/x-www-form-urlencoded, this dictionary is present and for each key contains the list of all values for that key. If the data is of another media type, or if it is malformed, the dictionary is not present. It is also not present if the form upload is chunked. Example value of this dictionary is {'key': ['value1', 'value2']}.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <dd>
+            <dl>
+            </dl>
+          </dd>
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div>
+            </dl>
+          </dd>
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
             <var>tabId</var>
               <em>
                 <!-- TYPE -->
@@ -1886,7 +1969,7 @@ samples</a>.</p>
                           array of <span><span>
                       <span>
                         <span>string</span>
-                        <span>["blocking"]</span>
+                        <span>["blocking", "postData"]</span>
                       </span>
                     </span></span>
                         </span>