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>This domain exposes DOM read/write operations. Each DOM Node is represented with its mirror object
 * that has an <CODE>id</CODE>. This <CODE>id</CODE> can be used to get additional information on the Node, resolve it into
 * the JavaScript object wrapper, etc. It is important that client receives DOM events only for the
 * nodes that are known to the client. Backend keeps track of the nodes that were sent to the client
 * and never sends the same node twice. It is client's responsibility to collect information about
 * the nodes that were sent to the client.<p>Note that <CODE>iframe</CODE> owner elements will return
 * corresponding document elements as their child nodes.</p></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 DOM
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private DOM () { }

    // 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 : DOM.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>(1);
        parameterNames.put("collectClassNamesFromSubtree", v);
        Collections.addAll(v, new String[]
        { "nodeId", });

        v = new Vector<String>(3);
        parameterNames.put("copyTo", v);
        Collections.addAll(v, new String[]
        { "nodeId", "targetNodeId", "insertBeforeNodeId", });

        v = new Vector<String>(5);
        parameterNames.put("describeNode", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectId", "depth", "pierce", });

        v = new Vector<String>(4);
        parameterNames.put("scrollIntoViewIfNeeded", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectId", "rect", });

        parameterNames.put("disable", EMPTY_VEC_STR);

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

        parameterNames.put("enable", EMPTY_VEC_STR);

        v = new Vector<String>(3);
        parameterNames.put("focus", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectId", });

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

        v = new Vector<String>(3);
        parameterNames.put("getBoxModel", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectId", });

        v = new Vector<String>(3);
        parameterNames.put("getContentQuads", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectId", });

        v = new Vector<String>(2);
        parameterNames.put("getDocument", v);
        Collections.addAll(v, new String[]
        { "depth", "pierce", });

        v = new Vector<String>(2);
        parameterNames.put("getFlattenedDocument", v);
        Collections.addAll(v, new String[]
        { "depth", "pierce", });

        v = new Vector<String>(3);
        parameterNames.put("getNodesForSubtreeByStyle", v);
        Collections.addAll(v, new String[]
        { "nodeId", "computedStyles", "pierce", });

        v = new Vector<String>(4);
        parameterNames.put("getNodeForLocation", v);
        Collections.addAll(v, new String[]
        { "x", "y", "includeUserAgentShadowDOM", "ignorePointerEventsNone", });

        v = new Vector<String>(3);
        parameterNames.put("getOuterHTML", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectId", });

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

        v = new Vector<String>(3);
        parameterNames.put("getSearchResults", v);
        Collections.addAll(v, new String[]
        { "searchId", "fromIndex", "toIndex", });

        parameterNames.put("hideHighlight", EMPTY_VEC_STR);

        parameterNames.put("highlightNode", EMPTY_VEC_STR);

        parameterNames.put("highlightRect", EMPTY_VEC_STR);

        parameterNames.put("markUndoableState", EMPTY_VEC_STR);

        v = new Vector<String>(3);
        parameterNames.put("moveTo", v);
        Collections.addAll(v, new String[]
        { "nodeId", "targetNodeId", "insertBeforeNodeId", });

        v = new Vector<String>(2);
        parameterNames.put("performSearch", v);
        Collections.addAll(v, new String[]
        { "query", "includeUserAgentShadowDOM", });

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

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

        v = new Vector<String>(2);
        parameterNames.put("querySelector", v);
        Collections.addAll(v, new String[]
        { "nodeId", "selector", });

        v = new Vector<String>(2);
        parameterNames.put("querySelectorAll", v);
        Collections.addAll(v, new String[]
        { "nodeId", "selector", });

        parameterNames.put("redo", EMPTY_VEC_STR);

        v = new Vector<String>(2);
        parameterNames.put("removeAttribute", v);
        Collections.addAll(v, new String[]
        { "nodeId", "name", });

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

        v = new Vector<String>(3);
        parameterNames.put("requestChildNodes", v);
        Collections.addAll(v, new String[]
        { "nodeId", "depth", "pierce", });

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

        v = new Vector<String>(4);
        parameterNames.put("resolveNode", v);
        Collections.addAll(v, new String[]
        { "nodeId", "backendNodeId", "objectGroup", "executionContextId", });

        v = new Vector<String>(3);
        parameterNames.put("setAttributeValue", v);
        Collections.addAll(v, new String[]
        { "nodeId", "name", "value", });

        v = new Vector<String>(3);
        parameterNames.put("setAttributesAsText", v);
        Collections.addAll(v, new String[]
        { "nodeId", "text", "name", });

        v = new Vector<String>(4);
        parameterNames.put("setFileInputFiles", v);
        Collections.addAll(v, new String[]
        { "files", "nodeId", "backendNodeId", "objectId", });

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

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

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

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

        v = new Vector<String>(2);
        parameterNames.put("setNodeName", v);
        Collections.addAll(v, new String[]
        { "nodeId", "name", });

        v = new Vector<String>(2);
        parameterNames.put("setNodeValue", v);
        Collections.addAll(v, new String[]
        { "nodeId", "value", });

        v = new Vector<String>(2);
        parameterNames.put("setOuterHTML", v);
        Collections.addAll(v, new String[]
        { "nodeId", "outerHTML", });

        parameterNames.put("undo", EMPTY_VEC_STR);

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

        v = new Vector<String>(2);
        parameterNames.put("getContainerForNode", v);
        Collections.addAll(v, new String[]
        { "nodeId", "containerName", });

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


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

    // public static class NodeId => Integer
    
    // public static class BackendNodeId => Integer
    
    // public static class Quad => Number[]
    
    /** Pseudo element type. */
    public static final String[] PseudoType =
    { 
        "first-line", "first-letter", "before", "after", "marker", "backdrop", "selection", 
        "target-text", "spelling-error", "grammar-error", "highlight", "first-line-inherited", 
        "scrollbar", "scrollbar-thumb", "scrollbar-button", "scrollbar-track", 
        "scrollbar-track-piece", "scrollbar-corner", "resizer", "input-list-button", 
    };
    
    /** Shadow root type. */
    public static final String[] ShadowRootType =
    { "user-agent", "open", "closed", };
    
    /** Document compatibility mode. */
    public static final String[] CompatibilityMode =
    { "QuirksMode", "LimitedQuirksMode", "NoQuirksMode", };
    
    /** Backend node with a friendly name. */
    public static class BackendNode
        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>Node</CODE>'s nodeType. */
        public final int nodeType;
        
        /** <CODE>Node</CODE>'s nodeName. */
        public final String nodeName;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final int backendNodeId;
        
        /**
         * Constructor
         *
         * @param nodeType <CODE>Node</CODE>'s nodeType.
         * 
         * @param nodeName <CODE>Node</CODE>'s nodeName.
         * 
         * @param backendNodeId -
         */
        public BackendNode(int nodeType, String nodeName, int backendNodeId)
        {
            // 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 (nodeName == null) BRDPC.throwNPE("nodeName");
            
            this.nodeType       = nodeType;
            this.nodeName       = nodeName;
            this.backendNodeId  = backendNodeId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'BackendNode'}.
         */
        public BackendNode (JsonObject jo)
        {
            this.nodeType       = ReadPrimJSON.getInt(jo, "nodeType");
            this.nodeName       = ReadJSON.getString(jo, "nodeName", false, true);
            this.backendNodeId  = ReadPrimJSON.getInt(jo, "backendNodeId");
        }
        
        
        /** 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;
        
            BackendNode o = (BackendNode) other;
        
            return
                    (this.nodeType == o.nodeType)
                &&  Objects.equals(this.nodeName, o.nodeName)
                &&  Objects.equals(this.backendNodeId, o.backendNodeId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.nodeType
                +   Objects.hashCode(this.nodeName)
                +   this.backendNodeId;
        }
    }
    
    /**
     * DOM interaction is implemented in terms of mirror objects that represent the actual DOM nodes.
     * DOMNode is a base node mirror type.
     */
    public static class Node
        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, false, false, false, false, false, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, true, }; }
        
        /**
         * Node identifier that is passed into the rest of the DOM messages as the <CODE>nodeId</CODE>. Backend
         * will only push node with given <CODE>id</CODE> once. It is aware of all requested nodes and will only
         * fire DOM events for nodes known to the client.
         */
        public final int nodeId;
        
        /**
         * The id of the parent node if any.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer parentId;
        
        /** The BackendNodeId for this node. */
        public final int backendNodeId;
        
        /** <CODE>Node</CODE>'s nodeType. */
        public final int nodeType;
        
        /** <CODE>Node</CODE>'s nodeName. */
        public final String nodeName;
        
        /** <CODE>Node</CODE>'s localName. */
        public final String localName;
        
        /** <CODE>Node</CODE>'s nodeValue. */
        public final String nodeValue;
        
        /**
         * Child count for <CODE>Container</CODE> nodes.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Integer childNodeCount;
        
        /**
         * Child nodes of this node when requested with children.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.Node[] children;
        
        /**
         * Attributes of the <CODE>Element</CODE> node in the form of flat array <CODE>[name1, value1, name2, value2]</CODE>.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String[] attributes;
        
        /**
         * Document URL that <CODE>Document</CODE> or <CODE>FrameOwner</CODE> node points to.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String documentURL;
        
        /**
         * Base URL that <CODE>Document</CODE> or <CODE>FrameOwner</CODE> node uses for URL completion.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String baseURL;
        
        /**
         * <CODE>DocumentType</CODE>'s publicId.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String publicId;
        
        /**
         * <CODE>DocumentType</CODE>'s systemId.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String systemId;
        
        /**
         * <CODE>DocumentType</CODE>'s internalSubset.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String internalSubset;
        
        /**
         * <CODE>Document</CODE>'s XML version in case of XML documents.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String xmlVersion;
        
        /**
         * <CODE>Attr</CODE>'s name.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String name;
        
        /**
         * <CODE>Attr</CODE>'s value.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String value;
        
        /**
         * Pseudo element type for this node.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String pseudoType;
        
        /**
         * Shadow root type.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String shadowRootType;
        
        /**
         * Frame ID for frame owner elements.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String frameId;
        
        /**
         * Content document for frame owner elements.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.Node contentDocument;
        
        /**
         * Shadow root list for given element host.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.Node[] shadowRoots;
        
        /**
         * Content document fragment for template elements.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.Node templateContent;
        
        /**
         * Pseudo elements associated with this node.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.Node[] pseudoElements;
        
        /**
         * Deprecated, as the HTML Imports API has been removed (crbug.com/937746).
         * This property used to return the imported document for the HTMLImport links.
         * The property is always undefined now.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>DEPRECATED</B>
         */
        public final DOM.Node importedDocument;
        
        /**
         * Distributed nodes for given insertion point.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.BackendNode[] distributedNodes;
        
        /**
         * Whether the node is SVG.
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Boolean isSVG;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String compatibilityMode;
        
        /**
         * Constructor
         *
         * @param nodeId 
         * Node identifier that is passed into the rest of the DOM messages as the <CODE>nodeId</CODE>. Backend
         * will only push node with given <CODE>id</CODE> once. It is aware of all requested nodes and will only
         * fire DOM events for nodes known to the client.
         * 
         * @param parentId The id of the parent node if any.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param backendNodeId The BackendNodeId for this node.
         * 
         * @param nodeType <CODE>Node</CODE>'s nodeType.
         * 
         * @param nodeName <CODE>Node</CODE>'s nodeName.
         * 
         * @param localName <CODE>Node</CODE>'s localName.
         * 
         * @param nodeValue <CODE>Node</CODE>'s nodeValue.
         * 
         * @param childNodeCount Child count for <CODE>Container</CODE> nodes.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param children Child nodes of this node when requested with children.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param attributes Attributes of the <CODE>Element</CODE> node in the form of flat array <CODE>[name1, value1, name2, value2]</CODE>.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param documentURL Document URL that <CODE>Document</CODE> or <CODE>FrameOwner</CODE> node points to.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param baseURL Base URL that <CODE>Document</CODE> or <CODE>FrameOwner</CODE> node uses for URL completion.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param publicId <CODE>DocumentType</CODE>'s publicId.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param systemId <CODE>DocumentType</CODE>'s systemId.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param internalSubset <CODE>DocumentType</CODE>'s internalSubset.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param xmlVersion <CODE>Document</CODE>'s XML version in case of XML documents.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param name <CODE>Attr</CODE>'s name.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param value <CODE>Attr</CODE>'s value.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param pseudoType Pseudo element type for this node.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param shadowRootType Shadow root type.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param frameId Frame ID for frame owner elements.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param contentDocument Content document for frame owner elements.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param shadowRoots Shadow root list for given element host.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param templateContent Content document fragment for template elements.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param pseudoElements Pseudo elements associated with this node.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param importedDocument 
         * Deprecated, as the HTML Imports API has been removed (crbug.com/937746).
         * This property used to return the imported document for the HTMLImport links.
         * The property is always undefined now.
         * <BR /><B>OPTIONAL</B>
         * <BR /><B>DEPRECATED</B>
         * 
         * @param distributedNodes Distributed nodes for given insertion point.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param isSVG Whether the node is SVG.
         * <BR /><B>OPTIONAL</B>
         * 
         * @param compatibilityMode -
         * <BR /><B>OPTIONAL</B>
         */
        public Node(
                int nodeId, Integer parentId, int backendNodeId, int nodeType, String nodeName, 
                String localName, String nodeValue, Integer childNodeCount, DOM.Node[] children, 
                String[] attributes, String documentURL, String baseURL, String publicId, 
                String systemId, String internalSubset, String xmlVersion, String name, 
                String value, String pseudoType, String shadowRootType, String frameId, 
                DOM.Node contentDocument, DOM.Node[] shadowRoots, DOM.Node templateContent, 
                DOM.Node[] pseudoElements, DOM.Node importedDocument, 
                DOM.BackendNode[] distributedNodes, Boolean isSVG, String compatibilityMode
            )
        {
            // 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 (nodeName == null)  BRDPC.throwNPE("nodeName");
            if (localName == null) BRDPC.throwNPE("localName");
            if (nodeValue == null) BRDPC.throwNPE("nodeValue");
            
            // 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("pseudoType", pseudoType, "DOM.PseudoType", DOM.PseudoType);
            BRDPC.checkIAE("shadowRootType", shadowRootType, "DOM.ShadowRootType", DOM.ShadowRootType);
            BRDPC.checkIAE("compatibilityMode", compatibilityMode, "DOM.CompatibilityMode", DOM.CompatibilityMode);
            
            this.nodeId             = nodeId;
            this.parentId           = parentId;
            this.backendNodeId      = backendNodeId;
            this.nodeType           = nodeType;
            this.nodeName           = nodeName;
            this.localName          = localName;
            this.nodeValue          = nodeValue;
            this.childNodeCount     = childNodeCount;
            this.children           = children;
            this.attributes         = attributes;
            this.documentURL        = documentURL;
            this.baseURL            = baseURL;
            this.publicId           = publicId;
            this.systemId           = systemId;
            this.internalSubset     = internalSubset;
            this.xmlVersion         = xmlVersion;
            this.name               = name;
            this.value              = value;
            this.pseudoType         = pseudoType;
            this.shadowRootType     = shadowRootType;
            this.frameId            = frameId;
            this.contentDocument    = contentDocument;
            this.shadowRoots        = shadowRoots;
            this.templateContent    = templateContent;
            this.pseudoElements     = pseudoElements;
            this.importedDocument   = importedDocument;
            this.distributedNodes   = distributedNodes;
            this.isSVG              = isSVG;
            this.compatibilityMode  = compatibilityMode;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Node'}.
         */
        public Node (JsonObject jo)
        {
            this.nodeId             = ReadPrimJSON.getInt(jo, "nodeId");
            this.parentId           = ReadBoxedJSON.getInteger(jo, "parentId", true);
            this.backendNodeId      = ReadPrimJSON.getInt(jo, "backendNodeId");
            this.nodeType           = ReadPrimJSON.getInt(jo, "nodeType");
            this.nodeName           = ReadJSON.getString(jo, "nodeName", false, true);
            this.localName          = ReadJSON.getString(jo, "localName", false, true);
            this.nodeValue          = ReadJSON.getString(jo, "nodeValue", false, true);
            this.childNodeCount     = ReadBoxedJSON.getInteger(jo, "childNodeCount", true);
            this.children = (jo.getJsonArray("children") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("children"), null, 0, DOM.Node[].class);
        
            this.attributes = (jo.getJsonArray("attributes") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("attributes"), null, 0, String[].class);
        
            this.documentURL        = ReadJSON.getString(jo, "documentURL", true, false);
            this.baseURL            = ReadJSON.getString(jo, "baseURL", true, false);
            this.publicId           = ReadJSON.getString(jo, "publicId", true, false);
            this.systemId           = ReadJSON.getString(jo, "systemId", true, false);
            this.internalSubset     = ReadJSON.getString(jo, "internalSubset", true, false);
            this.xmlVersion         = ReadJSON.getString(jo, "xmlVersion", true, false);
            this.name               = ReadJSON.getString(jo, "name", true, false);
            this.value              = ReadJSON.getString(jo, "value", true, false);
            this.pseudoType         = ReadJSON.getString(jo, "pseudoType", true, false);
            this.shadowRootType     = ReadJSON.getString(jo, "shadowRootType", true, false);
            this.frameId            = ReadJSON.getString(jo, "frameId", true, false);
            this.contentDocument    = ReadJSON.getObject(jo, "contentDocument", DOM.Node.class, true, false);
            this.shadowRoots = (jo.getJsonArray("shadowRoots") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("shadowRoots"), null, 0, DOM.Node[].class);
        
            this.templateContent    = ReadJSON.getObject(jo, "templateContent", DOM.Node.class, true, false);
            this.pseudoElements = (jo.getJsonArray("pseudoElements") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("pseudoElements"), null, 0, DOM.Node[].class);
        
            this.importedDocument   = ReadJSON.getObject(jo, "importedDocument", DOM.Node.class, true, false);
            this.distributedNodes = (jo.getJsonArray("distributedNodes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("distributedNodes"), null, 0, DOM.BackendNode[].class);
        
            this.isSVG              = ReadBoxedJSON.getBoolean(jo, "isSVG", true);
            this.compatibilityMode  = ReadJSON.getString(jo, "compatibilityMode", 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;
        
            Node o = (Node) other;
        
            return
                    Objects.equals(this.nodeId, o.nodeId)
                &&  Objects.equals(this.parentId, o.parentId)
                &&  Objects.equals(this.backendNodeId, o.backendNodeId)
                &&  (this.nodeType == o.nodeType)
                &&  Objects.equals(this.nodeName, o.nodeName)
                &&  Objects.equals(this.localName, o.localName)
                &&  Objects.equals(this.nodeValue, o.nodeValue)
                &&  Objects.equals(this.childNodeCount, o.childNodeCount)
                &&  Arrays.deepEquals(this.children, o.children)
                &&  Arrays.deepEquals(this.attributes, o.attributes)
                &&  Objects.equals(this.documentURL, o.documentURL)
                &&  Objects.equals(this.baseURL, o.baseURL)
                &&  Objects.equals(this.publicId, o.publicId)
                &&  Objects.equals(this.systemId, o.systemId)
                &&  Objects.equals(this.internalSubset, o.internalSubset)
                &&  Objects.equals(this.xmlVersion, o.xmlVersion)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value)
                &&  Objects.equals(this.pseudoType, o.pseudoType)
                &&  Objects.equals(this.shadowRootType, o.shadowRootType)
                &&  Objects.equals(this.frameId, o.frameId)
                &&  Objects.equals(this.contentDocument, o.contentDocument)
                &&  Arrays.deepEquals(this.shadowRoots, o.shadowRoots)
                &&  Objects.equals(this.templateContent, o.templateContent)
                &&  Arrays.deepEquals(this.pseudoElements, o.pseudoElements)
                &&  Objects.equals(this.importedDocument, o.importedDocument)
                &&  Arrays.deepEquals(this.distributedNodes, o.distributedNodes)
                &&  Objects.equals(this.isSVG, o.isSVG)
                &&  Objects.equals(this.compatibilityMode, o.compatibilityMode);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.nodeId
                +   Objects.hashCode(this.parentId)
                +   this.backendNodeId
                +   this.nodeType
                +   Objects.hashCode(this.nodeName)
                +   Objects.hashCode(this.localName)
                +   Objects.hashCode(this.nodeValue)
                +   Objects.hashCode(this.childNodeCount)
                +   Arrays.deepHashCode(this.children)
                +   Arrays.deepHashCode(this.attributes)
                +   Objects.hashCode(this.documentURL)
                +   Objects.hashCode(this.baseURL)
                +   Objects.hashCode(this.publicId)
                +   Objects.hashCode(this.systemId)
                +   Objects.hashCode(this.internalSubset)
                +   Objects.hashCode(this.xmlVersion)
                +   Objects.hashCode(this.name)
                +   Objects.hashCode(this.value)
                +   Objects.hashCode(this.pseudoType)
                +   Objects.hashCode(this.shadowRootType)
                +   Objects.hashCode(this.frameId)
                +   this.contentDocument.hashCode()
                +   Arrays.deepHashCode(this.shadowRoots)
                +   this.templateContent.hashCode()
                +   Arrays.deepHashCode(this.pseudoElements)
                +   this.importedDocument.hashCode()
                +   Arrays.deepHashCode(this.distributedNodes)
                +   Objects.hashCode(this.isSVG)
                +   Objects.hashCode(this.compatibilityMode);
        }
    }
    
    /** A structure holding an RGBA color. */
    public static class RGBA
        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, true, }; }
        
        /** The red component, in the [0-255] range. */
        public final int r;
        
        /** The green component, in the [0-255] range. */
        public final int g;
        
        /** The blue component, in the [0-255] range. */
        public final int b;
        
        /**
         * The alpha component, in the [0-1] range (default: 1).
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Number a;
        
        /**
         * Constructor
         *
         * @param r The red component, in the [0-255] range.
         * 
         * @param g The green component, in the [0-255] range.
         * 
         * @param b The blue component, in the [0-255] range.
         * 
         * @param a The alpha component, in the [0-1] range (default: 1).
         * <BR /><B>OPTIONAL</B>
         */
        public RGBA(int r, int g, int b, Number a)
        {
            this.r  = r;
            this.g  = g;
            this.b  = b;
            this.a  = a;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'RGBA'}.
         */
        public RGBA (JsonObject jo)
        {
            this.r  = ReadPrimJSON.getInt(jo, "r");
            this.g  = ReadPrimJSON.getInt(jo, "g");
            this.b  = ReadPrimJSON.getInt(jo, "b");
            this.a  = ReadNumberJSON.get(jo, "a", 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;
        
            RGBA o = (RGBA) other;
        
            return
                    (this.r == o.r)
                &&  (this.g == o.g)
                &&  (this.b == o.b)
                &&  Objects.equals(this.a, o.a);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.r
                +   this.g
                +   this.b
                +   Objects.hashCode(this.a);
        }
    }
    
    /** Box model. */
    public static class BoxModel
        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, false, false, false, true, }; }
        
        /** Content box */
        public final Number[] content;
        
        /** Padding box */
        public final Number[] padding;
        
        /** Border box */
        public final Number[] border;
        
        /** Margin box */
        public final Number[] margin;
        
        /** Node width */
        public final int width;
        
        /** Node height */
        public final int height;
        
        /**
         * Shape outside coordinates
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final DOM.ShapeOutsideInfo shapeOutside;
        
        /**
         * Constructor
         *
         * @param content Content box
         * 
         * @param padding Padding box
         * 
         * @param border Border box
         * 
         * @param margin Margin box
         * 
         * @param width Node width
         * 
         * @param height Node height
         * 
         * @param shapeOutside Shape outside coordinates
         * <BR /><B>OPTIONAL</B>
         */
        public BoxModel(
                Number[] content, Number[] padding, Number[] border, Number[] margin, int width, 
                int height, DOM.ShapeOutsideInfo shapeOutside
            )
        {
            // 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 (content == null) BRDPC.throwNPE("content");
            if (padding == null) BRDPC.throwNPE("padding");
            if (border == null)  BRDPC.throwNPE("border");
            if (margin == null)  BRDPC.throwNPE("margin");
            
            this.content       = content;
            this.padding       = padding;
            this.border        = border;
            this.margin        = margin;
            this.width         = width;
            this.height        = height;
            this.shapeOutside  = shapeOutside;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'BoxModel'}.
         */
        public BoxModel (JsonObject jo)
        {
            this.content = (jo.getJsonArray("content") == null)
                ? null
                : ReadArrJSON.DimN.arrNumber(jo.getJsonArray("content"), -1, 0, null, Number[].class);
        
            this.padding = (jo.getJsonArray("padding") == null)
                ? null
                : ReadArrJSON.DimN.arrNumber(jo.getJsonArray("padding"), -1, 0, null, Number[].class);
        
            this.border = (jo.getJsonArray("border") == null)
                ? null
                : ReadArrJSON.DimN.arrNumber(jo.getJsonArray("border"), -1, 0, null, Number[].class);
        
            this.margin = (jo.getJsonArray("margin") == null)
                ? null
                : ReadArrJSON.DimN.arrNumber(jo.getJsonArray("margin"), -1, 0, null, Number[].class);
        
            this.width         = ReadPrimJSON.getInt(jo, "width");
            this.height        = ReadPrimJSON.getInt(jo, "height");
            this.shapeOutside  = ReadJSON.getObject(jo, "shapeOutside", DOM.ShapeOutsideInfo.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;
        
            BoxModel o = (BoxModel) other;
        
            return
                    Objects.equals(this.content, o.content)
                &&  Objects.equals(this.padding, o.padding)
                &&  Objects.equals(this.border, o.border)
                &&  Objects.equals(this.margin, o.margin)
                &&  (this.width == o.width)
                &&  (this.height == o.height)
                &&  Objects.equals(this.shapeOutside, o.shapeOutside);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.content)
                +   Arrays.deepHashCode(this.padding)
                +   Arrays.deepHashCode(this.border)
                +   Arrays.deepHashCode(this.margin)
                +   this.width
                +   this.height
                +   this.shapeOutside.hashCode();
        }
    }
    
    /** CSS Shape Outside details. */
    public static class ShapeOutsideInfo
        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, }; }
        
        /** Shape bounds */
        public final Number[] bounds;
        
        /** Shape coordinate details */
        public final JsonArray shape;
        
        /** Margin shape bounds */
        public final JsonArray marginShape;
        
        /**
         * Constructor
         *
         * @param bounds Shape bounds
         * 
         * @param shape Shape coordinate details
         * 
         * @param marginShape Margin shape bounds
         */
        public ShapeOutsideInfo(Number[] bounds, JsonArray shape, JsonArray marginShape)
        {
            // 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 (bounds == null)      BRDPC.throwNPE("bounds");
            if (shape == null)       BRDPC.throwNPE("shape");
            if (marginShape == null) BRDPC.throwNPE("marginShape");
            
            this.bounds       = bounds;
            this.shape        = shape;
            this.marginShape  = marginShape;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'ShapeOutsideInfo'}.
         */
        public ShapeOutsideInfo (JsonObject jo)
        {
            this.bounds = (jo.getJsonArray("bounds") == null)
                ? null
                : ReadArrJSON.DimN.arrNumber(jo.getJsonArray("bounds"), -1, 0, null, Number[].class);
        
            this.shape        = jo.getJsonArray("shape");
            this.marginShape  = jo.getJsonArray("marginShape");
        }
        
        
        /** 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;
        
            ShapeOutsideInfo o = (ShapeOutsideInfo) other;
        
            return
                    Objects.equals(this.bounds, o.bounds)
                &&  Objects.equals(this.shape, o.shape)
                &&  Objects.equals(this.marginShape, o.marginShape);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.bounds)
                +   Objects.hashCode(this.shape)
                +   Objects.hashCode(this.marginShape);
        }
    }
    
    /** Rectangle. */
    public static class Rect
        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, false, }; }
        
        /** X coordinate */
        public final Number x;
        
        /** Y coordinate */
        public final Number y;
        
        /** Rectangle width */
        public final Number width;
        
        /** Rectangle height */
        public final Number height;
        
        /**
         * Constructor
         *
         * @param x X coordinate
         * 
         * @param y Y coordinate
         * 
         * @param width Rectangle width
         * 
         * @param height Rectangle height
         */
        public Rect(Number x, Number y, Number width, Number height)
        {
            // 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 (x == null)      BRDPC.throwNPE("x");
            if (y == null)      BRDPC.throwNPE("y");
            if (width == null)  BRDPC.throwNPE("width");
            if (height == null) BRDPC.throwNPE("height");
            
            this.x       = x;
            this.y       = y;
            this.width   = width;
            this.height  = height;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'Rect'}.
         */
        public Rect (JsonObject jo)
        {
            this.x       = ReadNumberJSON.get(jo, "x", false, true);
            this.y       = ReadNumberJSON.get(jo, "y", false, true);
            this.width   = ReadNumberJSON.get(jo, "width", false, true);
            this.height  = ReadNumberJSON.get(jo, "height", 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;
        
            Rect o = (Rect) other;
        
            return
                    Objects.equals(this.x, o.x)
                &&  Objects.equals(this.y, o.y)
                &&  Objects.equals(this.width, o.width)
                &&  Objects.equals(this.height, o.height);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.x)
                +   Objects.hashCode(this.y)
                +   Objects.hashCode(this.width)
                +   Objects.hashCode(this.height);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class CSSComputedStyleProperty
        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, }; }
        
        /** Computed style property name. */
        public final String name;
        
        /** Computed style property value. */
        public final String value;
        
        /**
         * Constructor
         *
         * @param name Computed style property name.
         * 
         * @param value Computed style property value.
         */
        public CSSComputedStyleProperty(String name, String value)
        {
            // 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 (name == null)  BRDPC.throwNPE("name");
            if (value == null) BRDPC.throwNPE("value");
            
            this.name   = name;
            this.value  = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'CSSComputedStyleProperty'}.
         */
        public CSSComputedStyleProperty (JsonObject jo)
        {
            this.name   = ReadJSON.getString(jo, "name", false, true);
            this.value  = ReadJSON.getString(jo, "value", 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;
        
            CSSComputedStyleProperty o = (CSSComputedStyleProperty) other;
        
            return
                    Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.name)
                +   Objects.hashCode(this.value);
        }
    }
    
    /**
     * Fired when <CODE>Document</CODE> has been totally updated. Node ids are no longer valid.
     *
     * <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 documentUpdated
        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 documentUpdated(JsonObject jo)
        { super("DOM", "documentUpdated", 0); }
    
        @Override
        public String toString() { return "DOM.documentUpdated Marker Event\n"; }
    }
    
    /** Fired when <CODE>Element</CODE>'s attribute is modified. */
    public static class attributeModified
        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, }; }
        
        /** Id of the node that has changed. */
        public final int nodeId;
        
        /** Attribute name. */
        public final String name;
        
        /** Attribute value. */
        public final String value;
        
        /**
         * Constructor
         *
         * @param nodeId Id of the node that has changed.
         * 
         * @param name Attribute name.
         * 
         * @param value Attribute value.
         */
        public attributeModified(int nodeId, String name, String value)
        {
            super("DOM", "attributeModified", 3);
            
            // 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 (name == null)  BRDPC.throwNPE("name");
            if (value == null) BRDPC.throwNPE("value");
            
            this.nodeId  = nodeId;
            this.name    = name;
            this.value   = value;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'attributeModified'}.
         */
        public attributeModified (JsonObject jo)
        {
            super("DOM", "attributeModified", 3);
        
            this.nodeId  = ReadPrimJSON.getInt(jo, "nodeId");
            this.name    = ReadJSON.getString(jo, "name", false, true);
            this.value   = ReadJSON.getString(jo, "value", 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;
        
            attributeModified o = (attributeModified) other;
        
            return
                    Objects.equals(this.nodeId, o.nodeId)
                &&  Objects.equals(this.name, o.name)
                &&  Objects.equals(this.value, o.value);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.nodeId
                +   Objects.hashCode(this.name)
                +   Objects.hashCode(this.value);
        }
    }
    
    /** Fired when <CODE>Element</CODE>'s attribute is removed. */
    public static class attributeRemoved
        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, }; }
        
        /** Id of the node that has changed. */
        public final int nodeId;
        
        /** A ttribute name. */
        public final String name;
        
        /**
         * Constructor
         *
         * @param nodeId Id of the node that has changed.
         * 
         * @param name A ttribute name.
         */
        public attributeRemoved(int nodeId, String name)
        {
            super("DOM", "attributeRemoved", 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 (name == null) BRDPC.throwNPE("name");
            
            this.nodeId  = nodeId;
            this.name    = name;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'attributeRemoved'}.
         */
        public attributeRemoved (JsonObject jo)
        {
            super("DOM", "attributeRemoved", 2);
        
            this.nodeId  = ReadPrimJSON.getInt(jo, "nodeId");
            this.name    = ReadJSON.getString(jo, "name", 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;
        
            attributeRemoved o = (attributeRemoved) other;
        
            return
                    Objects.equals(this.nodeId, o.nodeId)
                &&  Objects.equals(this.name, o.name);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.nodeId
                +   Objects.hashCode(this.name);
        }
    }
    
    /** Mirrors <CODE>DOMCharacterDataModified</CODE> event. */
    public static class characterDataModified
        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, }; }
        
        /** Id of the node that has changed. */
        public final int nodeId;
        
        /** New text value. */
        public final String characterData;
        
        /**
         * Constructor
         *
         * @param nodeId Id of the node that has changed.
         * 
         * @param characterData New text value.
         */
        public characterDataModified(int nodeId, String characterData)
        {
            super("DOM", "characterDataModified", 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 (characterData == null) BRDPC.throwNPE("characterData");
            
            this.nodeId         = nodeId;
            this.characterData  = characterData;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'characterDataModified'}.
         */
        public characterDataModified (JsonObject jo)
        {
            super("DOM", "characterDataModified", 2);
        
            this.nodeId         = ReadPrimJSON.getInt(jo, "nodeId");
            this.characterData  = ReadJSON.getString(jo, "characterData", 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;
        
            characterDataModified o = (characterDataModified) other;
        
            return
                    Objects.equals(this.nodeId, o.nodeId)
                &&  Objects.equals(this.characterData, o.characterData);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.nodeId
                +   Objects.hashCode(this.characterData);
        }
    }
    
    /** Fired when <CODE>Container</CODE>'s child node count has changed. */
    public static class childNodeCountUpdated
        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, }; }
        
        /** Id of the node that has changed. */
        public final int nodeId;
        
        /** New node count. */
        public final int childNodeCount;
        
        /**
         * Constructor
         *
         * @param nodeId Id of the node that has changed.
         * 
         * @param childNodeCount New node count.
         */
        public childNodeCountUpdated(int nodeId, int childNodeCount)
        {
            super("DOM", "childNodeCountUpdated", 2);
            
            this.nodeId          = nodeId;
            this.childNodeCount  = childNodeCount;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'childNodeCountUpdated'}.
         */
        public childNodeCountUpdated (JsonObject jo)
        {
            super("DOM", "childNodeCountUpdated", 2);
        
            this.nodeId          = ReadPrimJSON.getInt(jo, "nodeId");
            this.childNodeCount  = ReadPrimJSON.getInt(jo, "childNodeCount");
        }
        
        
        /** 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;
        
            childNodeCountUpdated o = (childNodeCountUpdated) other;
        
            return
                    Objects.equals(this.nodeId, o.nodeId)
                &&  (this.childNodeCount == o.childNodeCount);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.nodeId
                +   this.childNodeCount;
        }
    }
    
    /** Mirrors <CODE>DOMNodeInserted</CODE> event. */
    public static class childNodeInserted
        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, }; }
        
        /** Id of the node that has changed. */
        public final int parentNodeId;
        
        /** If of the previous siblint. */
        public final int previousNodeId;
        
        /** Inserted node data. */
        public final DOM.Node node;
        
        /**
         * Constructor
         *
         * @param parentNodeId Id of the node that has changed.
         * 
         * @param previousNodeId If of the previous siblint.
         * 
         * @param node Inserted node data.
         */
        public childNodeInserted(int parentNodeId, int previousNodeId, DOM.Node node)
        {
            super("DOM", "childNodeInserted", 3);
            
            // 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 (node == null) BRDPC.throwNPE("node");
            
            this.parentNodeId    = parentNodeId;
            this.previousNodeId  = previousNodeId;
            this.node            = node;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'childNodeInserted'}.
         */
        public childNodeInserted (JsonObject jo)
        {
            super("DOM", "childNodeInserted", 3);
        
            this.parentNodeId    = ReadPrimJSON.getInt(jo, "parentNodeId");
            this.previousNodeId  = ReadPrimJSON.getInt(jo, "previousNodeId");
            this.node            = ReadJSON.getObject(jo, "node", DOM.Node.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;
        
            childNodeInserted o = (childNodeInserted) other;
        
            return
                    Objects.equals(this.parentNodeId, o.parentNodeId)
                &&  Objects.equals(this.previousNodeId, o.previousNodeId)
                &&  Objects.equals(this.node, o.node);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.parentNodeId
                +   this.previousNodeId
                +   this.node.hashCode();
        }
    }
    
    /** Mirrors <CODE>DOMNodeRemoved</CODE> event. */
    public static class childNodeRemoved
        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, }; }
        
        /** Parent id. */
        public final int parentNodeId;
        
        /** Id of the node that has been removed. */
        public final int nodeId;
        
        /**
         * Constructor
         *
         * @param parentNodeId Parent id.
         * 
         * @param nodeId Id of the node that has been removed.
         */
        public childNodeRemoved(int parentNodeId, int nodeId)
        {
            super("DOM", "childNodeRemoved", 2);
            
            this.parentNodeId  = parentNodeId;
            this.nodeId        = nodeId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'childNodeRemoved'}.
         */
        public childNodeRemoved (JsonObject jo)
        {
            super("DOM", "childNodeRemoved", 2);
        
            this.parentNodeId  = ReadPrimJSON.getInt(jo, "parentNodeId");
            this.nodeId        = ReadPrimJSON.getInt(jo, "nodeId");
        }
        
        
        /** 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;
        
            childNodeRemoved o = (childNodeRemoved) other;
        
            return
                    Objects.equals(this.parentNodeId, o.parentNodeId)
                &&  Objects.equals(this.nodeId, o.nodeId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.parentNodeId
                +   this.nodeId;
        }
    }
    
    /**
     * Called when distribution is changed.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class distributedNodesUpdated
        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, }; }
        
        /** Insertion point where distributed nodes were updated. */
        public final int insertionPointId;
        
        /** Distributed nodes for given insertion point. */
        public final DOM.BackendNode[] distributedNodes;
        
        /**
         * Constructor
         *
         * @param insertionPointId Insertion point where distributed nodes were updated.
         * 
         * @param distributedNodes Distributed nodes for given insertion point.
         */
        public distributedNodesUpdated(int insertionPointId, DOM.BackendNode[] distributedNodes)
        {
            super("DOM", "distributedNodesUpdated", 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 (distributedNodes == null) BRDPC.throwNPE("distributedNodes");
            
            this.insertionPointId  = insertionPointId;
            this.distributedNodes  = distributedNodes;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'distributedNodesUpdated'}.
         */
        public distributedNodesUpdated (JsonObject jo)
        {
            super("DOM", "distributedNodesUpdated", 2);
        
            this.insertionPointId  = ReadPrimJSON.getInt(jo, "insertionPointId");
            this.distributedNodes = (jo.getJsonArray("distributedNodes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("distributedNodes"), null, 0, DOM.BackendNode[].class);
        
        }
        
        
        /** 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;
        
            distributedNodesUpdated o = (distributedNodesUpdated) other;
        
            return
                    Objects.equals(this.insertionPointId, o.insertionPointId)
                &&  Arrays.deepEquals(this.distributedNodes, o.distributedNodes);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.insertionPointId
                +   Arrays.deepHashCode(this.distributedNodes);
        }
    }
    
    /**
     * Fired when <CODE>Element</CODE>'s inline style is modified via a CSS property modification.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class inlineStyleInvalidated
        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, }; }
        
        /** Ids of the nodes for which the inline styles have been invalidated. */
        public final int[] nodeIds;
        
        /**
         * Constructor
         *
         * @param nodeIds Ids of the nodes for which the inline styles have been invalidated.
         */
        public inlineStyleInvalidated(int[] nodeIds)
        {
            super("DOM", "inlineStyleInvalidated", 1);
            
            // 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 (nodeIds == null) BRDPC.throwNPE("nodeIds");
            
            this.nodeIds  = nodeIds;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'inlineStyleInvalidated'}.
         */
        public inlineStyleInvalidated (JsonObject jo)
        {
            super("DOM", "inlineStyleInvalidated", 1);
        
            this.nodeIds = (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].class);
        
        }
        
        
        /** 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;
        
            inlineStyleInvalidated o = (inlineStyleInvalidated) other;
        
            return
                    Arrays.equals(this.nodeIds, o.nodeIds);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.hashCode(this.nodeIds);
        }
    }
    
    /**
     * Called when a pseudo element is added to an element.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class pseudoElementAdded
        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, }; }
        
        /** Pseudo element's parent element id. */
        public final int parentId;
        
        /** The added pseudo element. */
        public final DOM.Node pseudoElement;
        
        /**
         * Constructor
         *
         * @param parentId Pseudo element's parent element id.
         * 
         * @param pseudoElement The added pseudo element.
         */
        public pseudoElementAdded(int parentId, DOM.Node pseudoElement)
        {
            super("DOM", "pseudoElementAdded", 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 (pseudoElement == null) BRDPC.throwNPE("pseudoElement");
            
            this.parentId       = parentId;
            this.pseudoElement  = pseudoElement;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'pseudoElementAdded'}.
         */
        public pseudoElementAdded (JsonObject jo)
        {
            super("DOM", "pseudoElementAdded", 2);
        
            this.parentId       = ReadPrimJSON.getInt(jo, "parentId");
            this.pseudoElement  = ReadJSON.getObject(jo, "pseudoElement", DOM.Node.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;
        
            pseudoElementAdded o = (pseudoElementAdded) other;
        
            return
                    Objects.equals(this.parentId, o.parentId)
                &&  Objects.equals(this.pseudoElement, o.pseudoElement);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.parentId
                +   this.pseudoElement.hashCode();
        }
    }
    
    /**
     * Called when a pseudo element is removed from an element.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class pseudoElementRemoved
        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, }; }
        
        /** Pseudo element's parent element id. */
        public final int parentId;
        
        /** The removed pseudo element id. */
        public final int pseudoElementId;
        
        /**
         * Constructor
         *
         * @param parentId Pseudo element's parent element id.
         * 
         * @param pseudoElementId The removed pseudo element id.
         */
        public pseudoElementRemoved(int parentId, int pseudoElementId)
        {
            super("DOM", "pseudoElementRemoved", 2);
            
            this.parentId         = parentId;
            this.pseudoElementId  = pseudoElementId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'pseudoElementRemoved'}.
         */
        public pseudoElementRemoved (JsonObject jo)
        {
            super("DOM", "pseudoElementRemoved", 2);
        
            this.parentId         = ReadPrimJSON.getInt(jo, "parentId");
            this.pseudoElementId  = ReadPrimJSON.getInt(jo, "pseudoElementId");
        }
        
        
        /** 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;
        
            pseudoElementRemoved o = (pseudoElementRemoved) other;
        
            return
                    Objects.equals(this.parentId, o.parentId)
                &&  Objects.equals(this.pseudoElementId, o.pseudoElementId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.parentId
                +   this.pseudoElementId;
        }
    }
    
    /**
     * Fired when backend wants to provide client with the missing DOM structure. This happens upon
     * most of the calls requesting node ids.
     */
    public static class setChildNodes
        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, }; }
        
        /** Parent node id to populate with children. */
        public final int parentId;
        
        /** Child nodes array. */
        public final DOM.Node[] nodes;
        
        /**
         * Constructor
         *
         * @param parentId Parent node id to populate with children.
         * 
         * @param nodes Child nodes array.
         */
        public setChildNodes(int parentId, DOM.Node[] nodes)
        {
            super("DOM", "setChildNodes", 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 (nodes == null) BRDPC.throwNPE("nodes");
            
            this.parentId  = parentId;
            this.nodes     = nodes;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'setChildNodes'}.
         */
        public setChildNodes (JsonObject jo)
        {
            super("DOM", "setChildNodes", 2);
        
            this.parentId  = ReadPrimJSON.getInt(jo, "parentId");
            this.nodes = (jo.getJsonArray("nodes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("nodes"), null, 0, DOM.Node[].class);
        
        }
        
        
        /** 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;
        
            setChildNodes o = (setChildNodes) other;
        
            return
                    Objects.equals(this.parentId, o.parentId)
                &&  Arrays.deepEquals(this.nodes, o.nodes);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.parentId
                +   Arrays.deepHashCode(this.nodes);
        }
    }
    
    /**
     * Called when shadow root is popped from the element.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class shadowRootPopped
        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, }; }
        
        /** Host element id. */
        public final int hostId;
        
        /** Shadow root id. */
        public final int rootId;
        
        /**
         * Constructor
         *
         * @param hostId Host element id.
         * 
         * @param rootId Shadow root id.
         */
        public shadowRootPopped(int hostId, int rootId)
        {
            super("DOM", "shadowRootPopped", 2);
            
            this.hostId  = hostId;
            this.rootId  = rootId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'shadowRootPopped'}.
         */
        public shadowRootPopped (JsonObject jo)
        {
            super("DOM", "shadowRootPopped", 2);
        
            this.hostId  = ReadPrimJSON.getInt(jo, "hostId");
            this.rootId  = ReadPrimJSON.getInt(jo, "rootId");
        }
        
        
        /** 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;
        
            shadowRootPopped o = (shadowRootPopped) other;
        
            return
                    Objects.equals(this.hostId, o.hostId)
                &&  Objects.equals(this.rootId, o.rootId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.hostId
                +   this.rootId;
        }
    }
    
    /**
     * Called when shadow root is pushed into the element.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class shadowRootPushed
        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, }; }
        
        /** Host element id. */
        public final int hostId;
        
        /** Shadow root. */
        public final DOM.Node root;
        
        /**
         * Constructor
         *
         * @param hostId Host element id.
         * 
         * @param root Shadow root.
         */
        public shadowRootPushed(int hostId, DOM.Node root)
        {
            super("DOM", "shadowRootPushed", 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 (root == null) BRDPC.throwNPE("root");
            
            this.hostId  = hostId;
            this.root    = root;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'shadowRootPushed'}.
         */
        public shadowRootPushed (JsonObject jo)
        {
            super("DOM", "shadowRootPushed", 2);
        
            this.hostId  = ReadPrimJSON.getInt(jo, "hostId");
            this.root    = ReadJSON.getObject(jo, "root", DOM.Node.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;
        
            shadowRootPushed o = (shadowRootPushed) other;
        
            return
                    Objects.equals(this.hostId, o.hostId)
                &&  Objects.equals(this.root, o.root);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.hostId
                +   this.root.hashCode();
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Collects class names for the node with given id and all of it's child nodes.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Id of the node to collect class names.
     * 
     * @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>classNames</B></CODE>)
     *     <BR />Class name list.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String[]> collectClassNamesFromSubtree(int nodeId)
    {
        final int       webSocketID = 15000000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("collectClassNamesFromSubtree"),
            parameterNames.get("collectClassNamesFromSubtree"),
            optionals, webSocketID,
            "DOM.collectClassNamesFromSubtree",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String[]'
        Function<JsonObject, String[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("classNames") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("classNames"), null, 0, String[].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);
    }
    
    /**
     * Creates a deep copy of the specified node and places it into the target container before the
     * given anchor.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Id of the node to copy.
     * 
     * @param targetNodeId Id of the element to drop the copy into.
     * 
     * @param insertBeforeNodeId 
     * Drop the copy before this node (if absent, the copy becomes the last child of
     * <CODE>targetNodeId</CODE>).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />Id of the node clone.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> copyTo
        (int nodeId, int targetNodeId, Integer insertBeforeNodeId)
    {
        final int       webSocketID = 15001000 + 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("copyTo"),
            parameterNames.get("copyTo"),
            optionals, webSocketID,
            "DOM.copyTo",
            nodeId, targetNodeId, insertBeforeNodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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);
    }
    
    /**
     * Describes node given its id, does not require domain to be enabled. Does not start tracking any
     * objects, can be used for automation.
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param depth 
     * The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
     * entire subtree or provide an integer larger than 0.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param pierce 
     * Whether or not iframes and shadow roots should be traversed when returning the subtree
     * (default is false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link DOM.Node}&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 DOM.Node}&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 DOM.Node} (<B>node</B></CODE>)
     *     <BR />Node description.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, DOM.Node> describeNode
        (Integer nodeId, Integer backendNodeId, String objectId, Integer depth, Boolean pierce)
    {
        final int       webSocketID = 15002000 + counter++;
        final boolean[] optionals   = { true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("describeNode"),
            parameterNames.get("describeNode"),
            optionals, webSocketID,
            "DOM.describeNode",
            nodeId, backendNodeId, objectId, depth, pierce
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'DOM.Node'
        Function<JsonObject, DOM.Node> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "node", DOM.Node.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);
    }
    
    /**
     * Scrolls the specified rect of the given node into view if not already visible.
     * Note: exactly one between nodeId, backendNodeId and objectId should be passed
     * to identify the node.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param rect 
     * The rect to be scrolled into view, relative to the node's border box, in CSS pixels.
     * When omitted, center of the node will be used, similar to Element.scrollIntoView.
     * <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> scrollIntoViewIfNeeded
        (Integer nodeId, Integer backendNodeId, String objectId, DOM.Rect rect)
    {
        final int       webSocketID = 15003000 + counter++;
        final boolean[] optionals   = { true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("scrollIntoViewIfNeeded"),
            parameterNames.get("scrollIntoViewIfNeeded"),
            optionals, webSocketID,
            "DOM.scrollIntoViewIfNeeded",
            nodeId, backendNodeId, objectId, rect
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Disables DOM agent for the 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 = 15004000 + 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,
            "DOM.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Discards search results from the session with the given id. <CODE>getSearchResults</CODE> should no longer
     * be called for that search.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param searchId Unique search session identifier.
     * 
     * @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> discardSearchResults(String searchId)
    {
        // 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 (searchId == null) BRDPC.throwNPE("searchId");
        
        final int       webSocketID = 15005000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("discardSearchResults"),
            parameterNames.get("discardSearchResults"),
            optionals, webSocketID,
            "DOM.discardSearchResults",
            searchId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables DOM agent for the 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> enable()
    {
        final int          webSocketID = 15006000 + 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("enable"),
            parameterNames.get("enable"),
            optionals, webSocketID,
            "DOM.enable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Focuses the given element.
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <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> focus
        (Integer nodeId, Integer backendNodeId, String objectId)
    {
        final int       webSocketID = 15007000 + counter++;
        final boolean[] optionals   = { true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("focus"),
            parameterNames.get("focus"),
            optionals, webSocketID,
            "DOM.focus",
            nodeId, backendNodeId, objectId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Returns attributes for the specified node.
     * 
     * @param nodeId Id of the node to retrieve attibutes 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>attributes</B></CODE>)
     *     <BR />An interleaved array of node attribute names and values.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String[]> getAttributes(int nodeId)
    {
        final int       webSocketID = 15008000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getAttributes"),
            parameterNames.get("getAttributes"),
            optionals, webSocketID,
            "DOM.getAttributes",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String[]'
        Function<JsonObject, String[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("attributes") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("attributes"), null, 0, String[].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 boxes for the given node.
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link DOM.BoxModel}&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 DOM.BoxModel}&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 DOM.BoxModel} (<B>model</B></CODE>)
     *     <BR />Box model for the node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, DOM.BoxModel> getBoxModel
        (Integer nodeId, Integer backendNodeId, String objectId)
    {
        final int       webSocketID = 15009000 + counter++;
        final boolean[] optionals   = { true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getBoxModel"),
            parameterNames.get("getBoxModel"),
            optionals, webSocketID,
            "DOM.getBoxModel",
            nodeId, backendNodeId, objectId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'DOM.BoxModel'
        Function<JsonObject, DOM.BoxModel> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "model", DOM.BoxModel.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);
    }
    
    /**
     * Returns quads that describe node position on the page. This method
     * might return multiple quads for inline nodes.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Number[][]&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,
     * Number[][]&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>Number[][] (<B>quads</B></CODE>)
     *     <BR />Quads that describe node layout relative to viewport.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Number[][]> getContentQuads
        (Integer nodeId, Integer backendNodeId, String objectId)
    {
        final int       webSocketID = 15010000 + counter++;
        final boolean[] optionals   = { true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getContentQuads"),
            parameterNames.get("getContentQuads"),
            optionals, webSocketID,
            "DOM.getContentQuads",
            nodeId, backendNodeId, objectId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Number[][]'
        Function<JsonObject, Number[][]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("quads") == null)
                ? null
                : ReadArrJSON.DimN.arrNumber(jo.getJsonArray("quads"), -1, 0, null, Number[][].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 the root DOM node (and optionally the subtree) to the caller.
     * 
     * @param depth 
     * The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
     * entire subtree or provide an integer larger than 0.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param pierce 
     * Whether or not iframes and shadow roots should be traversed when returning the subtree
     * (default is false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link DOM.Node}&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 DOM.Node}&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 DOM.Node} (<B>root</B></CODE>)
     *     <BR />Resulting node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, DOM.Node> getDocument
        (Integer depth, Boolean pierce)
    {
        final int       webSocketID = 15011000 + 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("getDocument"),
            parameterNames.get("getDocument"),
            optionals, webSocketID,
            "DOM.getDocument",
            depth, pierce
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'DOM.Node'
        Function<JsonObject, DOM.Node> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "root", DOM.Node.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);
    }
    
    /**
     * Returns the root DOM node (and optionally the subtree) to the caller.
     * Deprecated, as it is not designed to work well with the rest of the DOM agent.
     * Use DOMSnapshot.captureSnapshot instead.
     * <BR /><B>DEPRECATED</B>
     * 
     * @param depth 
     * The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
     * entire subtree or provide an integer larger than 0.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param pierce 
     * Whether or not iframes and shadow roots should be traversed when returning the subtree
     * (default is false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link DOM.Node}[]&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 DOM.Node}[]&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 DOM.Node}[] (<B>nodes</B></CODE>)
     *     <BR />Resulting node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, DOM.Node[]> getFlattenedDocument
        (Integer depth, Boolean pierce)
    {
        final int       webSocketID = 15012000 + 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("getFlattenedDocument"),
            parameterNames.get("getFlattenedDocument"),
            optionals, webSocketID,
            "DOM.getFlattenedDocument",
            depth, pierce
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'DOM.Node[]'
        Function<JsonObject, DOM.Node[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodes") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("nodes"), null, 0, DOM.Node[].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);
    }
    
    /**
     * Finds nodes with a given computed style in a subtree.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Node ID pointing to the root of a subtree.
     * 
     * @param computedStyles The style to filter nodes by (includes nodes if any of properties matches).
     * 
     * @param pierce 
     * Whether or not iframes and shadow roots in the same target should be traversed when returning the
     * results (default is false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * int[]&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,
     * int[]&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>int[] (<B>nodeIds</B></CODE>)
     *     <BR />Resulting nodes.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, int[]> getNodesForSubtreeByStyle
        (int nodeId, DOM.CSSComputedStyleProperty[] computedStyles, Boolean pierce)
    {
        // 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 (computedStyles == null) BRDPC.throwNPE("computedStyles");
        
        final int       webSocketID = 15013000 + 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("getNodesForSubtreeByStyle"),
            parameterNames.get("getNodesForSubtreeByStyle"),
            optionals, webSocketID,
            "DOM.getNodesForSubtreeByStyle",
            nodeId, computedStyles, pierce
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'int[]'
        Function<JsonObject, int[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].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 node id at given location. Depending on whether DOM domain is enabled, nodeId is
     * either returned or not.
     * 
     * @param x X coordinate.
     * 
     * @param y Y coordinate.
     * 
     * @param includeUserAgentShadowDOM False to skip to the nearest non-UA shadow root ancestor (default: false).
     * <BR /><B>OPTIONAL</B>
     * 
     * @param ignorePointerEventsNone Whether to ignore pointer-events: none on elements and hit test them.
     * <BR /><B>OPTIONAL</B>
     * 
     * @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> Integer (<B>backendNodeId</B>)</CODE>
     *     <BR />Resulting node.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.b:</B> String (<B>frameId</B>)</CODE>
     *     <BR />Frame this node belongs to.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret3.c:</B> Integer (<B>nodeId</B>)</CODE>
     *     <BR />Id of the node at given coordinates, only when enabled and requested document.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret3<Integer, String, Integer>> getNodeForLocation
        (int x, int y, Boolean includeUserAgentShadowDOM, Boolean ignorePointerEventsNone)
    {
        final int       webSocketID = 15014000 + 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("getNodeForLocation"),
            parameterNames.get("getNodeForLocation"),
            optionals, webSocketID,
            "DOM.getNodeForLocation",
            x, y, includeUserAgentShadowDOM, ignorePointerEventsNone
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret3'
        Function<JsonObject, Ret3<Integer, String, Integer>> 
            responseProcessor = (JsonObject jo) -> new Ret3<>(
                ReadBoxedJSON.getInteger(jo, "backendNodeId", true),
                ReadJSON.getString(jo, "frameId", false, true),
                ReadBoxedJSON.getInteger(jo, "nodeId", 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 node's HTML markup.
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <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>outerHTML</B></CODE>)
     *     <BR />Outer HTML markup.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> getOuterHTML
        (Integer nodeId, Integer backendNodeId, String objectId)
    {
        final int       webSocketID = 15015000 + counter++;
        final boolean[] optionals   = { true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getOuterHTML"),
            parameterNames.get("getOuterHTML"),
            optionals, webSocketID,
            "DOM.getOuterHTML",
            nodeId, backendNodeId, objectId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "outerHTML", 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 the id of the nearest ancestor that is a relayout boundary.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Id of the node.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />Relayout boundary node id for the given node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> getRelayoutBoundary(int nodeId)
    {
        final int       webSocketID = 15016000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getRelayoutBoundary"),
            parameterNames.get("getRelayoutBoundary"),
            optionals, webSocketID,
            "DOM.getRelayoutBoundary",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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 search results from given <CODE>fromIndex</CODE> to given <CODE>toIndex</CODE> from the search with the given
     * identifier.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param searchId Unique search session identifier.
     * 
     * @param fromIndex Start index of the search result to be returned.
     * 
     * @param toIndex End index of the search result to be returned.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * int[]&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,
     * int[]&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>int[] (<B>nodeIds</B></CODE>)
     *     <BR />Ids of the search result nodes.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, int[]> getSearchResults
        (String searchId, int fromIndex, int toIndex)
    {
        // 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 (searchId == null) BRDPC.throwNPE("searchId");
        
        final int       webSocketID = 15017000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getSearchResults"),
            parameterNames.get("getSearchResults"),
            optionals, webSocketID,
            "DOM.getSearchResults",
            searchId, fromIndex, toIndex
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'int[]'
        Function<JsonObject, int[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].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);
    }
    
    /**
     * Hides any highlight.
     * 
     * @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> hideHighlight()
    {
        final int          webSocketID = 15018000 + 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("hideHighlight"),
            parameterNames.get("hideHighlight"),
            optionals, webSocketID,
            "DOM.hideHighlight"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Highlights DOM node.
     * 
     * @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> highlightNode()
    {
        final int          webSocketID = 15019000 + 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("highlightNode"),
            parameterNames.get("highlightNode"),
            optionals, webSocketID,
            "DOM.highlightNode"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Highlights given rectangle.
     * 
     * @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> highlightRect()
    {
        final int          webSocketID = 15020000 + 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("highlightRect"),
            parameterNames.get("highlightRect"),
            optionals, webSocketID,
            "DOM.highlightRect"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Marks last undoable state.
     * <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> markUndoableState()
    {
        final int          webSocketID = 15021000 + 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("markUndoableState"),
            parameterNames.get("markUndoableState"),
            optionals, webSocketID,
            "DOM.markUndoableState"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Moves node into the new container, places it before the given anchor.
     * 
     * @param nodeId Id of the node to move.
     * 
     * @param targetNodeId Id of the element to drop the moved node into.
     * 
     * @param insertBeforeNodeId 
     * Drop node before this one (if absent, the moved node becomes the last child of
     * <CODE>targetNodeId</CODE>).
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />New id of the moved node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> moveTo
        (int nodeId, int targetNodeId, Integer insertBeforeNodeId)
    {
        final int       webSocketID = 15022000 + 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("moveTo"),
            parameterNames.get("moveTo"),
            optionals, webSocketID,
            "DOM.moveTo",
            nodeId, targetNodeId, insertBeforeNodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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);
    }
    
    /**
     * Searches for a given string in the DOM tree. Use <CODE>getSearchResults</CODE> to access search results or
     * <CODE>cancelSearch</CODE> to end this search session.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param query Plain text or query selector or XPath search query.
     * 
     * @param includeUserAgentShadowDOM True to search in user agent shadow DOM.
     * <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>searchId</B>)</CODE>
     *     <BR />Unique search session identifier.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> Integer (<B>resultCount</B>)</CODE>
     *     <BR />Number of search results.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<String, Integer>> performSearch
        (String query, Boolean includeUserAgentShadowDOM)
    {
        // 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 (query == null) BRDPC.throwNPE("query");
        
        final int       webSocketID = 15023000 + 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("performSearch"),
            parameterNames.get("performSearch"),
            optionals, webSocketID,
            "DOM.performSearch",
            query, includeUserAgentShadowDOM
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<String, Integer>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadJSON.getString(jo, "searchId", false, true),
                ReadBoxedJSON.getInteger(jo, "resultCount", 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);
    }
    
    /**
     * Requests that the node is sent to the caller given its path. // FIXME, use XPath
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param path Path to node in the proprietary format.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />Id of the node for given path.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> pushNodeByPathToFrontend(String path)
    {
        // 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 (path == null) BRDPC.throwNPE("path");
        
        final int       webSocketID = 15024000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("pushNodeByPathToFrontend"),
            parameterNames.get("pushNodeByPathToFrontend"),
            optionals, webSocketID,
            "DOM.pushNodeByPathToFrontend",
            path
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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);
    }
    
    /**
     * Requests that a batch of nodes is sent to the caller given their backend node ids.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param backendNodeIds The array of backend node ids.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * int[]&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,
     * int[]&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>int[] (<B>nodeIds</B></CODE>)
     *     <BR />The array of ids of pushed nodes that correspond to the backend ids specified in
     *     backendNodeIds.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, int[]> pushNodesByBackendIdsToFrontend
        (int[] backendNodeIds)
    {
        // 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 (backendNodeIds == null) BRDPC.throwNPE("backendNodeIds");
        
        final int       webSocketID = 15025000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("pushNodesByBackendIdsToFrontend"),
            parameterNames.get("pushNodesByBackendIdsToFrontend"),
            optionals, webSocketID,
            "DOM.pushNodesByBackendIdsToFrontend",
            (Object) backendNodeIds
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'int[]'
        Function<JsonObject, int[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].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);
    }
    
    /**
     * Executes <CODE>querySelector</CODE> on a given node.
     * 
     * @param nodeId Id of the node to query upon.
     * 
     * @param selector Selector string.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />Query selector result.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> querySelector(int nodeId, String selector)
    {
        // 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 (selector == null) BRDPC.throwNPE("selector");
        
        final int       webSocketID = 15026000 + 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("querySelector"),
            parameterNames.get("querySelector"),
            optionals, webSocketID,
            "DOM.querySelector",
            nodeId, selector
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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);
    }
    
    /**
     * Executes <CODE>querySelectorAll</CODE> on a given node.
     * 
     * @param nodeId Id of the node to query upon.
     * 
     * @param selector Selector string.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * int[]&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,
     * int[]&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>int[] (<B>nodeIds</B></CODE>)
     *     <BR />Query selector result.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, int[]> querySelectorAll
        (int nodeId, String selector)
    {
        // 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 (selector == null) BRDPC.throwNPE("selector");
        
        final int       webSocketID = 15027000 + 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("querySelectorAll"),
            parameterNames.get("querySelectorAll"),
            optionals, webSocketID,
            "DOM.querySelectorAll",
            nodeId, selector
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'int[]'
        Function<JsonObject, int[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].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);
    }
    
    /**
     * Re-does the last undone action.
     * <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> redo()
    {
        final int          webSocketID = 15028000 + 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("redo"),
            parameterNames.get("redo"),
            optionals, webSocketID,
            "DOM.redo"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Removes attribute with given name from an element with given id.
     * 
     * @param nodeId Id of the element to remove attribute from.
     * 
     * @param name Name of the attribute to remove.
     * 
     * @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> removeAttribute(int nodeId, String name)
    {
        // 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 (name == null) BRDPC.throwNPE("name");
        
        final int       webSocketID = 15029000 + 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("removeAttribute"),
            parameterNames.get("removeAttribute"),
            optionals, webSocketID,
            "DOM.removeAttribute",
            nodeId, name
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Removes node with given id.
     * 
     * @param nodeId Id of the node to remove.
     * 
     * @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> removeNode(int nodeId)
    {
        final int       webSocketID = 15030000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("removeNode"),
            parameterNames.get("removeNode"),
            optionals, webSocketID,
            "DOM.removeNode",
            nodeId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Requests that children of the node with given id are returned to the caller in form of
     * <CODE>setChildNodes</CODE> events where not only immediate children are retrieved, but all children down to
     * the specified depth.
     * 
     * @param nodeId Id of the node to get children for.
     * 
     * @param depth 
     * The maximum depth at which children should be retrieved, defaults to 1. Use -1 for the
     * entire subtree or provide an integer larger than 0.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param pierce 
     * Whether or not iframes and shadow roots should be traversed when returning the sub-tree
     * (default is false).
     * <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> requestChildNodes
        (int nodeId, Integer depth, Boolean pierce)
    {
        final int       webSocketID = 15031000 + 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("requestChildNodes"),
            parameterNames.get("requestChildNodes"),
            optionals, webSocketID,
            "DOM.requestChildNodes",
            nodeId, depth, pierce
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Requests that the node is sent to the caller given the JavaScript node object reference. All
     * nodes that form the path from the node to the root are also sent to the client as a series of
     * <CODE>setChildNodes</CODE> notifications.
     * 
     * @param objectId JavaScript object id to convert into node.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />Node id for given object.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> requestNode(String objectId)
    {
        // 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 = 15032000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("requestNode"),
            parameterNames.get("requestNode"),
            optionals, webSocketID,
            "DOM.requestNode",
            objectId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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);
    }
    
    /**
     * Resolves the JavaScript node object for a given NodeId or BackendNodeId.
     * 
     * @param nodeId Id of the node to resolve.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Backend identifier of the node to resolve.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectGroup Symbolic group name that can be used to release multiple objects.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param executionContextId Execution context in which to resolve the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link RunTime.RemoteObject}&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.RemoteObject}&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.RemoteObject} (<B>object</B></CODE>)
     *     <BR />JavaScript object wrapper for given node.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, RunTime.RemoteObject> resolveNode
        (Integer nodeId, Integer backendNodeId, String objectGroup, Integer executionContextId)
    {
        final int       webSocketID = 15033000 + counter++;
        final boolean[] optionals   = { true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("resolveNode"),
            parameterNames.get("resolveNode"),
            optionals, webSocketID,
            "DOM.resolveNode",
            nodeId, backendNodeId, objectGroup, executionContextId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'RunTime.RemoteObject'
        Function<JsonObject, RunTime.RemoteObject> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "object", RunTime.RemoteObject.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 attribute for an element with given id.
     * 
     * @param nodeId Id of the element to set attribute for.
     * 
     * @param name Attribute name.
     * 
     * @param value Attribute 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> setAttributeValue
        (int nodeId, String name, String value)
    {
        // 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 (name == null)  BRDPC.throwNPE("name");
        if (value == null) BRDPC.throwNPE("value");
        
        final int       webSocketID = 15034000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setAttributeValue"),
            parameterNames.get("setAttributeValue"),
            optionals, webSocketID,
            "DOM.setAttributeValue",
            nodeId, name, value
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets attributes on element with given id. This method is useful when user edits some existing
     * attribute value and types in several attribute name/value pairs.
     * 
     * @param nodeId Id of the element to set attributes for.
     * 
     * @param text Text with a number of attributes. Will parse this text using HTML parser.
     * 
     * @param name 
     * Attribute name to replace with new attributes derived from text in case text parsed
     * successfully.
     * <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> setAttributesAsText
        (int nodeId, String text, String name)
    {
        // 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 (text == null) BRDPC.throwNPE("text");
        
        final int       webSocketID = 15035000 + 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("setAttributesAsText"),
            parameterNames.get("setAttributesAsText"),
            optionals, webSocketID,
            "DOM.setAttributesAsText",
            nodeId, text, name
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets files for the given file input element.
     * 
     * @param files Array of file paths to set.
     * 
     * @param nodeId Identifier of the node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param backendNodeId Identifier of the backend node.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * <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> setFileInputFiles
        (String[] files, Integer nodeId, Integer backendNodeId, String objectId)
    {
        // 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 (files == null) BRDPC.throwNPE("files");
        
        final int       webSocketID = 15036000 + counter++;
        final boolean[] optionals   = { false, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setFileInputFiles"),
            parameterNames.get("setFileInputFiles"),
            optionals, webSocketID,
            "DOM.setFileInputFiles",
            files, nodeId, backendNodeId, objectId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets if stack traces should be captured for Nodes. See <CODE>Node.getNodeStackTraces</CODE>. Default is disabled.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param enable Enable or disable.
     * 
     * @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> setNodeStackTracesEnabled(boolean enable)
    {
        final int       webSocketID = 15037000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setNodeStackTracesEnabled"),
            parameterNames.get("setNodeStackTracesEnabled"),
            optionals, webSocketID,
            "DOM.setNodeStackTracesEnabled",
            enable
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Gets stack traces associated with a Node. As of now, only provides stack trace for Node creation.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Id of the node to get stack traces for.
     * 
     * @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>creation</B></CODE>)
     *     <BR />Creation stack trace, if available.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, RunTime.StackTrace> getNodeStackTraces(int nodeId)
    {
        final int       webSocketID = 15038000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getNodeStackTraces"),
            parameterNames.get("getNodeStackTraces"),
            optionals, webSocketID,
            "DOM.getNodeStackTraces",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'RunTime.StackTrace'
        Function<JsonObject, RunTime.StackTrace> responseProcessor = (JsonObject jo) ->
            ReadJSON.getObject(jo, "creation", RunTime.StackTrace.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 file information for the given
     * File wrapper.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param objectId JavaScript object id of the node wrapper.
     * 
     * @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>path</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String> getFileInfo(String objectId)
    {
        // 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 = 15039000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getFileInfo"),
            parameterNames.get("getFileInfo"),
            optionals, webSocketID,
            "DOM.getFileInfo",
            objectId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String'
        Function<JsonObject, String> responseProcessor = (JsonObject jo) ->
            ReadJSON.getString(jo, "path", 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);
    }
    
    /**
     * Enables console to refer to the node with given id via $x (see Command Line API for more details
     * $x functions).
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId DOM node id to be accessible by means of $x command line API.
     * 
     * @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> setInspectedNode(int nodeId)
    {
        final int       webSocketID = 15040000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setInspectedNode"),
            parameterNames.get("setInspectedNode"),
            optionals, webSocketID,
            "DOM.setInspectedNode",
            nodeId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets node name for a node with given id.
     * 
     * @param nodeId Id of the node to set name for.
     * 
     * @param name New node's name.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />New node's id.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> setNodeName(int nodeId, String name)
    {
        // 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 (name == null) BRDPC.throwNPE("name");
        
        final int       webSocketID = 15041000 + 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("setNodeName"),
            parameterNames.get("setNodeName"),
            optionals, webSocketID,
            "DOM.setNodeName",
            nodeId, name
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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 node value for a node with given id.
     * 
     * @param nodeId Id of the node to set value for.
     * 
     * @param value New node's 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> setNodeValue(int nodeId, String value)
    {
        // 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 (value == null) BRDPC.throwNPE("value");
        
        final int       webSocketID = 15042000 + 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("setNodeValue"),
            parameterNames.get("setNodeValue"),
            optionals, webSocketID,
            "DOM.setNodeValue",
            nodeId, value
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets node HTML markup, returns new node id.
     * 
     * @param nodeId Id of the node to set markup for.
     * 
     * @param outerHTML Outer HTML markup to set.
     * 
     * @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> setOuterHTML(int nodeId, String outerHTML)
    {
        // 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 (outerHTML == null) BRDPC.throwNPE("outerHTML");
        
        final int       webSocketID = 15043000 + 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("setOuterHTML"),
            parameterNames.get("setOuterHTML"),
            optionals, webSocketID,
            "DOM.setOuterHTML",
            nodeId, outerHTML
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Undoes the last performed action.
     * <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> undo()
    {
        final int          webSocketID = 15044000 + 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("undo"),
            parameterNames.get("undo"),
            optionals, webSocketID,
            "DOM.undo"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Returns iframe node that owns iframe with the given domain.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param frameId -
     * 
     * @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> Integer (<B>backendNodeId</B>)</CODE>
     *     <BR />Resulting node.
     *     <BR /><BR /></LI>
     * <LI><CODE><B>Ret2.b:</B> Integer (<B>nodeId</B>)</CODE>
     *     <BR />Id of the node at given coordinates, only when enabled and requested document.
     *     </LI>
     * </UL>
     */
    public static Script<String, JsonObject, Ret2<Integer, Integer>> getFrameOwner
        (String frameId)
    {
        // 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 (frameId == null) BRDPC.throwNPE("frameId");
        
        final int       webSocketID = 15045000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getFrameOwner"),
            parameterNames.get("getFrameOwner"),
            optionals, webSocketID,
            "DOM.getFrameOwner",
            frameId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON into Java-Type 'Ret2'
        Function<JsonObject, Ret2<Integer, Integer>> 
            responseProcessor = (JsonObject jo) -> new Ret2<>(
                ReadBoxedJSON.getInteger(jo, "backendNodeId", true),
                ReadBoxedJSON.getInteger(jo, "nodeId", 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 the container of the given node based on container query conditions.
     * If containerName is given, it will find the nearest container with a matching name;
     * otherwise it will find the nearest container regardless of its container name.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId -
     * 
     * @param containerName -
     * <BR /><B>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Integer&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,
     * Integer&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>Integer (<B>nodeId</B></CODE>)
     *     <BR />The container node for the given node, or null if not found.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Integer> getContainerForNode
        (int nodeId, String containerName)
    {
        final int       webSocketID = 15046000 + 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("getContainerForNode"),
            parameterNames.get("getContainerForNode"),
            optionals, webSocketID,
            "DOM.getContainerForNode",
            nodeId, containerName
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Integer'
        Function<JsonObject, Integer> responseProcessor = (JsonObject jo) ->
            ReadBoxedJSON.getInteger(jo, "nodeId", 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 the descendants of a container query container that have
     * container queries against this container.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param nodeId Id of the container node to find querying descendants from.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * int[]&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,
     * int[]&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>int[] (<B>nodeIds</B></CODE>)
     *     <BR />Descendant nodes with container queries against the given container.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, int[]> getQueryingDescendantsForContainer
        (int nodeId)
    {
        final int       webSocketID = 15047000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getQueryingDescendantsForContainer"),
            parameterNames.get("getQueryingDescendantsForContainer"),
            optionals, webSocketID,
            "DOM.getQueryingDescendantsForContainer",
            nodeId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'int[]'
        Function<JsonObject, int[]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("nodeIds") == null)
                ? null
                : ReadArrJSON.DimN.intArr(jo.getJsonArray("nodeIds"), -1, 0, null, int[].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);
    }
    
}