DevTools: introduce browser domain for basic target discovery.

third_party/WebKit/Source/core/inspector/browser_protocol.json

Index: third_party/WebKit/Source/core/inspector/browser_protocol.json
diff --git a/third_party/WebKit/Source/core/inspector/browser_protocol.json b/third_party/WebKit/Source/core/inspector/browser_protocol.json
index 7b26c7571abd047f450ea0856f30658875fa06db..efefb92fe94609eb444ee5eeb086c6bf74305966 100644
--- a/third_party/WebKit/Source/core/inspector/browser_protocol.json
+++ b/third_party/WebKit/Source/core/inspector/browser_protocol.json
@@ -4213,5 +4213,72 @@
                 "handlers": ["browser"]
             }
         ]
+    },
+    {
+        "domain": "Browser",

[dgozman, 2016/06/08 03:53:29]

Will we migrate targets from ServiceWorker domain to this one?

[pfeldman, 2016/06/08 15:54:53]

Yes

+        "description": "The Browser domain allows listing, creating, activating and attaching to the targets.",
+        "hidden": true,
+        "types": [
+            {
+                "id": "TargetID",
+                "type": "string"
+            },
+            {
+                "id": "TargetInfo",
+                "type": "object",
+                "properties": [
+                    { "name": "targetId", "$ref": "TargetID" },
+                    { "name": "type", "type": "string" },
+                    { "name": "title", "type": "string" },
+                    { "name": "url", "type": "string" }
+                ]
+            }
+        ],
+        "commands": [
+            {
+                "name": "getTargets",
+                "returns": [
+                    { "name": "targetInfo", "type": "array", "items": { "$ref": "TargetInfo" } }
+                ],
+                "description": "Returns target information for all potential targets.",
+                "handlers": ["browser"]
+            },
+            {
+                "name": "attach",
+                "description": "Attaches to the target with given id.",
+                "parameters": [
+                    {"name": "targetId", "$ref": "TargetID", "description": "Target id." }
+                ],
+                "handlers": ["browser"]
+            },
+            {
+                "name": "detach",
+                "description": "Detaches from the target with given id.",
+                "parameters": [
+                    { "name": "targetId", "$ref": "TargetID" }
+                ],
+                "handlers": ["browser"]
+            },
+            {
+                "name": "sendMessage",

[dgozman, 2016/06/08 03:53:29]

Oh-oh. Sounds like a duplication of worker domain. Should we merge them? If so,
maybe Browser is not that good of a name.

[pfeldman, 2016/06/08 15:54:53]

I don't plan on merging them atm. Are you suggesting to rename it to Subtargets?
I can think of it in a follow-up.

[dgozman, 2016/06/08 15:59:09]

Yeah, something along this lines.

+                "description": "Sends protocol message to the target with given id.",
+                "parameters": [
+                    { "name": "targetId", "$ref": "TargetID" },
+                    { "name": "message", "type": "string" }
+                ],
+                "handlers": ["browser"]
+            }
+        ],
+        "events": [
+            {
+                "name": "dispatchMessage",
+                "description": "Dispatches protocol message from the target with given id.",
+                "parameters": [
+                    { "name": "targetId", "$ref": "TargetID" },
+                    { "name": "message", "type": "string" }
+                ],
+                "handlers": ["browser"]
+            }
+        ]
     }]
 }