Class Debugger

  • public class Debugger
extends java.lang.Object

    This class was built using the Chrome Remote Dev-Tools A.P.I., which is specified by two JSON-RPC Files. These files were obtained from the Chrome Dev Tools Protocol Git Hub Page, which has a "Tip of Tree" (the latest) API-Specification Page Here: JSON-RPC Protocol Specification.

    These files were converted into this Java-Browser (CDT) Library; they are a Java-Alternative to the Node.js implementation, other wise known as 'Puppeteer'. The Tool known as 'Selenium' also does quit a bit of Browser-Automation.

    Viewable the Google-API:

    Debugger domain exposes JavaScript debugging capabilities. It allows setting and removing breakpoints, stepping through execution, exploring stack traces, etc.

    This class is intended to be used with a Browser Instance

    These methods have been tested, to some degree, using Google Chrome. In order to use this class you must start a web-browser instance and make a connection to the browser using a Remote Debugging Port. Google-Corporation is the developer of this API, but any browser which accepts a Remote Debug Port Connection over Web-Sockets.

    Google-Chrome was used during the development process of the classes in this particular package. Lately, it has been asserted Microsoft has switched to using the Chrome Browser-Engine for its Microsoft Edge Internal Code-Base. Therefore, there may some functionality available when running the methods in this class with Microsoft-Edge.

    Check whether the your Web-Browser will allow itself to be driven by the Web-Socket RDP-Port 9223. See the examples available in package Torello.Browser to undertand how to build a PageConn and BrowserConn Web-Socket Connection, and how to build a WebSocketSender instance in order to execute the methods in this class.

    Web-Socket & JSON API:
    Every one of the methods that reside in this class are designed to do nothing more than:

    1. Accept Parameters from the User, and "Marshall Them" into a Valid JSON-Request
    2. Transmit the Marshalled Request-JSON to a Headless Web-Browser over a Web-Socket Connection
    3. Receive BOTH that Command-Results AND any Browser Event-Firings from the Web-Socket
    4. Parse JSON Method-Results and Browser-Event Firings, and Subsequently Convert them to Standard Java-Types
    5. Report these Method-Results and Browser-Events to the User via a User-Registered, Event-Listener (Events) or a Promise Object (Command Responses / Results)

    Unlike the bulk of the Java HTML JAR Library, there is very little native Java-Code, and very little testing that may be done on any of the classes & methods in this package. The code inside these classes does nothing more than marshall-and-unmarshall Java-Types into Json-Requests (and vice-versa). The Java-Script & Browser modules inside of a Google-Chrome instance are, theoretically, handling these requests, and returning their results (or events) over the Web-Socket Connection.

    It has been asserted (by Google Chrome Developers) that some of these methods are only "partially working" or "experimental".


    Asking Chat-GPT for Help:
    The LLM otherwise known as "Chat-GPT" does, indeed, have an expert level of knowledge about the "Remote DevTools Protocol". The API that the Chrome DevTools Protocl (CDP) exports is extremely well understood by the LLM, and generally I have found that Chat-GPT understands (by 2 or 3 orders of magnitude) better what my Auto-Generated JSON-Wrappers can do in controlling a Web-Browser than I could ever possibly hope to understand.

    Though not available today, there will soon be an automatically downloadable Token-Stream (AI Embeddings) BUTTON available on my Java-Doc Pages that should hopefully make it extremely easy to post my code-base, RAG Style, to Chat-GPT and other LLM's when 'interogating' them. Presently, because my "Get Token Stream Button" does not exist yet on any of my pages, what you can do is copy-and-paste any Method-Signature from any one of these pages and then ask Chat-GPT to explain what that Browser or Java-Script Function is actually doing. It is very likely to give you some pretty neat answers.

    I have found that every single one of the Domains, Types & Events which are offered by the CDP Protocol (though not documented very well by Google), are perfectly understood by the A.I. LLM - literally to the point where it does know (much better than I ever could) what my own code base actually does!

    Try it out, it's a lot of fun. Note that this package and these classes were originally developed solely to be able to execute the Java-Script that a browser executes when visiting a Web-Site. Complete HTML-Page Content can be scraped (using the HTML Data-Scraping Tools in Java-HTML) off of Web-Sites that have dynamic / Java-Script Generated Content.


    Conspicuous Boxed-Types Usage:
    You may notice that there are many methods that have parameters which accept, for instance, an Integer, instead of a primitive int. Just to remind the readiner, in Java Programs a Boxed Type is a standard Java-Primitive which has been converted into an Object-Reference. The use of Boxed-Types in this code base is an easy-and-fast-way to allow for the concept of "Optional Parameters" or "Optional Field Value."

    Whenever you see a method that accepts an Integer, the reason for this Parameter-Type choice is actually to allow a user to pass 'null' to it. This is a simple way to ELIDE passing any value at all to parameters which Google-Chrome would otherwise assert are "Optional." Whenever you pass 'null' to a Boxed-Types in this class, the Json-Processor will simply eliminate that Object-Property from the command altogether; and the browser will simply not receive any value for that parameter when that command is invoked.

    The Java Language Specification does not have an easy or well defined means of accepting optional method parameters; so Boxed-Types and 'null' are utilized here. Note that 'null' may be passed to any Command Method-Parameter that is listed as Optional on the Java-Doc Page description for that parameter.



    Stateless Class:
    This class neither contains any program-state, nor can it be instantiated. The @StaticFunctional Annotation may also be called 'The Spaghetti Report'. Static-Functional classes are, essentially, C-Styled Files, without any constructors or non-static member fields. It is a concept very similar to the Java-Bean's @Stateless Annotation.

    • 1 Constructor(s), 1 declared private, zero-argument constructor
    • 33 Method(s), 33 declared static
    • 6 Field(s), 6 declared static, 5 declared final
    • Fields excused from final modifier (with explanation):
      Field 'counter' is not final. Reason: CONFIGURATION


    • Method Detail

      • continueToLocation

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> continueToLocation​
            (Debugger.Location location,
             java.lang.String targetCallFrames)
        Continues execution until specific location is reached.
        Parameters:
        location - Location to continue to.
        targetCallFrames - -
        Acceptable Values: ["any", "current"]
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • disable

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> disable()
        Disables debugger for given page.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • enable

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​java.lang.String> enable​
            (java.lang.Number maxScriptsCacheSize)
        Enables debugger for the given page. Clients should not assume that the debugging has been enabled until the result for this command is received.
        Parameters:
        maxScriptsCacheSize - The maximum size in bytes of collected scripts (not referenced by other heap objects) the debugger can hold. Puts no limit if parameter is omitted.
        OPTIONALEXPERIMENTAL
        Returns:
        An instance of Script<String, JsonObject, String>

        This script may be executed, using Script.exec(), and afterwards, a Promise<JsonObject, String> will be returned.

        Finally, the Promise may be awaited, using Promise.await(), and the returned result of this Browser Function may may be retrieved.

        This Browser Function returns

        • String (debuggerId)
          Unique identifier of the debugger.

      • evaluateOnCallFrame

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret2<RunTime.RemoteObject,​RunTime.ExceptionDetails>> evaluateOnCallFrame​
            (java.lang.String callFrameId,
             java.lang.String expression,
             java.lang.String objectGroup,
             java.lang.Boolean includeCommandLineAPI,
             java.lang.Boolean silent,
             java.lang.Boolean returnByValue,
             java.lang.Boolean generatePreview,
             java.lang.Boolean throwOnSideEffect,
             java.lang.Number timeout)
        Evaluates expression on a given call frame.
        Parameters:
        callFrameId - Call frame identifier to evaluate on.
        expression - Expression to evaluate.
        objectGroup - String object group name to put result into (allows rapid releasing resulting object handles using releaseObjectGroup).
        OPTIONAL
        includeCommandLineAPI - Specifies whether command line API should be available to the evaluated expression, defaults to false.
        OPTIONAL
        silent - In silent mode exceptions thrown during evaluation are not reported and do not pause execution. Overrides setPauseOnException state.
        OPTIONAL
        returnByValue - Whether the result is expected to be a JSON object that should be sent by value.
        OPTIONAL
        generatePreview - Whether preview should be generated for the result.
        OPTIONALEXPERIMENTAL
        throwOnSideEffect - Whether to throw an exception if side effect cannot be ruled out during evaluation.
        OPTIONAL
        timeout - Terminate execution after timing out (number of milliseconds).
        OPTIONALEXPERIMENTAL
        Returns:
        An instance of Script<String, JsonObject, Ret2>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret2 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret2

      • getScriptSource

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret2<java.lang.String,​java.lang.String>> getScriptSource​
            (java.lang.String scriptId)
        Returns source for the script with given id.
        Parameters:
        scriptId - Id of the script to get source for.
        Returns:
        An instance of Script<String, JsonObject, Ret2>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret2 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret2

        • Ret2.a: String (scriptSource)
          Script source (empty in case of Wasm bytecode).

        • Ret2.b: String (bytecode)
          Wasm bytecode. (Encoded as a base64 string when passed over JSON)

      • disassembleWasmModule

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret4<java.lang.String,​java.lang.Integer,​int[],​Debugger.WasmDisassemblyChunk>> disassembleWasmModule​
            (java.lang.String scriptId)
        [No Description Provided by Google]
        EXPERIMENTAL
        Parameters:
        scriptId - Id of the script to disassemble
        Returns:
        An instance of Script<String, JsonObject, Ret4>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret4 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret4

        • Ret4.a: String (streamId)
          For large modules, return a stream from which additional chunks of disassembly can be read successively.

        • Ret4.b: Integer (totalNumberOfLines)
          The total number of lines in the disassembly text.

        • Ret4.c: int[] (functionBodyOffsets)
          The offsets of all function bodies, in the format [start1, end1, start2, end2, ...] where all ends are exclusive.

        • Ret4.d: Debugger.WasmDisassemblyChunk (chunk)
          The first chunk of disassembly.

      • getWasmBytecode

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​java.lang.String> getWasmBytecode​
            (java.lang.String scriptId)
        This command is deprecated. Use getScriptSource instead.
        DEPRECATED
        Parameters:
        scriptId - Id of the Wasm script to get source for.
        Returns:
        An instance of Script<String, JsonObject, String>

        This script may be executed, using Script.exec(), and afterwards, a Promise<JsonObject, String> will be returned.

        Finally, the Promise may be awaited, using Promise.await(), and the returned result of this Browser Function may may be retrieved.

        This Browser Function returns

        • String (bytecode)
          Script source. (Encoded as a base64 string when passed over JSON)

      • pause

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> pause()
        Stops on the next JavaScript statement.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • pauseOnAsyncCall

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> pauseOnAsyncCall​
            (RunTime.StackTraceId parentStackTraceId)
        [No Description Provided by Google]
        EXPERIMENTALDEPRECATED
        Parameters:
        parentStackTraceId - Debugger will pause when async call with given stack trace is started.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • removeBreakpoint

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> removeBreakpoint​
            (java.lang.String breakpointId)
        Removes JavaScript breakpoint.
        Parameters:
        breakpointId - -
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • restartFrame

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret3<Debugger.CallFrame[],​RunTime.StackTrace,​RunTime.StackTraceId>> restartFrame​
            (java.lang.String callFrameId,
             java.lang.String mode)
        Restarts particular call frame from the beginning. The old, deprecated behavior of restartFrame is to stay paused and allow further CDP commands after a restart was scheduled. This can cause problems with restarting, so we now continue execution immediatly after it has been scheduled until we reach the beginning of the restarted frame. To stay back-wards compatible, restartFrame now expects a mode parameter to be present. If the mode parameter is missing, restartFrame errors out. The various return values are deprecated and callFrames is always empty. Use the call frames from the Debugger#paused events instead, that fires once V8 pauses at the beginning of the restarted function.
        Parameters:
        callFrameId - Call frame identifier to evaluate on.
        mode - The mode parameter must be present and set to 'StepInto', otherwise restartFrame will error out.
        Acceptable Values: ["StepInto"]
        OPTIONALEXPERIMENTAL
        Returns:
        An instance of Script<String, JsonObject, Ret3>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret3 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret3

      • resume

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> resume​
            (java.lang.Boolean terminateOnResume)
        Resumes JavaScript execution.
        Parameters:
        terminateOnResume - Set to true to terminate execution upon resuming execution. In contrast to RunTime.terminateExecution, this will allows to execute further JavaScript (i.e. via evaluation) until execution of the paused code is actually resumed, at which point termination is triggered. If execution is currently not paused, this parameter has no effect.
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • searchInContent

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Debugger.SearchMatch[]> searchInContent​
            (java.lang.String scriptId,
             java.lang.String query,
             java.lang.Boolean caseSensitive,
             java.lang.Boolean isRegex)
        Searches for given string in script content.
        Parameters:
        scriptId - Id of the script to search in.
        query - String to search for.
        caseSensitive - If true, search is case sensitive.
        OPTIONAL
        isRegex - If true, treats string parameter as regex.
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, Debugger.SearchMatch[]>

        This script may be executed, using Script.exec(), and afterwards, a Promise<JsonObject, Debugger.SearchMatch[]> will be returned.

        Finally, the Promise may be awaited, using Promise.await(), and the returned result of this Browser Function may may be retrieved.

        This Browser Function returns

      • setAsyncCallStackDepth

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setAsyncCallStackDepth​
            (int maxDepth)
        Enables or disables async call stacks tracking.
        Parameters:
        maxDepth - Maximum depth of async call stacks. Setting to 0 will effectively disable collecting async call stacks (default).
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setBlackboxExecutionContexts

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setBlackboxExecutionContexts​
            (java.lang.String[] uniqueIds)
        Replace previous blackbox execution contexts with passed ones. Forces backend to skip stepping/pausing in scripts in these execution contexts. VM will try to leave blackboxed script by performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
        EXPERIMENTAL
        Parameters:
        uniqueIds - Array of execution context unique ids for the debugger to ignore.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setBlackboxPatterns

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setBlackboxPatterns​
            (java.lang.String[] patterns,
             java.lang.Boolean skipAnonymous)
        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.
        EXPERIMENTAL
        Parameters:
        patterns - Array of regexps that will be used to check script url for blackbox state.
        skipAnonymous - If true, also ignore scripts with no source url.
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setBlackboxedRanges

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setBlackboxedRanges​
            (java.lang.String scriptId,
             Debugger.ScriptPosition[] positions)
        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.
        EXPERIMENTAL
        Parameters:
        scriptId - Id of the script.
        positions - -
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setBreakpoint

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret2<java.lang.String,​Debugger.Location>> setBreakpoint​
            (Debugger.Location location,
             java.lang.String condition)
        Sets JavaScript breakpoint at a given location.
        Parameters:
        location - Location to set breakpoint in.
        condition - Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true.
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, Ret2>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret2 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret2

        • Ret2.a: String (breakpointId)
          Id of the created breakpoint for further reference.

        • Ret2.b: Debugger.Location (actualLocation)
          Location this breakpoint resolved into.

      • setInstrumentationBreakpoint

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​java.lang.String> setInstrumentationBreakpoint​
            (java.lang.String instrumentation)
        Sets instrumentation breakpoint.
        Parameters:
        instrumentation - Instrumentation name.
        Acceptable Values: ["beforeScriptExecution", "beforeScriptWithSourceMapExecution"]
        Returns:
        An instance of Script<String, JsonObject, String>

        This script may be executed, using Script.exec(), and afterwards, a Promise<JsonObject, String> will be returned.

        Finally, the Promise may be awaited, using Promise.await(), and the returned result of this Browser Function may may be retrieved.

        This Browser Function returns

        • String (breakpointId)
          Id of the created breakpoint for further reference.

      • setBreakpointByUrl

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret2<java.lang.String,​Debugger.Location[]>> setBreakpointByUrl​
            (int lineNumber,
             java.lang.String url,
             java.lang.String urlRegex,
             java.lang.String scriptHash,
             java.lang.Integer columnNumber,
             java.lang.String condition)
        Sets JavaScript breakpoint at given location specified either by URL or URL regex. Once this command is issued, all existing parsed scripts will have breakpoints resolved and returned in locations property. Further matching script parsing will result in subsequent breakpointResolved events issued. This logical breakpoint will survive page reloads.
        Parameters:
        lineNumber - Line number to set breakpoint at.
        url - URL of the resources to set breakpoint on.
        OPTIONAL
        urlRegex - Regex pattern for the URLs of the resources to set breakpoints on. Either url or urlRegex must be specified.
        OPTIONAL
        scriptHash - Script hash of the resources to set breakpoint on.
        OPTIONAL
        columnNumber - Offset in the line to set breakpoint at.
        OPTIONAL
        condition - Expression to use as a breakpoint condition. When specified, debugger will only stop on the breakpoint if this expression evaluates to true.
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, Ret2>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret2 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret2

        • Ret2.a: String (breakpointId)
          Id of the created breakpoint for further reference.

        • Ret2.b: Debugger.Location[] (locations)
          List of the locations this breakpoint resolved into upon addition.

      • setBreakpointOnFunctionCall

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​java.lang.String> setBreakpointOnFunctionCall​
            (java.lang.String objectId,
             java.lang.String condition)
        Sets JavaScript breakpoint before each call to the given function. If another function was created from the same source as a given one, calling it will also trigger the breakpoint.
        EXPERIMENTAL
        Parameters:
        objectId - Function object id.
        condition - Expression to use as a breakpoint condition. When specified, debugger will stop on the breakpoint if this expression evaluates to true.
        OPTIONAL
        Returns:
        An instance of Script<String, JsonObject, String>

        This script may be executed, using Script.exec(), and afterwards, a Promise<JsonObject, String> will be returned.

        Finally, the Promise may be awaited, using Promise.await(), and the returned result of this Browser Function may may be retrieved.

        This Browser Function returns

        • String (breakpointId)
          Id of the created breakpoint for further reference.

      • setBreakpointsActive

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setBreakpointsActive​
            (boolean active)
        Activates / deactivates all breakpoints on the page.
        Parameters:
        active - New value for breakpoints active state.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setPauseOnExceptions

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setPauseOnExceptions​
            (java.lang.String state)
        Defines pause on exceptions state. Can be set to stop on all exceptions, uncaught exceptions, or caught exceptions, no exceptions. Initial pause on exceptions state is none.
        Parameters:
        state - Pause on exceptions mode.
        Acceptable Values: ["none", "caught", "uncaught", "all"]
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setReturnValue

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setReturnValue​
            (RunTime.CallArgument newValue)
        Changes return value in top frame. Available only at return break position.
        EXPERIMENTAL
        Parameters:
        newValue - New return value.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setScriptSource

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret6<Debugger.CallFrame[],​java.lang.Boolean,​RunTime.StackTrace,​RunTime.StackTraceId,​java.lang.String,​RunTime.ExceptionDetails>> setScriptSource​
            (java.lang.String scriptId,
             java.lang.String scriptSource,
             java.lang.Boolean dryRun,
             java.lang.Boolean allowTopFrameEditing)
        Edits JavaScript source live. In general, functions that are currently on the stack can not be edited with a single exception: If the edited function is the top-most stack frame and that is the only activation of that function on the stack. In this case the live edit will be successful and a Debugger.restartFrame for the top-most function is automatically triggered.
        Parameters:
        scriptId - Id of the script to edit.
        scriptSource - New content of the script.
        dryRun - If true the change will not actually be applied. Dry run may be used to get result description without actually modifying the code.
        OPTIONAL
        allowTopFrameEditing - If true, then scriptSource is allowed to change the function on top of the stack as long as the top-most stack frame is the only activation of that function.
        OPTIONALEXPERIMENTAL
        Returns:
        An instance of Script<String, JsonObject, Ret6>

        This Script may be executed (using Script.exec()), and a Promise returned.

        When the Promise is awaited (using Promise.await()), the Ret6 will subsequently be returned from that call.

        The returned values are encapsulated in an instance of Ret6

        • Ret6.a1: Debugger.CallFrame[] (callFrames)
          New stack trace in case editing has happened while VM was stopped.

        • Ret6.b2: Boolean (stackChanged)
          Whether current call stack was modified after applying the changes.

        • Ret6.c3: RunTime.StackTrace (asyncStackTrace)
          Async stack trace, if any.

        • Ret6.d4: RunTime.StackTraceId (asyncStackTraceId)
          Async stack trace, if any.

        • Ret6.e5: String (status)
          Whether the operation was successful or not. Only Ok denotes a successful live edit while the other enum variants denote why the live edit failed.

        • Ret6.f6: RunTime.ExceptionDetails (exceptionDetails)
          Exception details if any. Only present when status is CompileError.

      • setSkipAllPauses

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setSkipAllPauses​
            (boolean skip)
        Makes page not interrupt on any pauses (breakpoint, exception, dom exception etc).
        Parameters:
        skip - New value for skip pauses state.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • setVariableValue

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> setVariableValue​
            (int scopeNumber,
             java.lang.String variableName,
             RunTime.CallArgument newValue,
             java.lang.String callFrameId)
        Changes value of variable in a callframe. Object-based scopes are not supported and must be mutated manually.
        Parameters:
        scopeNumber - 0-based number of scope as was listed in scope chain. Only 'local', 'closure' and 'catch' scope types are allowed. Other scopes could be manipulated manually.
        variableName - Variable name.
        newValue - New variable value.
        callFrameId - Id of callframe that holds variable.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • stepInto

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> stepInto​
            (java.lang.Boolean breakOnAsyncCall,
             Debugger.LocationRange[] skipList)
        Steps into the function call.
        Parameters:
        breakOnAsyncCall - Debugger will pause on the execution of the first async task which was scheduled before next pause.
        OPTIONALEXPERIMENTAL
        skipList - The skipList specifies location ranges that should be skipped on step into.
        OPTIONALEXPERIMENTAL
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • stepOut

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> stepOut()
        Steps out of the function call.
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.

      • stepOver

        🡅  ⇈  ⮫ 🗕  🗗  🗖 
        public static Script<java.lang.String,​JsonObject,​Ret0> stepOver​
            (Debugger.LocationRange[] skipList)
        Steps over the statement.
        Parameters:
        skipList - The skipList specifies location ranges that should be skipped on step over.
        OPTIONALEXPERIMENTAL
        Returns:
        An instance of Script<String, JsonObject, Ret0>

        This Script instance must be executed before the browser receives the invocation-request.

        This Browser-Function does not have a return-value. You may choose to await the Promise<JsonObject, Ret0 > to ensure the Browser Function has run to completion.