Add chrome.debugger.getTargets method to discover available debug targets.

chrome/common/extensions/api/debugger.json

Index: chrome/common/extensions/api/debugger.json
diff --git a/chrome/common/extensions/api/debugger.json b/chrome/common/extensions/api/debugger.json
index 24c5d15d3424c9a8be712bad03c05d821210c2ff..50b7089bc35ef49b5aafb66371904e1c5ce39c8d 100644
--- a/chrome/common/extensions/api/debugger.json
+++ b/chrome/common/extensions/api/debugger.json
@@ -12,7 +12,21 @@
         "description": "Debuggee identifier. Either tabId or extensionId must be specified",
         "properties": {
           "tabId": { "type": "integer", "optional": true, "description": "The id of the tab which you intend to debug." },
-          "extensionId": { "type": "string", "optional": true, "description": "The id of the extension which you intend to debug. Attaching to an extension background page is only possible when 'enable-silent-debugging' flag is enabled on the target browser." }
+          "extensionId": { "type": "string", "optional": true, "description": "The id of the extension which you intend to debug. Attaching to an extension background page is only possible when 'enable-silent-debugging' flag is enabled on the target browser." },
+          "targetId": { "type": "string", "optional": true, "description": "The opaque id of the debug target." }
+        }
+      },
+      {
+        "id": "TargetInfo",
+        "type": "object",
+        "description": "Debug target information",
+        "properties": {
+          "id": { "type": "string", "description": "Target id." },
+          "type": { "type": "string", "description": "Target type ('page' or 'extension')." },

[pfeldman, 2013/03/15 11:25:45]

If we are declaring it public, we need to declare it as enum with all values
thought through.

[Vladislav Kaznacheev, 2013/03/18 06:40:37]

Done.

+          "attached": { "type": "boolean", "description": "True if debugger is already attached." },
+          "title": { "type": "string", "description": "Target page title." },
+          "url": { "type": "string", "description": "Target URL." },
+          "faviconUrl": { "type": "string", "description": "Target favicon URL." }
         }
       }
     ],
@@ -98,6 +112,25 @@
             "description": "Response body. If an error occurs while posting the message, the callback will be called with no arguments and $ref:runtime.lastError will be set to the error message."
           }
         ]
+      },
+      {
+        "name": "getTargets",
+        "type": "function",
+        "description": "Returns the list of available debug targets.",
+        "parameters": [
+          {
+            "type": "function",
+            "name": "callback",
+            "parameters": [
+              {
+                "type": "array",
+                "name": "result",
+                "items": {"$ref": "TargetInfo"},
+                "description": "Array of TargetInfo objects corresponding to the available debug targets."
+              }
+            ]
+          }
+        ]
       }
     ],
     "events": [