Add HttpHeaders to experimental.downloads.json

chrome/common/extensions/api/experimental.downloads.json

 [
   {
     "namespace": "experimental.downloads",
     "nodoc": "true",
     "events": [
       {
         "name": "onCreated",
         "type": "function",
         "description": "This event fires with the DownloadItem object when a download begins.",
         "parameters": [
@@ skipping 64 matching lines @@
         "description": "The URL was invalid."
       },
       "ERROR_INVALID_OPERATION": {
         "type": "string",
         "value": "Invalid operation.",
         "description": "The requested operation cannot be performed at this time. This maybe due to the download being in a state where the requested operation is not allowed."
       }
     },
     "types": [
       {
+        "id": "HttpHeaders",
+        "type": "array",
+        "description": "An array of HTTP headers. Each header is represented as a dictionary containing the keys <code>name</code> and either <code>value</code> or <code>binaryValue</code>.",

[Sam Kerner (Chrome), 2012/01/11 16:21:15]

I have not seen HTML tags like <code> used in this file.  When you generate the
docs (chrome/common/extensions/docs/build/build.py) do they come through the
process as proper HTML?

+        "items": {
+          "type": "object",
+          "properties": {
+            "name": {"type": "string", "description": "Name of the HTTP header."},
+            "value": {"type": "string", "optional": true, "description": "Value of the HTTP header if it can be represented by UTF-8."},
+            "binaryValue": {
+              "type": "array",
+              "optional": true,
+              "description": "Value of the HTTP header if it cannot be represented by UTF-8, stored as individual byte values (0..255).",
+              "items": {"type": "integer"}
+            }
+          }
+        }
+      },
+      {
         "id": "DownloadItem",
         "type": "object",
         "description": "The state of a file as it is downloaded from the internet.",
         "properties": {
           "id": {
             "type": "integer",
             "description": "An identifier that is persistent across browser sessions."
           },
           "url": {
             "type": "string",
@@ skipping 457 matching lines @@
             "type": "function",
             "optional": true,
             "parameters": [],
             "description": "Called when the request is completed. The download is cancelled, completed, interrupted or doesn't exist anymore."
           }
         ]
       }
     ]
   }
 ]