Make DOM.getChildNodes & DOM.getDocument optionally pierce iframe boundaries

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

 {
     "version": { "major": "1", "minor": "2" },
     "domains": [{
         "domain": "Inspector",
         "experimental": true,
         "types": [],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables inspector domain notifications.",
@@ skipping 2142 matching lines @@
             {
                 "name": "enable",
                 "description": "Enables DOM agent for the given page."
             },
             {
                 "name": "disable",
                 "description": "Disables DOM agent for the given page."
             },
             {
                 "name": "getDocument",
+                "parameters": [
+                    { "name": "depth", "type": "integer", "optional": true, "description": "The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.", "experimental": true },
+                    { "name": "traverseFrames", "type": "boolean", "optional": true, "description": "Whether or not iframes should be traversed when returning the subtree (default is false).", "experimental": true }
+                ],
                 "returns": [
                     { "name": "root", "$ref": "Node", "description": "Resulting node." }
                 ],
-                "description": "Returns the root DOM node to the caller."
+                "description": "Returns the root DOM node (and optionally the subtree) to the caller."
             },
             {
                 "name": "collectClassNamesFromSubtree",
                 "parameters": [
                     { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to collect class names." }
                 ],
                 "returns": [
                     {"name": "classNames", "type": "array", "items": { "type": "string" }, "description": "Class name list." }
                 ],
                 "description": "Collects class names for the node with given id and all of it's child nodes.",
                 "experimental": true
             },
             {
                 "name": "requestChildNodes",
                 "parameters": [
                     { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to get children for." },
-                    { "name": "depth", "type": "integer", "optional": true, "description": "The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.", "experimental": true }
+                    { "name": "depth", "type": "integer", "optional": true, "description": "The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the entire subtree or provide an integer larger than 0.", "experimental": true },
+                    { "name": "traverseFrames", "type": "boolean", "optional": true, "description": "Whether or not iframes should be traversed when returning the sub-tree (default is false).", "experimental": true }
                 ],
                 "description": "Requests that children of the node with given id are returned to the caller in form of <code>setChildNodes</code> events where not only immediate children are retrieved, but all children down to the specified depth."
             },
             {
                 "name": "querySelector",
                 "parameters": [
                     { "name": "nodeId", "$ref": "NodeId", "description": "Id of the node to query upon." },
                     { "name": "selector", "type": "string", "description": "Selector string." }
                 ],
                 "returns": [
@@ skipping 2414 matching lines @@
                 "description": "Informs that port was successfully bound and got a specified connection id.",
                 "parameters": [
                     {"name": "port", "type": "integer", "description": "Port number that was successfully bound." },
                     {"name": "connectionId", "type": "string", "description": "Connection id to be used." }
                 ],
                 "handlers": ["browser"]
             }
         ]
     }]
 }