[WIP] Protocol for sending information about Promises to frontend.

Source/devtools/protocol.json

 {
     "version": { "major": "1", "minor": "1" },
     "domains": [{
         "domain": "Inspector",
         "hidden": true,
         "types": [],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables inspector domain notifications."
@@ skipping 3109 matching lines @@
                     { "name": "compileError", "optional": true, "type": "object", "properties":
                         [
                             { "name": "message", "type": "string", "description": "Compiler error message" },
                             { "name": "lineNumber", "type": "integer", "description": "Compile error line number (1-based)" },
                             { "name": "columnNumber", "type": "integer", "description": "Compile error column number (1-based)" }
                         ]
                     }
                 ],
                 "description": "Error data for setScriptSource command. compileError is a case type for uncompilable script source error.",
                 "hidden": true
+            },
+            {
+                "id": "PromiseDetails",
+                "type": "object",
+                "description": "Information about the promise.",
+                "properties": [
+                    { "name": "id", "type": "integer", "description": "Unique id of the promise." },
+                    { "name": "status", "type": "integer", "description": "Status of the promise. Equal to <code>1</code> for resolved, <code>-1</code> for rejected and <code>0</code> for pending ones." },

[sergeyv, 2014/09/02 15:25:36]

Since you have very limited range of possible values, don't you want use enum
type for this property?  See Scope type for example

[Alexandra Mikhaylova, 2014/09/03 14:28:55]

Thanks, done so.

+                    { "name": "parentId", "type": "integer", "optional": true, "description": "Id of the parent promise." },
+                    { "name": "callFrame", "$ref": "Console.CallFrame", "optional": true, "description": "Top call frame on promise creation."}
+                ],
+                "hidden": true
             }
         ],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables debugger for the given page. Clients should not assume that the debugging has been enabled until the result for this command is received."
             },
             {
                 "name": "disable",
                 "description": "Disables debugger for given page."
@@ skipping 261 matching lines @@
                 "hidden": true,
                 "description": "Makes backend skip steps in the sources with names matching given pattern. VM will try leave blacklisted scripts by performing 'step in' several times, finally resorting to 'step out' if unsuccessful."
             },
             {
                 "name": "setAsyncCallStackDepth",
                 "parameters": [
                     { "name": "maxDepth", "type": "integer", "description": "Maximum depth of async call stacks. Setting to <code>0</code> will effectively disable collecting async call stacks (default)." }
                 ],
                 "hidden": true,
                 "description": "Enables or disables async call stacks tracking."
+            },
+            {
+                "name": "enablePromiseTracker",
+                "hidden": true,
+                "description": "Enables promise tracking."
+            },
+            {
+                "name": "disablePromiseTracker",
+                "hidden": true,
+                "description": "Disables promise tracking."
+            },
+            {
+                "name": "getPromises",
+                "returns": [
+                    { "name": "promises", "type": "array", "items": { "$ref": "PromiseDetails" }, "description": "Returns detailed information about all <code>Promise</code>s that were created or updated after the <code>enablePromiseTracker</code> command, and were not yet garbage collected." }

[aandrey, 2014/09/02 14:34:49]

this should be a description for "getPromises" command itself, not the
"promises" result

[Alexandra Mikhaylova, 2014/09/03 14:28:55]

Oops. Thanks, fixed this.

+                ],
+                "hidden": true,
+                "description": "Pulls information about stored promises."
             }
         ],
         "events": [
             {
                 "name": "globalObjectCleared",
                 "description": "Called when global has been cleared and debugger client should reset its state. Happens upon navigation or reload."
             },
             {
                 "name": "scriptParsed",
                 "parameters": [
@@ skipping 942 matching lines @@
             {
                 "name": "dataAvailable",
                 "parameters": [
                     {"name": "value", "type": "array", "items": { "$ref": "PowerEvent" }, "description": "List of power events." }
                 ],
                 "handlers": ["browser", "frontend"]
             }
         ]
     }]
 }