[DevTools] Added setBlackboxPatterns method to protocol

third_party/WebKit/Source/devtools/protocol.json

 {
     "version": { "major": "1", "minor": "1" },
     "domains": [{
         "domain": "Inspector",
         "hidden": true,
         "types": [],
         "commands": [
             {
                 "name": "enable",
                 "description": "Enables inspector domain notifications.",
@@ skipping 3346 matching lines @@
                 "id": "BreakpointId",
                 "type": "string",
                 "description": "Breakpoint identifier."
             },
             {
                 "id": "CallFrameId",
                 "type": "string",
                 "description": "Call frame identifier."
             },
             {
+                "id": "ScriptHash",
+                "type": "string",
+                "description": "Script's content hash."
+            },
+            {
                 "id": "Location",
                 "type": "object",
                 "properties": [
                     { "name": "scriptId", "$ref": "Runtime.ScriptId", "description": "Script identifier as reported in the <code>Debugger.scriptParsed</code>." },
                     { "name": "lineNumber", "type": "integer", "description": "Line number in the script (0-based)." },
                     { "name": "columnNumber", "type": "integer", "optional": true, "description": "Column number in the script (0-based)." }
                 ],
                 "description": "Location in the source code."
             },
             {
                 "id": "ScriptPosition",
                 "hidden": true,
                 "type": "object",
                 "properties": [
                     { "name": "line", "type": "integer" },
                     { "name": "column", "type": "integer" }
                 ],
                 "description": "Location in the source code."
             },
             {
+                "id": "BlackboxPattern",
+                "hidden": true,
+                "type": "object",
+                "properties": [
+                    { "name": "url", "type": "string", "optional": true },
+                    { "name": "hash", "$ref": "ScriptHash", "optional": true },
+                    { "name": "regexp", "type": "string", "optional": true },
+                    { "name": "positions", "type": "array", "items": { "$ref": "ScriptPosition" }, "optional": true }
+                ],
+                "description": "Pattern contains one of script selector: url, hash or regexp for url and optional positions array if url or hast is set."
+            },
+            {
                 "id": "FunctionDetails",
                 "hidden": true,
                 "type": "object",
                 "properties": [
                     { "name": "location", "$ref": "Location", "optional": true, "description": "Location of the function, none for native functions." },
                     { "name": "functionName", "type": "string", "description": "Name of the function." },
                     { "name": "isGenerator", "type": "boolean", "description": "Whether this is a generator function." },
                     { "name": "scopeChain", "type": "array", "optional": true, "items": { "$ref": "Scope" }, "description": "Scope chain for this closure." }
                 ],
                 "description": "Information about the function."
@@ skipping 379 matching lines @@
             },
             {
                 "name": "removeAsyncOperationBreakpoint",
                 "parameters": [
                     { "name": "operationId", "type": "integer", "description": "ID of the async operation to remove breakpoint for." }
                 ],
                 "hidden": true,
                 "description": "Removes AsyncOperation breakpoint."
             },
             {
-                "name": "setBlackboxedRanges",
+                "name": "addBlackboxPatterns",
                 "parameters": [
-                    { "name": "scriptId", "$ref": "Runtime.ScriptId", "description": "Id of the script." },
-                    { "name": "positions", "type": "array", "items": { "$ref": "ScriptPosition" } }
+                    { "name": "patterns", "type": "array", "items": { "$ref": "BlackboxPattern"} }

[pfeldman, 2016/03/07 19:22:47]

Why is the add/clear contract? It is typically either add/remove or set/clear.

[kozy, 2016/03/08 02:33:20]

I'd like to set initial pattern on debugger enable then add patterns on events
like source map loaded and then clear all patterns on pattern changed. We've
discussed this API in offline discussion with @dgozman.

                 ],
                 "hidden": true,
                 "description": "Makes backend skip steps in the script in blackboxed ranges. VM will try leave blacklisted scripts by performing 'step in' several times, finally resorting to 'step out' if unsuccessful. Positions array contains positions where blackbox state is changed. First interval isn't blackboxed. Array should be sorted."

[dgozman, 2016/03/07 17:26:13]

Please move detailed description of positions to BlackboxPattern.

[kozy, 2016/03/08 02:33:20]

Done.

+            },
+            {
+                "name": "clearBlackboxPatterns",
+                "hidden": true,
+                "description": "Clear all added blackbox patterns."
             }
         ],
         "events": [
             {
                 "name": "globalObjectCleared",
                 "description": "Called when global has been cleared and debugger client should reset its state. Happens upon navigation or reload."
             },
             {
                 "name": "scriptParsed",
                 "parameters": [
                     { "name": "scriptId", "$ref": "Runtime.ScriptId", "description": "Identifier of the script parsed." },
                     { "name": "url", "type": "string", "description": "URL or name of the script parsed (if any)." },
                     { "name": "startLine", "type": "integer", "description": "Line offset of the script within the resource with given URL (for script tags)." },
                     { "name": "startColumn", "type": "integer", "description": "Column offset of the script within the resource with given URL." },
                     { "name": "endLine", "type": "integer", "description": "Last line of the script." },
                     { "name": "endColumn", "type": "integer", "description": "Length of the last line of the script." },
                     { "name": "executionContextId", "$ref": "Runtime.ExecutionContextId", "description": "Specifies script creation context.", "hidden": true },
-                    { "name": "hash", "type": "string", "hidden": true, "description": "Content hash of the script."},
+                    { "name": "hash", "$ref": "ScriptHash", "optional": true, "hidden": true, "description": "Content hash of the script."},
                     { "name": "isContentScript", "type": "boolean", "optional": true, "description": "Determines whether this script is a user extension script." },
                     { "name": "isInternalScript", "type": "boolean", "optional": true, "description": "Determines whether this script is an internal script.", "hidden": true },
                     { "name": "isLiveEdit", "type": "boolean", "optional": true, "description": "True, if this script is generated as a result of the live edit operation.", "hidden": true },
                     { "name": "sourceMapURL", "type": "string", "optional": true, "description": "URL of source map associated with script (if any)." },
                     { "name": "hasSourceURL", "type": "boolean", "optional": true, "description": "True, if this script has sourceURL.", "hidden": true },
                     { "name": "deprecatedCommentWasUsed", "type": "boolean", "optional": true, "hidden": true, "description": "True, if '//@ sourceURL' or '//@ sourceMappingURL' was used."}
                 ],
                 "description": "Fired when virtual machine parses script. This event is also fired for all known and uncollected scripts upon enabling debugger."
             },
             {
                 "name": "scriptFailedToParse",
                 "parameters": [
                     { "name": "scriptId", "$ref": "Runtime.ScriptId", "description": "Identifier of the script parsed." },
                     { "name": "url", "type": "string", "description": "URL or name of the script parsed (if any)." },
                     { "name": "startLine", "type": "integer", "description": "Line offset of the script within the resource with given URL (for script tags)." },
                     { "name": "startColumn", "type": "integer", "description": "Column offset of the script within the resource with given URL." },
                     { "name": "endLine", "type": "integer", "description": "Last line of the script." },
                     { "name": "endColumn", "type": "integer", "description": "Length of the last line of the script." },
                     { "name": "executionContextId", "$ref": "Runtime.ExecutionContextId", "description": "Specifies script creation context.", "hidden": true },
-                    { "name": "hash", "type": "string", "hidden": true, "description": "Content hash of the script."},
+                    { "name": "hash", "$ref": "ScriptHash", "optional": true, "hidden": true, "description": "Content hash of the script."},
                     { "name": "isContentScript", "type": "boolean", "optional": true, "description": "Determines whether this script is a user extension script." },
                     { "name": "isInternalScript", "type": "boolean", "optional": true, "description": "Determines whether this script is an internal script.", "hidden": true },
                     { "name": "sourceMapURL", "type": "string", "optional": true, "description": "URL of source map associated with script (if any)." },
                     { "name": "hasSourceURL", "type": "boolean", "optional": true, "description": "True, if this script has sourceURL.", "hidden": true },
                     { "name": "deprecatedCommentWasUsed", "type": "boolean", "optional": true, "hidden": true, "description": "True, if '//@ sourceURL' or '//@ sourceMappingURL' was used."}
                 ],
                 "description": "Fired when virtual machine fails to parse the script."
             },
             {
                 "name": "breakpointResolved",
@@ skipping 1324 matching lines @@
                 ],
                 "returns": [
                     { "name": "accessibilityNode", "$ref": "AXNode", "description": "The <code>Accessibility.AXNode</code> for this DOM node, if it exists.", "optional": true }
                 ],
                 "description": "Fetches the accessibility node for this DOM node, if it exists.",
                 "hidden": true
             }
         ]
     }]
 }