[DevTools] Added Runtime.awaitPromise protocol method

third_party/WebKit/Source/platform/v8_inspector/js_protocol.json

 {
     "version": { "major": "1", "minor": "1" },
     "domains": [{
         "domain": "Runtime",
         "description": "Runtime domain exposes JavaScript runtime by means of remote evaluation and mirror objects. Evaluation results are returned as mirror object that expose object type, string representation and unique identifier that can be used for further object reference. Original objects are maintained in memory unless they are either explicitly released or are released along with the other objects in their object group.",
         "types": [
             {
                 "id": "ScriptId",
                 "type": "string",
                 "description": "Unique script identifier."
@@ skipping 178 matching lines @@
                     { "name": "userGesture", "type": "boolean", "optional": true, "hidden": true, "description": "Whether execution should be treated as initiated by user in the UI." }
                 ],
                 "returns": [
                     { "name": "result", "$ref": "RemoteObject", "description": "Evaluation result." },
                     { "name": "wasThrown", "type": "boolean", "optional": true, "description": "True if the result was thrown during the evaluation." },
                     { "name": "exceptionDetails", "$ref": "ExceptionDetails", "optional": true, "hidden": true, "description": "Exception details."}
                 ],
                 "description": "Evaluates expression on global object."
             },
             {
+                "name": "promiseThen",

[pfeldman, 2016/07/28 21:05:38]

name: awaitPromise.

also... could we get following addition to existing commands (eval, evanOnCall,
callFuncOn):

            {
                "name": "evaluate",
                "parameters": [
                    { "name": "awaitPromise", "type": "boolean", "optional":
true, "hidden": true, "description": "Whether execution should wait for promise
to be resolved." },
                ],
                "returns": [
                    ...
                ],
                "description": "Evaluates expression on global object."
            },

[kozy, 2016/07/28 22:54:09]

awaitPromise - done.

I'm not sure about additional flag.
Protocol client can emulate awaitEvaluate behavior with 10-lines function:
http://pastebin.com/jycgPrCF
I'll add this in separate CL.

+                "hidden": true,
+                "async": true,
+                "parameters": [
+                    { "name": "promiseObjectId", "$ref": "RemoteObjectId", "description": "Identifier of the promise." },
+                    { "name": "returnByValue", "type": "boolean", "optional": true, "description": "Whether the result is expected to be a JSON object that should be sent by value." },
+                    { "name": "generatePreview", "type": "boolean", "optional": true, "hidden": true, "description": "Whether preview should be generated for the result." }
+                ],
+                "returns": [
+                    { "name": "resolvedValue", "$ref": "RemoteObject", "optional": true },

[dgozman, 2016/07/28 00:07:56]

Let's add description telling that either on or the other is present.

[kozy, 2016/07/28 22:54:09]

Done.

+                    { "name": "rejectedValue", "$ref": "RemoteObject", "optional": true }
+                ]
+            },
+            {
                 "name": "callFunctionOn",
                 "parameters": [
                     { "name": "objectId", "$ref": "RemoteObjectId", "description": "Identifier of the object to call function on." },
                     { "name": "functionDeclaration", "type": "string", "description": "Declaration of the function to call." },
                     { "name": "arguments", "type": "array", "items": { "$ref": "CallArgument", "description": "Call argument." }, "optional": true, "description": "Call arguments. All call arguments must belong to the same JavaScript world as the target object." },
                     { "name": "doNotPauseOnExceptionsAndMuteConsole", "type": "boolean", "optional": true, "description": "Specifies whether function call should stop on exceptions and mute console. Overrides setPauseOnException state.", "hidden": true },
                     { "name": "returnByValue", "type": "boolean", "optional": true, "description": "Whether the result is expected to be a JSON object which should be sent by value." },
                     { "name": "generatePreview", "type": "boolean", "optional": true, "hidden": true, "description": "Whether preview should be generated for the result." },
                     { "name": "userGesture", "type": "boolean", "optional": true, "hidden": true, "description": "Whether execution should be treated as initiated by user in the UI." }
                 ],
@@ skipping 775 matching lines @@
             {
                 "name": "heapStatsUpdate",
                 "description": "If heap objects tracking has been started then backend may send update for one or more fragments",
                 "parameters": [
                     { "name": "statsUpdate", "type": "array", "items": { "type": "integer" }, "description": "An array of triplets. Each triplet describes a fragment. The first integer is the fragment index, the second integer is a total count of objects for the fragment, the third integer is a total size of the objects for the fragment."}
                 ]
             }
         ]
     }]
 }