[DevTools] Introduce provisional blackboxing

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 879 matching lines @@
             },
             {
                 "id": "StackTrace",
                 "type": "object",
                 "description": "Call frames for assertions or error messages.",
                 "properties": [
                     { "name": "description", "type": "string", "optional": true, "description": "String label of this stack trace. For async traces this may be a name of the function that initiated the async call." },
                     { "name": "callFrames", "type": "array", "items": { "$ref": "CallFrame" }, "description": "JavaScript function name." },
                     { "name": "parent", "$ref": "StackTrace", "optional": true, "hidden": true, "hidden": true, "description": "Asynchronous JavaScript stack trace that preceded this stack, if available." }
                 ]
+            },
+            {
+                "id": "SourceRange",
+                "type": "object",
+                "properties": [
+                    { "name": "startLine", "type": "integer", "description": "Start line of range." },
+                    { "name": "startColumn", "type": "integer", "description": "Start column of range (inclusive)." },
+                    { "name": "endLine", "type": "integer", "description": "End line of range" },
+                    { "name": "endColumn", "type": "integer", "description": "End column of range (exclusive)." }
+                ],
+                "description": "Text range within a resource. All numbers are zero-based.",
+                "hidden": true
             }
         ],
         "commands": [
             {
                 "name": "evaluate",
                 "parameters": [
                     { "name": "expression", "type": "string", "description": "Expression to evaluate." },
                     { "name": "objectGroup", "type": "string", "optional": true, "description": "Symbolic group name that can be used to release multiple objects." },
                     { "name": "includeCommandLineAPI", "type": "boolean", "optional": true, "description": "Determines whether Command Line API should be available during the evaluation.", "hidden": true },
                     { "name": "doNotPauseOnExceptionsAndMuteConsole", "type": "boolean", "optional": true, "description": "Specifies whether evaluation should stop on exceptions and mute console. Overrides setPauseOnException state.", "hidden": true },
@@ skipping 2001 matching lines @@
                     { "name": "rule", "$ref": "CSSRule", "description": "CSS rule in the match." },
                     { "name": "matchingSelectors", "type": "array", "items": { "type": "integer" }, "description": "Matching selector indices in the rule's selectorList selectors (0-based)." }
                 ],
                 "description": "Match data for a CSS rule."
             },
             {
                 "id": "Value",
                 "type": "object",
                 "properties": [
                     { "name": "text", "type": "string", "description": "Value text." },
-                    { "name": "range", "$ref": "SourceRange", "optional": true, "description": "Value range in the underlying resource (if available)." }
+                    { "name": "range", "$ref": "Runtime.SourceRange", "optional": true, "description": "Value range in the underlying resource (if available)." }
                 ],
                 "description": "Data for a simple selector (these are delimited by commas in a selector list)."
             },
             {
                 "id": "SelectorList",
                 "type": "object",
                 "properties": [
                     { "name": "selectors", "type": "array", "items": { "$ref": "Value" }, "description": "Selectors in the list." },
                     { "name": "text", "type": "string", "description": "Rule selector text." }
                 ],
@@ skipping 24 matching lines @@
                 "properties": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "optional": true, "description": "The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from." },
                     { "name": "selectorList", "$ref": "SelectorList", "description": "Rule selector data." },
                     { "name": "origin", "$ref": "StyleSheetOrigin", "description": "Parent stylesheet's origin."},
                     { "name": "style", "$ref": "CSSStyle", "description": "Associated style declaration." },
                     { "name": "media", "type": "array", "items": { "$ref": "CSSMedia" }, "optional": true, "description": "Media list array (for rules involving media queries). The array enumerates media queries starting with the innermost one, going outwards." }
                 ],
                 "description": "CSS rule representation."
             },
             {
-                "id": "SourceRange",

[dgozman, 2016/04/20 02:06:40]

Let's keep two SourceRanges.

-                "type": "object",
-                "properties": [
-                    { "name": "startLine", "type": "integer", "description": "Start line of range." },
-                    { "name": "startColumn", "type": "integer", "description": "Start column of range (inclusive)." },
-                    { "name": "endLine", "type": "integer", "description": "End line of range" },
-                    { "name": "endColumn", "type": "integer", "description": "End column of range (exclusive)." }
-                ],
-                "description": "Text range within a resource. All numbers are zero-based."
-            },
-            {
                 "id": "ShorthandEntry",
                 "type": "object",
                 "properties": [
                     { "name": "name", "type": "string", "description": "Shorthand name." },
                     { "name": "value", "type": "string", "description": "Shorthand value." },
                     { "name": "important", "type": "boolean", "optional": true, "description": "Whether the property has \"!important\" annotation (implies <code>false</code> if absent)." }
                 ]
             },
             {
                 "id": "CSSComputedStyleProperty",
                 "type": "object",
                 "properties": [
                     { "name": "name", "type": "string", "description": "Computed style property name." },
                     { "name": "value", "type": "string", "description": "Computed style property value." }
                 ]
             },
             {
                 "id": "CSSStyle",
                 "type": "object",
                 "properties": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "optional": true, "description": "The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from." },
                     { "name": "cssProperties", "type": "array", "items": { "$ref": "CSSProperty" }, "description": "CSS properties in the style." },
                     { "name": "shorthandEntries", "type": "array", "items": { "$ref": "ShorthandEntry" }, "description": "Computed values for all shorthands found in the style." },
                     { "name": "cssText", "type": "string", "optional": true, "description": "Style declaration text (if available)." },
