package Torello.Browser;

import java.util.*;
import javax.json.*;
import javax.json.stream.*;
import java.io.*;

import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.function.Function;

import Torello.Java.Additional.*;
import Torello.Java.JSON.*;

import static Torello.Java.JSON.JFlag.*;

import Torello.Java.StrCmpr;
import Torello.JavaDoc.StaticFunctional;
import Torello.JavaDoc.JDHeaderBackgroundImg;
import Torello.JavaDoc.Excuse;

/**
 * <SPAN CLASS=COPIEDJDK><B>Debugger domain exposes JavaScript debugging capabilities. It allows setting and removing
 * breakpoints, stepping through execution, exploring stack traces, etc.</B></SPAN>
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=CODE_GEN_NOTE>
 */
@StaticFunctional(Excused={"counter"}, Excuses={Excuse.CONFIGURATION})
@JDHeaderBackgroundImg(EmbedTagFileID="WOOD_PLANK_NOTE")
public class Debugger
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private Debugger () { }

    // These two Vector's are used by all the "Methods" exported by this class.  java.lang.reflect
    // is used to generate the JSON String's.  It saves thousands of lines of Auto-Generated Code.
    private static final Map<String, Vector<String>>    parameterNames = new HashMap<>();
    private static final Map<String, Vector<Class<?>>>  parameterTypes = new HashMap<>();

    // Some Methods do not take any parameters - for instance all the "enable()" and "disable()"
    // I simply could not get ride of RAW-TYPES and UNCHECKED warnings... so there are now,
    // offically, two empty-vectors.  One for String's, and the other for Classes.

    private static final Vector<String>     EMPTY_VEC_STR = new Vector<>();
    private static final Vector<Class<?>>   EMPTY_VEC_CLASS = new Vector<>();

    static
    {
        for (Method m : Debugger.class.getMethods())
        {
            // This doesn't work!  The parameter names are all "arg0" ... "argN"
            // It works for java.lang.reflect.Field, BUT NOT java.lang.reflect.Parameter!
            //
            // Vector<String> parameterNamesList = new Vector<>(); -- NOPE!

            Vector<Class<?>> parameterTypesList = new Vector<>();
        
            for (Parameter p : m.getParameters()) parameterTypesList.add(p.getType());

            parameterTypes.put(
                m.getName(),
                (parameterTypesList.size() > 0) ? parameterTypesList : EMPTY_VEC_CLASS
            );
        }
    }

    static
    {
        Vector<String> v = null;

        v = new Vector<String>(2);
        parameterNames.put("continueToLocation", v);
        Collections.addAll(v, new String[]
        { "location", "targetCallFrames", });

        parameterNames.put("disable", EMPTY_VEC_STR);

        v = new Vector<String>(1);
        parameterNames.put("enable", v);
        Collections.addAll(v, new String[]
        { "maxScriptsCacheSize", });

        v = new Vector<String>(9);
        parameterNames.put("evaluateOnCallFrame", v);
        Collections.addAll(v, new String[]
        { "callFrameId", "expression", "objectGroup", "includeCommandLineAPI", "silent", "returnByValue", "generatePreview", "throwOnSideEffect", "timeout", });

        v = new Vector<String>(3);
        parameterNames.put("getPossibleBreakpoints", v);
        Collections.addAll(v, new String[]
        { "start", "end", "restrictToFunction", });

        v = new Vector<String>(1);
        parameterNames.put("getScriptSource", v);
        Collections.addAll(v, new String[]
        { "scriptId", });

        v = new Vector<String>(1);
        parameterNames.put("getWasmBytecode", v);
        Collections.addAll(v, new String[]
        { "scriptId", });

        v = new Vector<String>(1);
        parameterNames.put("getStackTrace", v);
        Collections.addAll(v, new String[]
        { "stackTraceId", });

        parameterNames.put("pause", EMPTY_VEC_STR);

        v = new Vector<String>(1);
        parameterNames.put("pauseOnAsyncCall", v);
        Collections.addAll(v, new String[]
        { "parentStackTraceId", });

        v = new Vector<String>(1);
        parameterNames.put("removeBreakpoint", v);
        Collections.addAll(v, new String[]
        { "breakpointId", });

        v = new Vector<String>(1);
        parameterNames.put("restartFrame", v);
        Collections.addAll(v, new String[]
        { "callFrameId", });

        v = new Vector<String>(1);
        parameterNames.put("resume", v);
        Collections.addAll(v, new String[]
        { "terminateOnResume", });

        v = new Vector<String>(4);
        parameterNames.put("searchInContent", v);
        Collections.addAll(v, new String[]
        { "scriptId", "query", "caseSensitive", "isRegex", });

        v = new Vector<String>(1);
        parameterNames.put("setAsyncCallStackDepth", v);
        Collections.addAll(v, new String[]
        { "maxDepth", });

        v = new Vector<String>(1);
        parameterNames.put("setBlackboxPatterns", v);
        Collections.addAll(v, new String[]
        { "patterns", });

        v = new Vector<String>(2);
        parameterNames.put("setBlackboxedRanges", v);
        Collections.addAll(v, new String[]
        { "scriptId", "positions", });

        v = new Vector<String>(2);
        parameterNames.put("setBreakpoint", v);
        Collections.addAll(v, new String[]
        { "location", "condition", });

        v = new Vector<String>(1);
        parameterNames.put("setInstrumentationBreakpoint", v);
        Collections.addAll(v, new String[]
        { "instrumentation", });

        v = new Vector<String>(6);
        parameterNames.put("setBreakpointByUrl", v);
        Collections.addAll(v, new String[]
        { "lineNumber", "url", "urlRegex", "scriptHash", "columnNumber", "condition", });

        v = new Vector<String>(2);
        parameterNames.put("setBreakpointOnFunctionCall", v);
        Collections.addAll(v, new String[]
        { "objectId", "condition", });

        v = new Vector<String>(1);
        parameterNames.put("setBreakpointsActive", v);
        Collections.addAll(v, new String[]
        { "active", });

        v = new Vector<String>(1);
        parameterNames.put("setPauseOnExceptions", v);
        Collections.addAll(v, new String[]
        { "state", });

        v = new Vector<String>(1);
        parameterNames.put("setReturnValue", v);
        Collections.addAll(v, new String[]
        { "newValue", });

        v = new Vector<String>(3);
        parameterNames.put("setScriptSource", v);
        Collections.addAll(v, new String[]
        { "scriptId", "scriptSource", "dryRun", });

        v = new Vector<String>(1);
        parameterNames.put("setSkipAllPauses", v);
        Collections.addAll(v, new String[]
        { "skip", });

        v = new Vector<String>(4);
        parameterNames.put("setVariableValue", v);
        Collections.addAll(v, new String[]
        { "scopeNumber", "variableName", "newValue", "callFrameId", });

        v = new Vector<String>(2);
        parameterNames.put("stepInto", v);
        Collections.addAll(v, new String[]
        { "breakOnAsyncCall", "skipList", });

        parameterNames.put("stepOut", EMPTY_VEC_STR);

        v = new Vector<String>(1);
        parameterNames.put("stepOver", v);
        Collections.addAll(v, new String[]
        { "skipList", });
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Types - Static Inner Classes
    // ********************************************************************************************
    // ********************************************************************************************

    // public static class BreakpointId => String
    
    // public static class CallFrameId => String
    
    /** Enum of possible script languages. */
    public static final String[] ScriptLanguage =
    { "JavaScript", "WebAssembly", };
    
    /** Location in the source code. */
    public static class Location
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, }; }
        
        /** Script identifier as reported in the <CODE>Debugger.scriptParsed</CODE>. */
        public final String scriptId;
        
        /** Line number in the script (0-based). */
        public final int lineNumber;
        
        /**
         * Column number in the script (0-based).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer columnNumber;
        
        /**
         * Constructor
         *
         * @param scriptId Script identifier as reported in the <CODE>Debugger.scriptParsed</CODE>.
         * 
         * @param lineNumber Line number in the script (0-based).
         * 
         * @param columnNumber Column number in the script (0-based).
         * <BR /><B>OPTIONAL</B>
         */
        public Location(String scriptId, int lineNumber, Integer columnNumber)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (scriptId == null) BRDPC.throwNPE("scriptId");
            
            this.scriptId      = scriptId;
            this.lineNumber    = lineNumber;
            this.columnNumber  = columnNumber;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Location'}.
         */
        public Location (JsonObject jo)
        {
            this.scriptId      = ReadJSON.getString(jo, "scriptId", false, true);
            this.lineNumber    = ReadPrimJSON.getInt(jo, "lineNumber");
            this.columnNumber  = ReadBoxedJSON.getInteger(jo, "columnNumber", true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            Location o = (Location) other;
        
            return
                    Objects.equals(this.scriptId, o.scriptId)
                &&  (this.lineNumber == o.lineNumber)
                &&  Objects.equals(this.columnNumber, o.columnNumber);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.scriptId)
                +   this.lineNumber
                +   Objects.hashCode(this.columnNumber);
        }
    }
    
    /**
     * Location in the source code.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class ScriptPosition
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final int lineNumber;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final int columnNumber;
        
        /**
         * Constructor
         *
         * @param lineNumber -
         * 
         * @param columnNumber -
         */
        public ScriptPosition(int lineNumber, int columnNumber)
        {
            this.lineNumber    = lineNumber;
            this.columnNumber  = columnNumber;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'ScriptPosition'}.
         */
        public ScriptPosition (JsonObject jo)
        {
            this.lineNumber    = ReadPrimJSON.getInt(jo, "lineNumber");
            this.columnNumber  = ReadPrimJSON.getInt(jo, "columnNumber");
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            ScriptPosition o = (ScriptPosition) other;
        
            return
                    (this.lineNumber == o.lineNumber)
                &&  (this.columnNumber == o.columnNumber);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.lineNumber
                +   this.columnNumber;
        }
    }
    
    /**
     * Location range within one script.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class LocationRange
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String scriptId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Debugger.ScriptPosition start;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Debugger.ScriptPosition end;
        
        /**
         * Constructor
         *
         * @param scriptId -
         * 
         * @param start -
         * 
         * @param end -
         */
        public LocationRange
            (String scriptId, Debugger.ScriptPosition start, Debugger.ScriptPosition end)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (scriptId == null) BRDPC.throwNPE("scriptId");
            if (start == null)    BRDPC.throwNPE("start");
            if (end == null)      BRDPC.throwNPE("end");
            
            this.scriptId  = scriptId;
            this.start     = start;
            this.end       = end;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'LocationRange'}.
         */
        public LocationRange (JsonObject jo)
        {
            this.scriptId  = ReadJSON.getString(jo, "scriptId", false, true);
            this.start     = ReadJSON.getObject(jo, "start", Debugger.ScriptPosition.class, false, true);
            this.end       = ReadJSON.getObject(jo, "end", Debugger.ScriptPosition.class, false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            LocationRange o = (LocationRange) other;
        
            return
                    Objects.equals(this.scriptId, o.scriptId)
                &&  Objects.equals(this.start, o.start)
                &&  Objects.equals(this.end, o.end);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.scriptId)
                +   this.start.hashCode()
                +   this.end.hashCode();
        }
    }
    
    /** JavaScript call frame. Array of call frames form the call stack. */
    public static class CallFrame
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, false, false, false, false, true, }; }
        
        /** Call frame identifier. This identifier is only valid while the virtual machine is paused. */
        public final String callFrameId;
        
        /** Name of the JavaScript function called on this call frame. */
        public final String functionName;
        
        /**
         * Location in the source code.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Debugger.Location functionLocation;
        
        /** Location in the source code. */
        public final Debugger.Location location;
        
        /** JavaScript script name or url. */
        public final String url;
        
        /** Scope chain for this call frame. */
        public final Debugger.Scope[] scopeChain;
        
        /** <CODE>this</CODE> object for this call frame. */
        public final RunTime.RemoteObject _this;
        
        /**
         * The value being returned, if the function is at return point.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final RunTime.RemoteObject returnValue;
        
        /**
         * Constructor
         *
         * @param callFrameId Call frame identifier. This identifier is only valid while the virtual machine is paused.
         * 
         * @param functionName Name of the JavaScript function called on this call frame.
         * 
         * @param functionLocation Location in the source code.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param location Location in the source code.
         * 
         * @param url JavaScript script name or url.
         * 
         * @param scopeChain Scope chain for this call frame.
         * 
         * @param _this <CODE>this</CODE> object for this call frame.
         * 
         * @param returnValue The value being returned, if the function is at return point.
         * <BR /><B>OPTIONAL</B>
         */
        public CallFrame(
                String callFrameId, String functionName, Debugger.Location functionLocation, 
                Debugger.Location location, String url, Debugger.Scope[] scopeChain, 
                RunTime.RemoteObject _this, RunTime.RemoteObject returnValue
            )
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (callFrameId == null)  BRDPC.throwNPE("callFrameId");
            if (functionName == null) BRDPC.throwNPE("functionName");
            if (location == null)     BRDPC.throwNPE("location");
            if (url == null)          BRDPC.throwNPE("url");
            if (scopeChain == null)   BRDPC.throwNPE("scopeChain");
            if (_this == null)        BRDPC.throwNPE("_this");
            
            this.callFrameId       = callFrameId;
            this.functionName      = functionName;
            this.functionLocation  = functionLocation;
            this.location          = location;
            this.url               = url;
            this.scopeChain        = scopeChain;
            this._this             = _this;
            this.returnValue       = returnValue;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CallFrame'}.
         */
        public CallFrame (JsonObject jo)
        {
            this.callFrameId       = ReadJSON.getString(jo, "callFrameId", false, true);
            this.functionName      = ReadJSON.getString(jo, "functionName", false, true);
            this.functionLocation  = ReadJSON.getObject(jo, "functionLocation", Debugger.Location.class, true, false);
            this.location          = ReadJSON.getObject(jo, "location", Debugger.Location.class, false, true);
            this.url               = ReadJSON.getString(jo, "url", false, true);
            this.scopeChain = (jo.getJsonArray("scopeChain") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("scopeChain"), null, 0, Debugger.Scope[].class);
        
            this._this             = ReadJSON.getObject(jo, "this", RunTime.RemoteObject.class, false, true);
            this.returnValue       = ReadJSON.getObject(jo, "returnValue", RunTime.RemoteObject.class, true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            CallFrame o = (CallFrame) other;
        
            return
                    Objects.equals(this.callFrameId, o.callFrameId)
                &&  Objects.equals(this.functionName, o.functionName)
                &&  Objects.equals(this.functionLocation, o.functionLocation)
                &&  Objects.equals(this.location, o.location)
                &&  Objects.equals(this.url, o.url)
                &&  Arrays.deepEquals(this.scopeChain, o.scopeChain)
                &&  Objects.equals(this._this, o._this)
                &&  Objects.equals(this.returnValue, o.returnValue);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.callFrameId)
                +   Objects.hashCode(this.functionName)
                +   this.functionLocation.hashCode()
                +   this.location.hashCode()
                +   Objects.hashCode(this.url)
                +   Arrays.deepHashCode(this.scopeChain)
                +   this._this.hashCode()
                +   this.returnValue.hashCode();
        }
    }
    
    /** Scope description. */
    public static class Scope
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, true, true, }; }
        
        /** Scope type. */
        public final String type;
        
        /**
         * Object representing the scope. For <CODE>global</CODE> and <CODE>with</CODE> scopes it represents the actual
         * object; for the rest of the scopes, it is artificial transient object enumerating scope
         * variables as its properties.
         */
        public final RunTime.RemoteObject object;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String name;
        
        /**
         * Location in the source code where scope starts
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Debugger.Location startLocation;
        
        /**
         * Location in the source code where scope ends
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Debugger.Location endLocation;
        
        /**
         * Constructor
         *
         * @param type Scope type.
         * <BR />Acceptable Values: ["global", "local", "with", "closure", "catch", "block", "script", "eval", "module", "wasm-expression-stack"]
         * 
         * @param object 
         * Object representing the scope. For <CODE>global</CODE> and <CODE>with</CODE> scopes it represents the actual
         * object; for the rest of the scopes, it is artificial transient object enumerating scope
         * variables as its properties.
         * 
         * @param name -
         * <BR /><B>OPTIONAL</B>
         * 
         * @param startLocation Location in the source code where scope starts
         * <BR /><B>OPTIONAL</B>
         * 
         * @param endLocation Location in the source code where scope ends
         * <BR /><B>OPTIONAL</B>
         */
        public Scope(
                String type, RunTime.RemoteObject object, String name, 
                Debugger.Location startLocation, Debugger.Location endLocation
            )
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (type == null)   BRDPC.throwNPE("type");
            if (object == null) BRDPC.throwNPE("object");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "global", "local", "with", "closure", "catch", "block", "script", "eval", "module", "wasm-expression-stack"
            );
            
            this.type           = type;
            this.object         = object;
            this.name           = name;
            this.startLocation  = startLocation;
            this.endLocation    = endLocation;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Scope'}.
         */
        public Scope (JsonObject jo)
        {
            this.type           = ReadJSON.getString(jo, "type", false, true);
            this.object         = ReadJSON.getObject(jo, "object", RunTime.RemoteObject.class, false, true);
            this.name           = ReadJSON.getString(jo, "name", true, false);
            this.startLocation  = ReadJSON.getObject(jo, "startLocation", Debugger.Location.class, true, false);
            this.endLocation    = ReadJSON.getObject(jo, "endLocation", Debugger.Location.class, true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            Scope o = (Scope) other;
        
            return
                    Objects.equals(this.type, o.type)
                &&  Objects.equals(this.object, o.object)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.startLocation, o.startLocation)
                &&  Objects.equals(this.endLocation, o.endLocation);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.type)
                +   this.object.hashCode()
                +   Objects.hashCode(this.name)
                +   this.startLocation.hashCode()
                +   this.endLocation.hashCode();
        }
    }
    
    /** Search match for resource. */
    public static class SearchMatch
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** Line number in resource content. */
        public final Number lineNumber;
        
        /** Line with match content. */
        public final String lineContent;
        
        /**
         * Constructor
         *
         * @param lineNumber Line number in resource content.
         * 
         * @param lineContent Line with match content.
         */
        public SearchMatch(Number lineNumber, String lineContent)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (lineNumber == null)  BRDPC.throwNPE("lineNumber");
            if (lineContent == null) BRDPC.throwNPE("lineContent");
            
            this.lineNumber   = lineNumber;
            this.lineContent  = lineContent;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'SearchMatch'}.
         */
        public SearchMatch (JsonObject jo)
        {
            this.lineNumber   = ReadNumberJSON.get(jo, "lineNumber", false, true);
            this.lineContent  = ReadJSON.getString(jo, "lineContent", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            SearchMatch o = (SearchMatch) other;
        
            return
                    Objects.equals(this.lineNumber, o.lineNumber)
                &&  Objects.equals(this.lineContent, o.lineContent);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.lineNumber)
                +   Objects.hashCode(this.lineContent);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class BreakLocation
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, true, }; }
        
        /** Script identifier as reported in the <CODE>Debugger.scriptParsed</CODE>. */
        public final String scriptId;
        
        /** Line number in the script (0-based). */
        public final int lineNumber;
        
        /**
         * Column number in the script (0-based).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer columnNumber;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String type;
        
        /**
         * Constructor
         *
         * @param scriptId Script identifier as reported in the <CODE>Debugger.scriptParsed</CODE>.
         * 
         * @param lineNumber Line number in the script (0-based).
         * 
         * @param columnNumber Column number in the script (0-based).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param type -
         * <BR />Acceptable Values: ["debuggerStatement", "call", "return"]
         * <BR /><B>OPTIONAL</B>
         */
        public BreakLocation(String scriptId, int lineNumber, Integer columnNumber, String type)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (scriptId == null) BRDPC.throwNPE("scriptId");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "debuggerStatement", "call", "return"
            );
            
            this.scriptId      = scriptId;
            this.lineNumber    = lineNumber;
            this.columnNumber  = columnNumber;
            this.type          = type;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'BreakLocation'}.
         */
        public BreakLocation (JsonObject jo)
        {
            this.scriptId      = ReadJSON.getString(jo, "scriptId", false, true);
            this.lineNumber    = ReadPrimJSON.getInt(jo, "lineNumber");
            this.columnNumber  = ReadBoxedJSON.getInteger(jo, "columnNumber", true);
            this.type          = ReadJSON.getString(jo, "type", true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            BreakLocation o = (BreakLocation) other;
        
            return
                    Objects.equals(this.scriptId, o.scriptId)
                &&  (this.lineNumber == o.lineNumber)
                &&  Objects.equals(this.columnNumber, o.columnNumber)
                &&  Objects.equals(this.type, o.type);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.scriptId)
                +   this.lineNumber
                +   Objects.hashCode(this.columnNumber)
                +   Objects.hashCode(this.type);
        }
    }
    
    /** Debug symbols available for a wasm script. */
    public static class DebugSymbols
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, true, }; }
        
        /** Type of the debug symbols. */
        public final String type;
        
        /**
         * URL of the external symbol source.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String externalURL;
        
        /**
         * Constructor
         *
         * @param type Type of the debug symbols.
         * <BR />Acceptable Values: ["None", "SourceMap", "EmbeddedDWARF", "ExternalDWARF"]
         * 
         * @param externalURL URL of the external symbol source.
         * <BR /><B>OPTIONAL</B>
         */
        public DebugSymbols(String type, String externalURL)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (type == null) BRDPC.throwNPE("type");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "None", "SourceMap", "EmbeddedDWARF", "ExternalDWARF"
            );
            
            this.type         = type;
            this.externalURL  = externalURL;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'DebugSymbols'}.
         */
        public DebugSymbols (JsonObject jo)
        {
            this.type         = ReadJSON.getString(jo, "type", false, true);
            this.externalURL  = ReadJSON.getString(jo, "externalURL", true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            DebugSymbols o = (DebugSymbols) other;
        
            return
                    Objects.equals(this.type, o.type)
                &&  Objects.equals(this.externalURL, o.externalURL);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.type)
                +   Objects.hashCode(this.externalURL);
        }
    }
    
    /**
     * Fired when the virtual machine resumed execution.
     *
     * <BR /><BR />This is Marker-Event.  Marker-Event's are Events that do not posses
     * any data, fields or state.  When they are fired, only the event name is supplied.
     */
    public static class resumed
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
    
        public boolean[] optionals() { return new boolean[0]; }
    
        /** JSON Object Constructor */
        public resumed(JsonObject jo)
        { super("Debugger", "resumed", 0); }
    
        @Override
        public String toString() { return "Debugger.resumed Marker Event\n"; }
    }
    
    /** Fired when breakpoint is resolved to an actual script and location. */
    public static class breakpointResolved
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** Breakpoint unique identifier. */
        public final String breakpointId;
        
        /** Actual breakpoint location. */
        public final Debugger.Location location;
        
        /**
         * Constructor
         *
         * @param breakpointId Breakpoint unique identifier.
         * 
         * @param location Actual breakpoint location.
         */
        public breakpointResolved(String breakpointId, Debugger.Location location)
        {
            super("Debugger", "breakpointResolved", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (breakpointId == null) BRDPC.throwNPE("breakpointId");
            if (location == null)     BRDPC.throwNPE("location");
            
            this.breakpointId  = breakpointId;
            this.location      = location;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'breakpointResolved'}.
         */
        public breakpointResolved (JsonObject jo)
        {
            super("Debugger", "breakpointResolved", 2);
        
            this.breakpointId  = ReadJSON.getString(jo, "breakpointId", false, true);
            this.location      = ReadJSON.getObject(jo, "location", Debugger.Location.class, false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            breakpointResolved o = (breakpointResolved) other;
        
            return
                    Objects.equals(this.breakpointId, o.breakpointId)
                &&  Objects.equals(this.location, o.location);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.breakpointId)
                +   this.location.hashCode();
        }
    }
    
    /** Fired when the virtual machine stopped on breakpoint or exception or any other stop criteria. */
    public static class paused
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, true, true, true, true, true, }; }
        
        /** Call stack the virtual machine stopped on. */
        public final Debugger.CallFrame[] callFrames;
        
        /** Pause reason. */
        public final String reason;
        
        /**
         * Object containing break-specific auxiliary properties.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final JsonObject data;
        
        /**
         * Hit breakpoints IDs
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String[] hitBreakpoints;
        
        /**
         * Async stack trace, if any.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final RunTime.StackTrace asyncStackTrace;
        
        /**
         * Async stack trace, if any.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final RunTime.StackTraceId asyncStackTraceId;
        
        /**
         * Never present, will be removed.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * <BR /><B>DEPRECATED</B>
         */
        public final RunTime.StackTraceId asyncCallStackTraceId;
        
        /**
         * Constructor
         *
         * @param callFrames Call stack the virtual machine stopped on.
         * 
         * @param reason Pause reason.
         * <BR />Acceptable Values: ["ambiguous", "assert", "CSPViolation", "debugCommand", "DOM", "EventListener", "exception", "instrumentation", "OOM", "other", "promiseRejection", "XHR"]
         * 
         * @param data Object containing break-specific auxiliary properties.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param hitBreakpoints Hit breakpoints IDs
         * <BR /><B>OPTIONAL</B>
         * 
         * @param asyncStackTrace Async stack trace, if any.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param asyncStackTraceId Async stack trace, if any.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param asyncCallStackTraceId Never present, will be removed.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * <BR /><B>DEPRECATED</B>
         */
        public paused(
                Debugger.CallFrame[] callFrames, String reason, JsonObject data, 
                String[] hitBreakpoints, RunTime.StackTrace asyncStackTrace, 
                RunTime.StackTraceId asyncStackTraceId, RunTime.StackTraceId asyncCallStackTraceId
            )
        {
            super("Debugger", "paused", 7);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (callFrames == null) BRDPC.throwNPE("callFrames");
            if (reason == null)     BRDPC.throwNPE("reason");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "reason", reason,
                "ambiguous", "assert", "CSPViolation", "debugCommand", "DOM", "EventListener", "exception", "instrumentation", "OOM", "other", "promiseRejection", "XHR"
            );
            
            this.callFrames             = callFrames;
            this.reason                 = reason;
            this.data                   = data;
            this.hitBreakpoints         = hitBreakpoints;
            this.asyncStackTrace        = asyncStackTrace;
            this.asyncStackTraceId      = asyncStackTraceId;
            this.asyncCallStackTraceId  = asyncCallStackTraceId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'paused'}.
         */
        public paused (JsonObject jo)
        {
            super("Debugger", "paused", 7);
        
            this.callFrames = (jo.getJsonArray("callFrames") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("callFrames"), null, 0, Debugger.CallFrame[].class);
        
            this.reason                 = ReadJSON.getString(jo, "reason", false, true);
            this.data                   = jo.getJsonObject("data");
            this.hitBreakpoints = (jo.getJsonArray("hitBreakpoints") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("hitBreakpoints"), null, 0, String[].class);
        
            this.asyncStackTrace        = ReadJSON.getObject(jo, "asyncStackTrace", RunTime.StackTrace.class, true, false);
            this.asyncStackTraceId      = ReadJSON.getObject(jo, "asyncStackTraceId", RunTime.StackTraceId.class, true, false);
            this.asyncCallStackTraceId  = ReadJSON.getObject(jo, "asyncCallStackTraceId", RunTime.StackTraceId.class, true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            paused o = (paused) other;
        
            return
                    Arrays.deepEquals(this.callFrames, o.callFrames)
                &&  Objects.equals(this.reason, o.reason)
                &&  Objects.equals(this.data, o.data)
                &&  Arrays.deepEquals(this.hitBreakpoints, o.hitBreakpoints)
                &&  Objects.equals(this.asyncStackTrace, o.asyncStackTrace)
                &&  Objects.equals(this.asyncStackTraceId, o.asyncStackTraceId)
                &&  Objects.equals(this.asyncCallStackTraceId, o.asyncCallStackTraceId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.callFrames)
                +   Objects.hashCode(this.reason)
                +   Objects.hashCode(this.data)
                +   Arrays.deepHashCode(this.hitBreakpoints)
                +   this.asyncStackTrace.hashCode()
                +   this.asyncStackTraceId.hashCode()
                +   this.asyncCallStackTraceId.hashCode();
        }
    }
    
    /** Fired when virtual machine fails to parse the script. */
    public static class scriptFailedToParse
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, false, false, false, false, false, true, true, true, true, true, true, true, true, true, }; }
        
        /** Identifier of the script parsed. */
        public final String scriptId;
        
        /** URL or name of the script parsed (if any). */
        public final String url;
        
        /** Line offset of the script within the resource with given URL (for script tags). */
        public final int startLine;
        
        /** Column offset of the script within the resource with given URL. */
        public final int startColumn;
        
        /** Last line of the script. */
        public final int endLine;
        
        /** Length of the last line of the script. */
        public final int endColumn;
        
        /** Specifies script creation context. */
        public final int executionContextId;
        
        /** Content hash of the script. */
        public final String hash;
        
        /**
         * Embedder-specific auxiliary data.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final JsonObject executionContextAuxData;
        
        /**
         * URL of source map associated with script (if any).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String sourceMapURL;
        
        /**
         * True, if this script has sourceURL.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean hasSourceURL;
        
        /**
         * True, if this script is ES6 module.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean isModule;
        
        /**
         * This script length.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer length;
        
        /**
         * JavaScript top stack frame of where the script parsed event was triggered if available.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final RunTime.StackTrace stackTrace;
        
        /**
         * If the scriptLanguage is WebAssembly, the code section offset in the module.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Integer codeOffset;
        
        /**
         * The language of the script.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final String scriptLanguage;
        
        /**
         * The name the embedder supplied for this script.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final String embedderName;
        
        /**
         * Constructor
         *
         * @param scriptId Identifier of the script parsed.
         * 
         * @param url URL or name of the script parsed (if any).
         * 
         * @param startLine Line offset of the script within the resource with given URL (for script tags).
         * 
         * @param startColumn Column offset of the script within the resource with given URL.
         * 
         * @param endLine Last line of the script.
         * 
         * @param endColumn Length of the last line of the script.
         * 
         * @param executionContextId Specifies script creation context.
         * 
         * @param hash Content hash of the script.
         * 
         * @param executionContextAuxData Embedder-specific auxiliary data.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param sourceMapURL URL of source map associated with script (if any).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param hasSourceURL True, if this script has sourceURL.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param isModule True, if this script is ES6 module.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param length This script length.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param stackTrace JavaScript top stack frame of where the script parsed event was triggered if available.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param codeOffset If the scriptLanguage is WebAssembly, the code section offset in the module.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param scriptLanguage The language of the script.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param embedderName The name the embedder supplied for this script.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public scriptFailedToParse(
                String scriptId, String url, int startLine, int startColumn, int endLine, 
                int endColumn, int executionContextId, String hash, 
                JsonObject executionContextAuxData, String sourceMapURL, Boolean hasSourceURL, 
                Boolean isModule, Integer length, RunTime.StackTrace stackTrace, Integer codeOffset, 
                String scriptLanguage, String embedderName
            )
        {
            super("Debugger", "scriptFailedToParse", 17);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (scriptId == null) BRDPC.throwNPE("scriptId");
            if (url == null)      BRDPC.throwNPE("url");
            if (hash == null)     BRDPC.throwNPE("hash");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE("scriptLanguage", scriptLanguage, "Debugger.ScriptLanguage", Debugger.ScriptLanguage);
            
            this.scriptId                 = scriptId;
            this.url                      = url;
            this.startLine                = startLine;
            this.startColumn              = startColumn;
            this.endLine                  = endLine;
            this.endColumn                = endColumn;
            this.executionContextId       = executionContextId;
            this.hash                     = hash;
            this.executionContextAuxData  = executionContextAuxData;
            this.sourceMapURL             = sourceMapURL;
            this.hasSourceURL             = hasSourceURL;
            this.isModule                 = isModule;
            this.length                   = length;
            this.stackTrace               = stackTrace;
            this.codeOffset               = codeOffset;
            this.scriptLanguage           = scriptLanguage;
            this.embedderName             = embedderName;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'scriptFailedToParse'}.
         */
        public scriptFailedToParse (JsonObject jo)
        {
            super("Debugger", "scriptFailedToParse", 17);
        
            this.scriptId                 = ReadJSON.getString(jo, "scriptId", false, true);
            this.url                      = ReadJSON.getString(jo, "url", false, true);
            this.startLine                = ReadPrimJSON.getInt(jo, "startLine");
            this.startColumn              = ReadPrimJSON.getInt(jo, "startColumn");
            this.endLine                  = ReadPrimJSON.getInt(jo, "endLine");
            this.endColumn                = ReadPrimJSON.getInt(jo, "endColumn");
            this.executionContextId       = ReadPrimJSON.getInt(jo, "executionContextId");
            this.hash                     = ReadJSON.getString(jo, "hash", false, true);
            this.executionContextAuxData  = jo.getJsonObject("executionContextAuxData");
            this.sourceMapURL             = ReadJSON.getString(jo, "sourceMapURL", true, false);
            this.hasSourceURL             = ReadBoxedJSON.getBoolean(jo, "hasSourceURL", true);
            this.isModule                 = ReadBoxedJSON.getBoolean(jo, "isModule", true);
            this.length                   = ReadBoxedJSON.getInteger(jo, "length", true);
            this.stackTrace               = ReadJSON.getObject(jo, "stackTrace", RunTime.StackTrace.class, true, false);
            this.codeOffset               = ReadBoxedJSON.getInteger(jo, "codeOffset", true);
            this.scriptLanguage           = ReadJSON.getString(jo, "scriptLanguage", true, false);
            this.embedderName             = ReadJSON.getString(jo, "embedderName", true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            scriptFailedToParse o = (scriptFailedToParse) other;
        
            return
                    Objects.equals(this.scriptId, o.scriptId)
                &&  Objects.equals(this.url, o.url)
                &&  (this.startLine == o.startLine)
                &&  (this.startColumn == o.startColumn)
                &&  (this.endLine == o.endLine)
                &&  (this.endColumn == o.endColumn)
                &&  Objects.equals(this.executionContextId, o.executionContextId)
                &&  Objects.equals(this.hash, o.hash)
                &&  Objects.equals(this.executionContextAuxData, o.executionContextAuxData)
                &&  Objects.equals(this.sourceMapURL, o.sourceMapURL)
                &&  Objects.equals(this.hasSourceURL, o.hasSourceURL)
                &&  Objects.equals(this.isModule, o.isModule)
                &&  Objects.equals(this.length, o.length)
                &&  Objects.equals(this.stackTrace, o.stackTrace)
                &&  Objects.equals(this.codeOffset, o.codeOffset)
                &&  Objects.equals(this.scriptLanguage, o.scriptLanguage)
                &&  Objects.equals(this.embedderName, o.embedderName);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.scriptId)
                +   Objects.hashCode(this.url)
                +   this.startLine
                +   this.startColumn
                +   this.endLine
                +   this.endColumn
                +   this.executionContextId
                +   Objects.hashCode(this.hash)
                +   Objects.hashCode(this.executionContextAuxData)
                +   Objects.hashCode(this.sourceMapURL)
                +   Objects.hashCode(this.hasSourceURL)
                +   Objects.hashCode(this.isModule)
                +   Objects.hashCode(this.length)
                +   this.stackTrace.hashCode()
                +   Objects.hashCode(this.codeOffset)
                +   Objects.hashCode(this.scriptLanguage)
                +   Objects.hashCode(this.embedderName);
        }
    }
    
    /**
     * Fired when virtual machine parses script. This event is also fired for all known and uncollected
     * scripts upon enabling debugger.
     */
    public static class scriptParsed
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, false, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, }; }
        
        /** Identifier of the script parsed. */
        public final String scriptId;
        
        /** URL or name of the script parsed (if any). */
        public final String url;
        
        /** Line offset of the script within the resource with given URL (for script tags). */
        public final int startLine;
        
        /** Column offset of the script within the resource with given URL. */
        public final int startColumn;
        
        /** Last line of the script. */
        public final int endLine;
        
        /** Length of the last line of the script. */
        public final int endColumn;
        
        /** Specifies script creation context. */
        public final int executionContextId;
        
        /** Content hash of the script. */
        public final String hash;
        
        /**
         * Embedder-specific auxiliary data.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final JsonObject executionContextAuxData;
        
        /**
         * True, if this script is generated as a result of the live edit operation.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Boolean isLiveEdit;
        
        /**
         * URL of source map associated with script (if any).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String sourceMapURL;
        
        /**
         * True, if this script has sourceURL.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean hasSourceURL;
        
        /**
         * True, if this script is ES6 module.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean isModule;
        
        /**
         * This script length.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer length;
        
        /**
         * JavaScript top stack frame of where the script parsed event was triggered if available.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final RunTime.StackTrace stackTrace;
        
        /**
         * If the scriptLanguage is WebAssembly, the code section offset in the module.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Integer codeOffset;
        
        /**
         * The language of the script.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final String scriptLanguage;
        
        /**
         * If the scriptLanguage is WebASsembly, the source of debug symbols for the module.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final Debugger.DebugSymbols debugSymbols;
        
        /**
         * The name the embedder supplied for this script.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public final String embedderName;
        
        /**
         * Constructor
         *
         * @param scriptId Identifier of the script parsed.
         * 
         * @param url URL or name of the script parsed (if any).
         * 
         * @param startLine Line offset of the script within the resource with given URL (for script tags).
         * 
         * @param startColumn Column offset of the script within the resource with given URL.
         * 
         * @param endLine Last line of the script.
         * 
         * @param endColumn Length of the last line of the script.
         * 
         * @param executionContextId Specifies script creation context.
         * 
         * @param hash Content hash of the script.
         * 
         * @param executionContextAuxData Embedder-specific auxiliary data.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param isLiveEdit True, if this script is generated as a result of the live edit operation.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param sourceMapURL URL of source map associated with script (if any).
         * <BR /><B>OPTIONAL</B>
         * 
         * @param hasSourceURL True, if this script has sourceURL.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param isModule True, if this script is ES6 module.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param length This script length.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param stackTrace JavaScript top stack frame of where the script parsed event was triggered if available.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param codeOffset If the scriptLanguage is WebAssembly, the code section offset in the module.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param scriptLanguage The language of the script.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param debugSymbols If the scriptLanguage is WebASsembly, the source of debug symbols for the module.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         * 
         * @param embedderName The name the embedder supplied for this script.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>EXPERIMENTAL</B>
         */
        public scriptParsed(
                String scriptId, String url, int startLine, int startColumn, int endLine, 
                int endColumn, int executionContextId, String hash, 
                JsonObject executionContextAuxData, Boolean isLiveEdit, String sourceMapURL, 
                Boolean hasSourceURL, Boolean isModule, Integer length, 
                RunTime.StackTrace stackTrace, Integer codeOffset, String scriptLanguage, 
                Debugger.DebugSymbols debugSymbols, String embedderName
            )
        {
            super("Debugger", "scriptParsed", 19);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (scriptId == null) BRDPC.throwNPE("scriptId");
            if (url == null)      BRDPC.throwNPE("url");
            if (hash == null)     BRDPC.throwNPE("hash");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE("scriptLanguage", scriptLanguage, "Debugger.ScriptLanguage", Debugger.ScriptLanguage);
            
            this.scriptId                 = scriptId;
            this.url                      = url;
            this.startLine                = startLine;
            this.startColumn              = startColumn;
            this.endLine                  = endLine;
            this.endColumn                = endColumn;
            this.executionContextId       = executionContextId;
            this.hash                     = hash;
            this.executionContextAuxData  = executionContextAuxData;
            this.isLiveEdit               = isLiveEdit;
            this.sourceMapURL             = sourceMapURL;
            this.hasSourceURL             = hasSourceURL;
            this.isModule                 = isModule;
            this.length                   = length;
            this.stackTrace               = stackTrace;
            this.codeOffset               = codeOffset;
            this.scriptLanguage           = scriptLanguage;
            this.debugSymbols             = debugSymbols;
            this.embedderName             = embedderName;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'scriptParsed'}.
         */
        public scriptParsed (JsonObject jo)
        {
            super("Debugger", "scriptParsed", 19);
        
            this.scriptId                 = ReadJSON.getString(jo, "scriptId", false, true);
            this.url                      = ReadJSON.getString(jo, "url", false, true);
            this.startLine                = ReadPrimJSON.getInt(jo, "startLine");
            this.startColumn              = ReadPrimJSON.getInt(jo, "startColumn");
            this.endLine                  = ReadPrimJSON.getInt(jo, "endLine");
            this.endColumn                = ReadPrimJSON.getInt(jo, "endColumn");
            this.executionContextId       = ReadPrimJSON.getInt(jo, "executionContextId");
            this.hash                     = ReadJSON.getString(jo, "hash", false, true);
            this.executionContextAuxData  = jo.getJsonObject("executionContextAuxData");
            this.isLiveEdit               = ReadBoxedJSON.getBoolean(jo, "isLiveEdit", true);
            this.sourceMapURL             = ReadJSON.getString(jo, "sourceMapURL", true, false);
            this.hasSourceURL             = ReadBoxedJSON.getBoolean(jo, "hasSourceURL", true);
            this.isModule                 = ReadBoxedJSON.getBoolean(jo, "isModule", true);
            this.length                   = ReadBoxedJSON.getInteger(jo, "length", true);
            this.stackTrace               = ReadJSON.getObject(jo, "stackTrace", RunTime.StackTrace.class, true, false);
            this.codeOffset               = ReadBoxedJSON.getInteger(jo, "codeOffset", true);
            this.scriptLanguage           = ReadJSON.getString(jo, "scriptLanguage", true, false);
            this.debugSymbols             = ReadJSON.getObject(jo, "debugSymbols", Debugger.DebugSymbols.class, true, false);
            this.embedderName             = ReadJSON.getString(jo, "embedderName", true, false);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            scriptParsed o = (scriptParsed) other;
        
            return
                    Objects.equals(this.scriptId, o.scriptId)
                &&  Objects.equals(this.url, o.url)
                &&  (this.startLine == o.startLine)
                &&  (this.startColumn == o.startColumn)
                &&  (this.endLine == o.endLine)
                &&  (this.endColumn == o.endColumn)
                &&  Objects.equals(this.executionContextId, o.executionContextId)
                &&  Objects.equals(this.hash, o.hash)
                &&  Objects.equals(this.executionContextAuxData, o.executionContextAuxData)
                &&  Objects.equals(this.isLiveEdit, o.isLiveEdit)
                &&  Objects.equals(this.sourceMapURL, o.sourceMapURL)
                &&  Objects.equals(this.hasSourceURL, o.hasSourceURL)
                &&  Objects.equals(this.isModule, o.isModule)
                &&  Objects.equals(this.length, o.length)
                &&  Objects.equals(this.stackTrace, o.stackTrace)
                &&  Objects.equals(this.codeOffset, o.codeOffset)
                &&  Objects.equals(this.scriptLanguage, o.scriptLanguage)
                &&  Objects.equals(this.debugSymbols, o.debugSymbols)
                &&  Objects.equals(this.embedderName, o.embedderName);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.scriptId)
                +   Objects.hashCode(this.url)
                +   this.startLine
                +   this.startColumn
                +   this.endLine
                +   this.endColumn
                +   this.executionContextId
                +   Objects.hashCode(this.hash)
                +   Objects.hashCode(this.executionContextAuxData)
                +   Objects.hashCode(this.isLiveEdit)
                +   Objects.hashCode(this.sourceMapURL)
                +   Objects.hashCode(this.hasSourceURL)
                +   Objects.hashCode(this.isModule)
                +   Objects.hashCode(this.length)
                +   this.stackTrace.hashCode()
                +   Objects.hashCode(this.codeOffset)
                +   Objects.hashCode(this.scriptLanguage)
                +   this.debugSymbols.hashCode()
                +   Objects.hashCode(this.embedderName);
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Continues execution until specific location is reached.
     * 
     * @param location Location to continue to.
     * 
     * @param targetCallFrames -
     * <BR />Acceptable Values: ["any", "current"]
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> continueToLocation
        (Debugger.Location location, String targetCallFrames)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (location == null) BRDPC.throwNPE("location");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "targetCallFrames", targetCallFrames,
            "any", "current"
        );
        
        final int       webSocketID = 2000000 + counter++;
        final boolean[] optionals   = { false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("continueToLocation"),
            parameterNames.get("continueToLocation"),
            optionals, webSocketID,
            "Debugger.continueToLocation",
            location, targetCallFrames
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Disables debugger for given page.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> disable()
    {
        final int          webSocketID = 2001000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("disable"),
            parameterNames.get("disable"),
            optionals, webSocketID,
            "Debugger.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables debugger for the given page. Clients should not assume that the debugging has been
     * enabled until the result for this command is received.
     * 
     * @param 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.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>debuggerId</B></CODE>)
     *     <BR />Unique identifier of the debugger.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> enable(Number maxScriptsCacheSize)
    {
        final int       webSocketID = 2002000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("enable"),
            parameterNames.get("enable"),
            optionals, webSocketID,
            "Debugger.enable",
            maxScriptsCacheSize
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "debuggerId", false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Evaluates expression on a given call frame.
     * 
     * @param callFrameId Call frame identifier to evaluate on.
     * 
     * @param expression Expression to evaluate.
     * 
     * @param objectGroup 
     * String object group name to put result into (allows rapid releasing resulting object handles
     * using <CODE>releaseObjectGroup</CODE>).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param includeCommandLineAPI 
     * Specifies whether command line API should be available to the evaluated expression, defaults
     * to false.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param silent 
     * In silent mode exceptions thrown during evaluation are not reported and do not pause
     * execution. Overrides <CODE>setPauseOnException</CODE> state.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param returnByValue Whether the result is expected to be a JSON object that should be sent by value.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param generatePreview Whether preview should be generated for the result.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param throwOnSideEffect Whether to throw an exception if side effect cannot be ruled out during evaluation.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param timeout Terminate execution after timing out (number of milliseconds).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> {@link RunTime.RemoteObject} (<B>result</B>)</CODE>
     *     <BR />Object wrapper for the evaluation result.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> {@link RunTime.ExceptionDetails} (<B>exceptionDetails</B>)</CODE>
     *     <BR />Exception details.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<RunTime.RemoteObject, RunTime.ExceptionDetails>> evaluateOnCallFrame(
            String callFrameId, String expression, String objectGroup, 
            Boolean includeCommandLineAPI, Boolean silent, Boolean returnByValue, 
            Boolean generatePreview, Boolean throwOnSideEffect, Number timeout
        )
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (callFrameId == null) BRDPC.throwNPE("callFrameId");
        if (expression == null)  BRDPC.throwNPE("expression");
        
        final int       webSocketID = 2003000 + counter++;
        final boolean[] optionals   = { false, false, true, true, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("evaluateOnCallFrame"),
            parameterNames.get("evaluateOnCallFrame"),
            optionals, webSocketID,
            "Debugger.evaluateOnCallFrame",
            callFrameId, expression, objectGroup, includeCommandLineAPI, silent, returnByValue,
            generatePreview, throwOnSideEffect, timeout
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<RunTime.RemoteObject, RunTime.ExceptionDetails>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadJSON.getObject(jo, "result", RunTime.RemoteObject.class, false, true),
                ReadJSON.getObject(jo, "exceptionDetails", RunTime.ExceptionDetails.class, true, false)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns possible locations for breakpoint. scriptId in start and end range locations should be
     * the same.
     * 
     * @param start Start of range to search possible breakpoint locations in.
     * 
     * @param end 
     * End of range to search possible breakpoint locations in (excluding). When not specified, end
     * of scripts is used as end of range.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param restrictToFunction Only consider locations which are in the same (non-nested) function as start.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Debugger.BreakLocation}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link Debugger.BreakLocation}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link Debugger.BreakLocation}[] (<B>locations</B></CODE>)
     *     <BR />List of the possible breakpoint locations.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Debugger.BreakLocation[]> getPossibleBreakpoints
        (Debugger.Location start, Debugger.Location end, Boolean restrictToFunction)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (start == null) BRDPC.throwNPE("start");
        
        final int       webSocketID = 2004000 + counter++;
        final boolean[] optionals   = { false, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getPossibleBreakpoints"),
            parameterNames.get("getPossibleBreakpoints"),
            optionals, webSocketID,
            "Debugger.getPossibleBreakpoints",
            start, end, restrictToFunction
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Debugger.BreakLocation[]'
        Function<JsonObject, Debugger.BreakLocation[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("locations") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("locations"), null, 0, Debugger.BreakLocation[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns source for the script with given id.
     * 
     * @param scriptId Id of the script to get source for.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> String (<B>scriptSource</B>)</CODE>
     *     <BR />Script source (empty in case of Wasm bytecode).
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> String (<B>bytecode</B>)</CODE>
     *     <BR />Wasm bytecode. (Encoded as a base64 string when passed over JSON)
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<String, String>> getScriptSource
        (String scriptId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (scriptId == null) BRDPC.throwNPE("scriptId");
        
        final int       webSocketID = 2005000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getScriptSource"),
            parameterNames.get("getScriptSource"),
            optionals, webSocketID,
            "Debugger.getScriptSource",
            scriptId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<String, String>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadJSON.getString(jo, "scriptSource", false, true),
                ReadJSON.getString(jo, "bytecode", true, false)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * This command is deprecated. Use getScriptSource instead.
     * <BR /><B>DEPRECATED</B>
     * 
     * @param scriptId Id of the Wasm script to get source for.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>bytecode</B></CODE>)
     *     <BR />Script source. (Encoded as a base64 string when passed over JSON)
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> getWasmBytecode(String scriptId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (scriptId == null) BRDPC.throwNPE("scriptId");
        
        final int       webSocketID = 2006000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getWasmBytecode"),
            parameterNames.get("getWasmBytecode"),
            optionals, webSocketID,
            "Debugger.getWasmBytecode",
            scriptId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "bytecode", false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Returns stack trace with given <CODE>stackTraceId</CODE>.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param stackTraceId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link RunTime.StackTrace}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link RunTime.StackTrace}&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link RunTime.StackTrace} (<B>stackTrace</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, RunTime.StackTrace> getStackTrace
        (RunTime.StackTraceId stackTraceId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (stackTraceId == null) BRDPC.throwNPE("stackTraceId");
        
        final int       webSocketID = 2007000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getStackTrace"),
            parameterNames.get("getStackTrace"),
            optionals, webSocketID,
            "Debugger.getStackTrace",
            stackTraceId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'RunTime.StackTrace'
        Function<JsonObject, RunTime.StackTrace> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "stackTrace", RunTime.StackTrace.class, false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Stops on the next JavaScript statement.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> pause()
    {
        final int          webSocketID = 2008000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("pause"),
            parameterNames.get("pause"),
            optionals, webSocketID,
            "Debugger.pause"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR /><B>EXPERIMENTAL</B>
     * <BR /><B>DEPRECATED</B>
     * 
     * @param parentStackTraceId Debugger will pause when async call with given stack trace is started.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> pauseOnAsyncCall
        (RunTime.StackTraceId parentStackTraceId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (parentStackTraceId == null) BRDPC.throwNPE("parentStackTraceId");
        
        final int       webSocketID = 2009000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("pauseOnAsyncCall"),
            parameterNames.get("pauseOnAsyncCall"),
            optionals, webSocketID,
            "Debugger.pauseOnAsyncCall",
            parentStackTraceId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Removes JavaScript breakpoint.
     * 
     * @param breakpointId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> removeBreakpoint(String breakpointId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (breakpointId == null) BRDPC.throwNPE("breakpointId");
        
        final int       webSocketID = 2010000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("removeBreakpoint"),
            parameterNames.get("removeBreakpoint"),
            optionals, webSocketID,
            "Debugger.removeBreakpoint",
            breakpointId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Restarts particular call frame from the beginning.
     * <BR /><B>DEPRECATED</B>
     * 
     * @param callFrameId Call frame identifier to evaluate on.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret3}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret3} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret3}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret3.a:</B> {@link Debugger.CallFrame}[] (<B>callFrames</B>)</CODE>
     *     <BR />New stack trace.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.b:</B> {@link RunTime.StackTrace} (<B>asyncStackTrace</B>)</CODE>
     *     <BR />Async stack trace, if any.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.c:</B> {@link RunTime.StackTraceId} (<B>asyncStackTraceId</B>)</CODE>
     *     <BR />Async stack trace, if any.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret3<Debugger.CallFrame[], RunTime.StackTrace, RunTime.StackTraceId>> 
        restartFrame(String callFrameId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (callFrameId == null) BRDPC.throwNPE("callFrameId");
        
        final int       webSocketID = 2011000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("restartFrame"),
            parameterNames.get("restartFrame"),
            optionals, webSocketID,
            "Debugger.restartFrame",
            callFrameId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret3'
        Function<JsonObject, Ret3<Debugger.CallFrame[], RunTime.StackTrace, RunTime.StackTraceId>> 
            responseProcessor = (JsonObject jo) -> new Ret3<>(
                (jo.getJsonArray("callFrames") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("callFrames"), null, 0, Debugger.CallFrame[].class),
                ReadJSON.getObject(jo, "asyncStackTrace", RunTime.StackTrace.class, true, false),
                ReadJSON.getObject(jo, "asyncStackTraceId", RunTime.StackTraceId.class, true, false)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Resumes JavaScript execution.
     * 
     * @param 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.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> resume(Boolean terminateOnResume)
    {
        final int       webSocketID = 2012000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("resume"),
            parameterNames.get("resume"),
            optionals, webSocketID,
            "Debugger.resume",
            terminateOnResume
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Searches for given string in script content.
     * 
     * @param scriptId Id of the script to search in.
     * 
     * @param query String to search for.
     * 
     * @param caseSensitive If true, search is case sensitive.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param isRegex If true, treats string parameter as regex.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Debugger.SearchMatch}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * {@link Debugger.SearchMatch}[]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>{@link Debugger.SearchMatch}[] (<B>result</B></CODE>)
     *     <BR />List of search matches.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Debugger.SearchMatch[]> searchInContent
        (String scriptId, String query, Boolean caseSensitive, Boolean isRegex)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (scriptId == null) BRDPC.throwNPE("scriptId");
        if (query == null)    BRDPC.throwNPE("query");
        
        final int       webSocketID = 2013000 + counter++;
        final boolean[] optionals   = { false, false, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("searchInContent"),
            parameterNames.get("searchInContent"),
            optionals, webSocketID,
            "Debugger.searchInContent",
            scriptId, query, caseSensitive, isRegex
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Debugger.SearchMatch[]'
        Function<JsonObject, Debugger.SearchMatch[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("result") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("result"), null, 0, Debugger.SearchMatch[].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Enables or disables async call stacks tracking.
     * 
     * @param maxDepth 
     * Maximum depth of async call stacks. Setting to <CODE>0</CODE> will effectively disable collecting async
     * call stacks (default).
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setAsyncCallStackDepth(int maxDepth)
    {
        final int       webSocketID = 2014000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setAsyncCallStackDepth"),
            parameterNames.get("setAsyncCallStackDepth"),
            optionals, webSocketID,
            "Debugger.setAsyncCallStackDepth",
            maxDepth
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * 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.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param patterns Array of regexps that will be used to check script url for blackbox state.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setBlackboxPatterns(String[] patterns)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (patterns == null) BRDPC.throwNPE("patterns");
        
        final int       webSocketID = 2015000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setBlackboxPatterns"),
            parameterNames.get("setBlackboxPatterns"),
            optionals, webSocketID,
            "Debugger.setBlackboxPatterns",
            (Object) patterns
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * 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.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param scriptId Id of the script.
     * 
     * @param positions -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setBlackboxedRanges
        (String scriptId, Debugger.ScriptPosition[] positions)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (scriptId == null)  BRDPC.throwNPE("scriptId");
        if (positions == null) BRDPC.throwNPE("positions");
        
        final int       webSocketID = 2016000 + counter++;
        final boolean[] optionals   = { false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setBlackboxedRanges"),
            parameterNames.get("setBlackboxedRanges"),
            optionals, webSocketID,
            "Debugger.setBlackboxedRanges",
            scriptId, positions
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets JavaScript breakpoint at a given location.
     * 
     * @param location Location to set breakpoint in.
     * 
     * @param condition 
     * Expression to use as a breakpoint condition. When specified, debugger will only stop on the
     * breakpoint if this expression evaluates to true.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> String (<B>breakpointId</B>)</CODE>
     *     <BR />Id of the created breakpoint for further reference.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> {@link Debugger.Location} (<B>actualLocation</B>)</CODE>
     *     <BR />Location this breakpoint resolved into.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<String, Debugger.Location>> setBreakpoint
        (Debugger.Location location, String condition)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (location == null) BRDPC.throwNPE("location");
        
        final int       webSocketID = 2017000 + counter++;
        final boolean[] optionals   = { false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setBreakpoint"),
            parameterNames.get("setBreakpoint"),
            optionals, webSocketID,
            "Debugger.setBreakpoint",
            location, condition
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<String, Debugger.Location>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadJSON.getString(jo, "breakpointId", false, true),
                ReadJSON.getObject(jo, "actualLocation", Debugger.Location.class, false, true)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Sets instrumentation breakpoint.
     * 
     * @param instrumentation Instrumentation name.
     * <BR />Acceptable Values: ["beforeScriptExecution", "beforeScriptWithSourceMapExecution"]
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>breakpointId</B></CODE>)
     *     <BR />Id of the created breakpoint for further reference.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> setInstrumentationBreakpoint
        (String instrumentation)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (instrumentation == null) BRDPC.throwNPE("instrumentation");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "instrumentation", instrumentation,
            "beforeScriptExecution", "beforeScriptWithSourceMapExecution"
        );
        
        final int       webSocketID = 2018000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setInstrumentationBreakpoint"),
            parameterNames.get("setInstrumentationBreakpoint"),
            optionals, webSocketID,
            "Debugger.setInstrumentationBreakpoint",
            instrumentation
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "breakpointId", false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * 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
     * <CODE>locations</CODE> property. Further matching script parsing will result in subsequent
     * <CODE>breakpointResolved</CODE> events issued. This logical breakpoint will survive page reloads.
     * 
     * @param lineNumber Line number to set breakpoint at.
     * 
     * @param url URL of the resources to set breakpoint on.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param urlRegex 
     * Regex pattern for the URLs of the resources to set breakpoints on. Either <CODE>url</CODE> or
     * <CODE>urlRegex</CODE> must be specified.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param scriptHash Script hash of the resources to set breakpoint on.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param columnNumber Offset in the line to set breakpoint at.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param condition 
     * Expression to use as a breakpoint condition. When specified, debugger will only stop on the
     * breakpoint if this expression evaluates to true.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret2}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret2} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret2}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret2.a:</B> String (<B>breakpointId</B>)</CODE>
     *     <BR />Id of the created breakpoint for further reference.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> {@link Debugger.Location}[] (<B>locations</B>)</CODE>
     *     <BR />List of the locations this breakpoint resolved into upon addition.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<String, Debugger.Location[]>> setBreakpointByUrl(
            int lineNumber, String url, String urlRegex, String scriptHash, Integer columnNumber, 
            String condition
        )
    {
        final int       webSocketID = 2019000 + counter++;
        final boolean[] optionals   = { false, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setBreakpointByUrl"),
            parameterNames.get("setBreakpointByUrl"),
            optionals, webSocketID,
            "Debugger.setBreakpointByUrl",
            lineNumber, url, urlRegex, scriptHash, columnNumber, condition
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<String, Debugger.Location[]>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadJSON.getString(jo, "breakpointId", false, true),
                (jo.getJsonArray("locations") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("locations"), null, 0, Debugger.Location[].class)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * 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.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param objectId Function object id.
     * 
     * @param condition 
     * Expression to use as a breakpoint condition. When specified, debugger will
     * stop on the breakpoint if this expression evaluates to true.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String (<B>breakpointId</B></CODE>)
     *     <BR />Id of the created breakpoint for further reference.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> setBreakpointOnFunctionCall
        (String objectId, String condition)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (objectId == null) BRDPC.throwNPE("objectId");
        
        final int       webSocketID = 2020000 + counter++;
        final boolean[] optionals   = { false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setBreakpointOnFunctionCall"),
            parameterNames.get("setBreakpointOnFunctionCall"),
            optionals, webSocketID,
            "Debugger.setBreakpointOnFunctionCall",
            objectId, condition
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "breakpointId", false, true);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Activates / deactivates all breakpoints on the page.
     * 
     * @param active New value for breakpoints active state.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setBreakpointsActive(boolean active)
    {
        final int       webSocketID = 2021000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setBreakpointsActive"),
            parameterNames.get("setBreakpointsActive"),
            optionals, webSocketID,
            "Debugger.setBreakpointsActive",
            active
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Defines pause on exceptions state. Can be set to stop on all exceptions, uncaught exceptions or
     * no exceptions. Initial pause on exceptions state is <CODE>none</CODE>.
     * 
     * @param state Pause on exceptions mode.
     * <BR />Acceptable Values: ["none", "uncaught", "all"]
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setPauseOnExceptions(String state)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (state == null) BRDPC.throwNPE("state");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "state", state,
            "none", "uncaught", "all"
        );
        
        final int       webSocketID = 2022000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setPauseOnExceptions"),
            parameterNames.get("setPauseOnExceptions"),
            optionals, webSocketID,
            "Debugger.setPauseOnExceptions",
            state
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Changes return value in top frame. Available only at return break position.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param newValue New return value.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setReturnValue(RunTime.CallArgument newValue)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (newValue == null) BRDPC.throwNPE("newValue");
        
        final int       webSocketID = 2023000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setReturnValue"),
            parameterNames.get("setReturnValue"),
            optionals, webSocketID,
            "Debugger.setReturnValue",
            newValue
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Edits JavaScript source live.
     * 
     * @param scriptId Id of the script to edit.
     * 
     * @param scriptSource New content of the script.
     * 
     * @param dryRun 
     * If true the change will not actually be applied. Dry run may be used to get result
     * description without actually modifying the code.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret5}&gt;</CODE>
     *
     * <BR /><BR />This {@link Script} may be <B STYLE='color:red'>executed</B> (using 
     * {@link Script#exec()}), and a {@link Promise} returned.
     *
     * <BR /><BR />When the {@code Promise} is <B STYLE='color: red'>awaited</B>
     * (using {@link Promise#await()}), the {@code Ret5} will subsequently
     * be returned from that call.
     * 
     * <BR /><BR />The <B STYLE='color: red'>returned</B> values are encapsulated
     * in an instance of <B>{@link Ret5}</B>
     *
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE><B>Ret5.a:</B> {@link Debugger.CallFrame}[] (<B>callFrames</B>)</CODE>
     *     <BR />New stack trace in case editing has happened while VM was stopped.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret5.b:</B> Boolean (<B>stackChanged</B>)</CODE>
     *     <BR />Whether current call stack  was modified after applying the changes.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret5.c:</B> {@link RunTime.StackTrace} (<B>asyncStackTrace</B>)</CODE>
     *     <BR />Async stack trace, if any.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret5.d:</B> {@link RunTime.StackTraceId} (<B>asyncStackTraceId</B>)</CODE>
     *     <BR />Async stack trace, if any.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret5.e:</B> {@link RunTime.ExceptionDetails} (<B>exceptionDetails</B>)</CODE>
     *     <BR />Exception details if any.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret5<Debugger.CallFrame[], Boolean, RunTime.StackTrace, RunTime.StackTraceId, RunTime.ExceptionDetails>> 
        setScriptSource(String scriptId, String scriptSource, Boolean dryRun)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (scriptId == null)     BRDPC.throwNPE("scriptId");
        if (scriptSource == null) BRDPC.throwNPE("scriptSource");
        
        final int       webSocketID = 2024000 + counter++;
        final boolean[] optionals   = { false, false, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setScriptSource"),
            parameterNames.get("setScriptSource"),
            optionals, webSocketID,
            "Debugger.setScriptSource",
            scriptId, scriptSource, dryRun
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret5'
        Function<JsonObject, Ret5<Debugger.CallFrame[], Boolean, RunTime.StackTrace, RunTime.StackTraceId, RunTime.ExceptionDetails>> 
            responseProcessor = (JsonObject jo) -> new Ret5<>(
                (jo.getJsonArray("callFrames") == null)
                    ? null
                    : ReadArrJSON.DimN.objArr(jo.getJsonArray("callFrames"), null, 0, Debugger.CallFrame[].class),
                ReadBoxedJSON.getBoolean(jo, "stackChanged", true),
                ReadJSON.getObject(jo, "asyncStackTrace", RunTime.StackTrace.class, true, false),
                ReadJSON.getObject(jo, "asyncStackTraceId", RunTime.StackTraceId.class, true, false),
                ReadJSON.getObject(jo, "exceptionDetails", RunTime.ExceptionDetails.class, true, false)
            );
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * Makes page not interrupt on any pauses (breakpoint, exception, dom exception etc).
     * 
     * @param skip New value for skip pauses state.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setSkipAllPauses(boolean skip)
    {
        final int       webSocketID = 2025000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setSkipAllPauses"),
            parameterNames.get("setSkipAllPauses"),
            optionals, webSocketID,
            "Debugger.setSkipAllPauses",
            skip
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Changes value of variable in a callframe. Object-based scopes are not supported and must be
     * mutated manually.
     * 
     * @param 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.
     * 
     * @param variableName Variable name.
     * 
     * @param newValue New variable value.
     * 
     * @param callFrameId Id of callframe that holds variable.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setVariableValue
        (int scopeNumber, String variableName, RunTime.CallArgument newValue, String callFrameId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (variableName == null) BRDPC.throwNPE("variableName");
        if (newValue == null)     BRDPC.throwNPE("newValue");
        if (callFrameId == null)  BRDPC.throwNPE("callFrameId");
        
        final int       webSocketID = 2026000 + counter++;
        final boolean[] optionals   = { false, false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setVariableValue"),
            parameterNames.get("setVariableValue"),
            optionals, webSocketID,
            "Debugger.setVariableValue",
            scopeNumber, variableName, newValue, callFrameId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Steps into the function call.
     * 
     * @param breakOnAsyncCall 
     * Debugger will pause on the execution of the first async task which was scheduled
     * before next pause.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param skipList The skipList specifies location ranges that should be skipped on step into.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> stepInto
        (Boolean breakOnAsyncCall, Debugger.LocationRange[] skipList)
    {
        final int       webSocketID = 2027000 + counter++;
        final boolean[] optionals   = { true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("stepInto"),
            parameterNames.get("stepInto"),
            optionals, webSocketID,
            "Debugger.stepInto",
            breakOnAsyncCall, skipList
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Steps out of the function call.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> stepOut()
    {
        final int          webSocketID = 2028000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("stepOut"),
            parameterNames.get("stepOut"),
            optionals, webSocketID,
            "Debugger.stepOut"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Steps over the statement.
     * 
     * @param skipList The skipList specifies location ranges that should be skipped on step over.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> stepOver(Debugger.LocationRange[] skipList)
    {
        final int       webSocketID = 2029000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("stepOver"),
            parameterNames.get("stepOver"),
            optionals, webSocketID,
            "Debugger.stepOver",
            (Object) skipList
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}