Rename traverseFrames to pierce and traverse shadow dom too.

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 08acb7bd0cc6490b65856a9dc16f2585a5037d7b..0c150b687fdd471ea906bf3a2ca8c62054b938cb 100644
--- a/third_party/WebKit/Source/core/inspector/browser_protocol.json
+++ b/third_party/WebKit/Source/core/inspector/browser_protocol.json
@@ -2122,7 +2122,7 @@
                 "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 }
+                    { "name": "traverseFrames", "type": "boolean", "optional": true, "description": "Whether or not iframes and shadow roots should be traversed when returning the subtree (default is false).", "experimental": true }

[Sami, 2016/11/11 15:29:42]

I'll leave this up to you but it feels a little weird to have this flag control
both settings. Is there a reason we shouldn't add a traverseShadowRoots flag?

[alex clarke (OOO till 29th), 2016/11/14 16:25:25]

The use case I had in mind doesn't need it but we could do.  Pavel / Dmitry do
you have a preference?

[pfeldman, 2016/11/14 18:35:06]

No strong preference. We can call it in an intentionally ambiguous manner such
as "pierce" to go through shadow, templates, iframes and everything.

                 ],
                 "returns": [
                     { "name": "root", "$ref": "Node", "description": "Resulting node." }
@@ -2145,7 +2145,7 @@
                 "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": "traverseFrames", "type": "boolean", "optional": true, "description": "Whether or not iframes should be traversed when returning the sub-tree (default is false).", "experimental": true }
+                    { "name": "traverseFrames", "type": "boolean", "optional": true, "description": "Whether or not iframes and shadow roots 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."
             },