-                    { "name": "range", "$ref": "SourceRange", "optional": true, "description": "Style declaration range in the enclosing stylesheet (if available)." }
+                    { "name": "range", "$ref": "Runtime.SourceRange", "optional": true, "description": "Style declaration range in the enclosing stylesheet (if available)." }
                 ],
                 "description": "CSS style representation."
             },
             {
                 "id": "CSSProperty",
                 "type": "object",
                 "properties": [
                     { "name": "name", "type": "string", "description": "The property name." },
                     { "name": "value", "type": "string", "description": "The property value." },
                     { "name": "important", "type": "boolean", "optional": true, "description": "Whether the property has \"!important\" annotation (implies <code>false</code> if absent)." },
                     { "name": "implicit", "type": "boolean", "optional": true, "description": "Whether the property is implicit (implies <code>false</code> if absent)." },
                     { "name": "text", "type": "string", "optional": true, "description": "The full property text as specified in the style." },
                     { "name": "parsedOk", "type": "boolean", "optional": true, "description": "Whether the property is understood by the browser (implies <code>true</code> if absent)." },
                     { "name": "disabled", "type": "boolean", "optional": true, "description": "Whether the property is disabled by the user (present for source-based properties only)." },
-                    { "name": "range", "$ref": "SourceRange", "optional": true, "description": "The entire property range in the enclosing style declaration (if available)." }
+                    { "name": "range", "$ref": "Runtime.SourceRange", "optional": true, "description": "The entire property range in the enclosing style declaration (if available)." }
                 ],
                 "description": "CSS property declaration data."
             },
             {
                 "id": "CSSMedia",
                 "type": "object",
                 "properties": [
                     { "name": "text", "type": "string", "description": "Media query text." },
                     { "name": "source", "type": "string", "enum": ["mediaRule", "importRule", "linkedSheet", "inlineSheet"], "description": "Source of the media query: \"mediaRule\" if specified by a @media rule, \"importRule\" if specified by an @import rule, \"linkedSheet\" if specified by a \"media\" attribute in a linked stylesheet's LINK tag, \"inlineSheet\" if specified by a \"media\" attribute in an inline stylesheet's STYLE tag." },
                     { "name": "sourceURL", "type": "string", "optional": true, "description": "URL of the document containing the media query description." },
-                    { "name": "range", "$ref": "SourceRange", "optional": true, "description": "The associated rule (@media or @import) header range in the enclosing stylesheet (if available)." },
+                    { "name": "range", "$ref": "Runtime.SourceRange", "optional": true, "description": "The associated rule (@media or @import) header range in the enclosing stylesheet (if available)." },
                     { "name": "parentStyleSheetId", "$ref": "StyleSheetId", "optional": true, "description": "Identifier of the stylesheet containing this object (if exists)." },
                     { "name": "mediaList", "type": "array", "items": { "$ref": "MediaQuery" }, "optional": true, "hidden": true, "description": "Array of media queries." }
                 ],
                 "description": "CSS media rule descriptor."
             },
             {
                 "id": "MediaQuery",
                 "type": "object",
                 "properties": [
                     { "name": "expressions", "type": "array", "items": { "$ref": "MediaQueryExpression" }, "description": "Array of media query expressions." },
                     { "name": "active", "type": "boolean", "description": "Whether the media query condition is satisfied." }
                 ],
                 "description": "Media query descriptor.",
                 "hidden": true
             },
             {
                 "id": "MediaQueryExpression",
                 "type": "object",
                 "properties": [
                     { "name": "value", "type": "number", "description": "Media query expression value."},
                     { "name": "unit", "type": "string", "description": "Media query expression units."},
                     { "name": "feature", "type": "string", "description": "Media query expression feature."},
-                    { "name": "valueRange", "$ref": "SourceRange", "optional": true, "description": "The associated range of the value text in the enclosing stylesheet (if available)." },
+                    { "name": "valueRange", "$ref": "Runtime.SourceRange", "optional": true, "description": "The associated range of the value text in the enclosing stylesheet (if available)." },
                     { "name": "computedLength", "type": "number", "optional": true, "description": "Computed length of media query expression (if applicable)."}
                 ],
                 "description": "Media query expression descriptor.",
                 "hidden": true
             },
             {
                 "id": "PlatformFontUsage",
                 "type": "object",
                 "properties": [
                     { "name": "familyName", "type": "string", "description": "Font's family name reported by platform."},
@@ skipping 21 matching lines @@
                     { "name": "keyText", "$ref": "Value", "description": "Associated key text." },
                     { "name": "style", "$ref": "CSSStyle", "description": "Associated style declaration." }
                 ],
                 "description": "CSS keyframe rule representation."
             },
             {
                 "id": "StyleDeclarationEdit",
                 "type": "object",
                 "properties": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "The css style sheet identifier." },
