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 c4976505c8baeaf323618283f2c8c2caee4a7e8c..0a013a23817f5001b187939554d4f41f48d874ca 100644
--- a/chrome/common/extensions/docs/extensions/webRequest.html
+++ b/chrome/common/extensions/docs/extensions/webRequest.html
@@ -1762,6 +1762,117 @@ samples</a>.</p>
               </div><div>
                 <div>
           <dt>
+            <var>requestBody</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 request body data. Only provided if extraInfoSpec contains 'requestBody'. Currently only request body elements containing byte data or files are reported. Blob elements are ignored, and chunked elements result in an error.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <dd>
+            <dl>
+              <div>
+                <div>
+          <dt>
+            <var>error</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>string</span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>Errors when obtaining request body data.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- OBJECT METHODS -->
+          <!-- OBJECT EVENT FIELDS -->
+          <!-- FUNCTION PARAMETERS -->
+        </div>
+              </div><div>
+                <div>
+          <dt>
+            <var>formData</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 request method is POST and the body 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. An 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><div>
+                <div>
+          <dt>
+            <var>raw</var>
+              <em>
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span id="typeTemplate">
+                      <span>
+                        <span>
+                          array of <span><span>
+                      <span>
+                        <span>any</span>
+                      </span>
+                    </span></span>
+                        </span>
+                      </span>
+                    </span>
+                  )
+                </div>
+              </em>
+          </dt>
+          <dd>If the request method is PUT or POST, and the body is not already parsed in formData, then the unparsed request body elements are contained in this array. Data elements appear here as ArrayBuffer, file elements as strings containing the filename.</dd>
+          <!-- OBJECT PROPERTIES -->
+          <!-- 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 -->
@@ -1882,7 +1993,7 @@ samples</a>.</p>
                           array of <span><span>
                       <span>
                         <span>string</span>
-                        <span>["blocking"]</span>
+                        <span>["blocking", "requestBody"]</span>
                       </span>
                     </span></span>
                         </span>