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

chrome/common/extensions/api/web_request.json

Index: chrome/common/extensions/api/web_request.json
diff --git a/chrome/common/extensions/api/web_request.json b/chrome/common/extensions/api/web_request.json
index af94afe869f5b54bae7412ffbe85889105e7099c..b467e11f0a76eb98f64923ff451b8fada2976f69 100644
--- a/chrome/common/extensions/api/web_request.json
+++ b/chrome/common/extensions/api/web_request.json
@@ -106,6 +106,23 @@
               "method": {"type": "string", "description": "Standard HTTP method."},
               "frameId": {"type": "integer", "description": "The value 0 indicates that the request happens in the main frame; a positive value indicates the ID of a subframe in which the request happens. If the document of a (sub-)frame is loaded (<code>type</code> is <code>main_frame</code> or <code>sub_frame</code>), <code>frameId</code> indicates the ID of this frame, not the ID of the outer frame. Frame IDs are unique within a tab."},
               "parentFrameId": {"type": "integer", "description": "ID of frame that wraps the frame which sent the request. Set to -1 if no parent frame exists."},
+              "experimentalPostData": {
+                "type": "object",
+                "optional": true,
+                "description": "Experimental feature. Container for representations of data sent by the request via POST method. Only provided if extraInfoSpec contains requestPostData.",
+                "properties": {
+                  "formData": {
+                    "type": "object",
+                    "optional": true,
+                    "description": "If the POST data is a sequence of key-value pairs, either in 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 in another encoding, or if it was malformed, the dictionary is not present. It is also not present if the form upload was chunked.",
+                    "properties": {},
+                    "additionalProperties": {

[battre, 2012/07/19 11:12:54]

I don't understand this section

[vabr (Chromium), 2012/07/19 11:44:40]

The 'additionalProperties' say that this dictionary can contain arbitrary
key-value pairs. Without it the schema validator would complain each time the
formData would be non-empty.

[vabr (Chromium), 2012/07/23 17:01:21]

OK, sorry I misunderstood your question. The type of formData is a dictionary
where values are arrays of strings. I will amend the description to include a
short example.

+                      "type": "array",
+                      "items": { "type": "string" }
+                    }
+                  }
+                }
+              },
               "tabId": {"type": "integer", "description": "The ID of the tab in which the request takes place. Set to -1 if the request isn't related to a tab."},
               "type": {"type": "string", "enum": ["main_frame", "sub_frame", "stylesheet", "script", "image", "object", "xmlhttprequest", "other"], "description": "How the requested resource will be used."},
               "timeStamp": {"type": "number", "description": "The time when this signal is triggered, in milliseconds since the epoch."}
@@ -125,7 +142,7 @@
             "description": "Array of extra information that should be passed to the listener function.",
             "items": {
               "type": "string",
-              "enum": ["blocking"]
+              "enum": ["blocking", "requestPostData"]
             }
           }
         ],