-                    { "name": "range", "$ref": "SourceRange", "description": "The range of the style text in the enclosing stylesheet." },
+                    { "name": "range", "$ref": "Runtime.SourceRange", "description": "The range of the style text in the enclosing stylesheet." },
                     { "name": "text", "type": "string", "description": "New style text."}
                 ],
                 "description": "A descriptor of operation to mutate style declaration text."
             }
         ],
         "commands": [
             {
                 "name": "enable",
                 "async": true,
                 "description": "Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been enabled until the result of this command is received."
@@ skipping 67 matching lines @@
                 ],
                 "returns": [
                     { "name": "sourceMapURL", "type": "string", "optional": true, "description": "URL of source map associated with script (if any)." }
                 ],
                 "description": "Sets the new stylesheet text."
             },
             {
                 "name": "setRuleSelector",
                 "parameters": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId" },
-                    { "name": "range", "$ref": "SourceRange" },
+                    { "name": "range", "$ref": "Runtime.SourceRange" },
                     { "name": "selector", "type": "string" }
                 ],
                 "returns": [
                     { "name": "selectorList", "$ref": "SelectorList", "description": "The resulting selector list after modification." }
                 ],
                 "description": "Modifies the rule selector."
             },
             {
                 "name": "setKeyframeKey",
                 "parameters": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId" },
-                    { "name": "range", "$ref": "SourceRange" },
+                    { "name": "range", "$ref": "Runtime.SourceRange" },
                     { "name": "keyText", "type": "string" }
                 ],
                 "returns": [
                     { "name": "keyText", "$ref": "Value", "description": "The resulting key text after modification." }
                 ],
                 "description": "Modifies the keyframe rule key text."
             },
             {
                 "name": "setStyleTexts",
                 "parameters": [
                     { "name": "edits", "type": "array", "items": { "$ref": "StyleDeclarationEdit" }}
                 ],
                 "returns": [
                     { "name": "styles", "type": "array", "items": { "$ref": "CSSStyle" }, "description": "The resulting styles after modification." }
                 ],
                 "description": "Applies specified style edits one after another in the given order."
             },
             {
                 "name": "setMediaText",
                 "parameters": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId" },
-                    { "name": "range", "$ref": "SourceRange" },
+                    { "name": "range", "$ref": "Runtime.SourceRange" },
                     { "name": "text", "type": "string" }
                 ],
                 "returns": [
                     { "name": "media", "$ref": "CSSMedia", "description": "The resulting CSS media rule after modification." }
                 ],
                 "description": "Modifies the rule selector."
             },
             {
                 "name": "createStyleSheet",
                 "parameters": [
                     { "name": "frameId", "$ref": "Page.FrameId", "description": "Identifier of the frame where \"via-inspector\" stylesheet should be created."}
                 ],
                 "returns": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "Identifier of the created \"via-inspector\" stylesheet." }
                 ],
                 "description": "Creates a new special \"via-inspector\" stylesheet in the frame with given <code>frameId</code>."
             },
             {
                 "name": "addRule",
                 "parameters": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "The css style sheet identifier where a new rule should be inserted." },
                     { "name": "ruleText", "type": "string", "description": "The text of a new rule." },
-                    { "name": "location", "$ref": "SourceRange", "description": "Text position of a new rule in the target style sheet." }
+                    { "name": "location", "$ref": "Runtime.SourceRange", "description": "Text position of a new rule in the target style sheet." }
                 ],
                 "returns": [
                     { "name": "rule", "$ref": "CSSRule", "description": "The newly created rule." }
                 ],
                 "description": "Inserts a new rule with the given <code>ruleText</code> in a stylesheet with given <code>styleSheetId</code>, at the position specified by <code>location</code>."
             },
             {
                 "name": "forcePseudoState",
                 "parameters": [
                     { "name": "nodeId", "$ref": "DOM.NodeId", "description": "The element id for which to force the pseudo state." },
@@ skipping 53 matching lines @@
                 "name": "styleSheetRemoved",
                 "parameters": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "Identifier of the removed stylesheet." }
                 ],
                 "description": "Fired whenever an active document stylesheet is removed."
             },
             {
                 "name": "layoutEditorChange",
                 "parameters": [
                     { "name": "styleSheetId", "$ref": "StyleSheetId", "description": "Identifier of the stylesheet where the modification occurred." },
-                    { "name": "changeRange", "$ref": "SourceRange", "description": "Range where the modification occurred." }
+                    { "name": "changeRange", "$ref": "Runtime.SourceRange", "description": "Range where the modification occurred." }
                 ]
             }
         ]
     },
     {
         "domain": "IO",
         "description": "Input/Output operations for streams produced by DevTools.",
         "hidden": true,
         "types": [
             {
@@ skipping 45 matching lines @@
                 "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": "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 291 matching lines @@
             },
             {
                 "name": "setAsyncCallStackDepth",
                 "parameters": [
                     { "name": "maxDepth", "type": "integer", "description": "Maximum depth of async call stacks. Setting to <code>0</code> will effectively disable collecting async call stacks (default)." }
                 ],
                 "hidden": true,
                 "description": "Enables or disables async call stacks tracking."
             },
             {
-                "name": "setBlackboxedRanges",
+                "name": "setBlackboxPatterns",
                 "parameters": [
-                    { "name": "scriptId", "$ref": "Runtime.ScriptId", "description": "Id of the script." },
-                    { "name": "positions", "type": "array", "items": { "$ref": "ScriptPosition" } }
+                    { "name": "patterns", "type": "array", "items": { "type": "string" }, "description": "Array of regexps that will be used to check script url for blackbox state." }
                 ],
                 "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."
+                "description": "Replace previous blackbox patterns with passed one. 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."

[dgozman, 2016/04/20 02:06:40]

Replace previous blackbox patterns with passed ones. Forces backend to skip
stepping/pausing in scripts with url matching one of the patterns. VM will try
to leave blackboxed script by performing 'step in' several times, finally
resorting to 'step out' if unsuccessful.

+            },
+            {
+                "name": "setScriptBlackboxed",
+                "parameters": [
+                    { "name": "hash", "type": "string", "optional": true },
+                    { "name": "url", "type": "string", "optional": true },
+                    { "name": "ranges", "type": "array", "items": { "$ref": "Runtime.SourceRange" }, "optional": true, "description": "Ranges should be sorted. If ranges is omitted then whole script will be blackboxed." }
+                ],
+                "hidden": true,
+                "description": "Set blackboxed ranges for script with given hash or url. 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."

[dgozman, 2016/04/20 02:06:40]

Set blackboxed ranges for script with given hash or url. Forces backend to skip
stepping/pausing in the script inside blackboxed ranges. VM will try to leave
blackboxed script by performing 'step in' several times, finally resorting to
'step out' if unsuccessful.

             }
         ],
         "events": [
             {
                 "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." },
@@ skipping 1352 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
             }
         ]
     }]
 }