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 emulates different environments for the page.</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 Emulation
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private Emulation () { }

    // 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 : Emulation.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;

        parameterNames.put("canEmulate", EMPTY_VEC_STR);

        parameterNames.put("clearDeviceMetricsOverride", EMPTY_VEC_STR);

        parameterNames.put("clearGeolocationOverride", EMPTY_VEC_STR);

        parameterNames.put("resetPageScaleFactor", EMPTY_VEC_STR);

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

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

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

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

        v = new Vector<String>(13);
        parameterNames.put("setDeviceMetricsOverride", v);
        Collections.addAll(v, new String[]
        { "width", "height", "deviceScaleFactor", "mobile", "scale", "screenWidth", "screenHeight", "positionX", "positionY", "dontSetVisibleSize", "screenOrientation", "viewport", "displayFeature", });

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

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

        v = new Vector<String>(2);
        parameterNames.put("setEmitTouchEventsForMouse", v);
        Collections.addAll(v, new String[]
        { "enabled", "configuration", });

        v = new Vector<String>(2);
        parameterNames.put("setEmulatedMedia", v);
        Collections.addAll(v, new String[]
        { "media", "features", });

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

        v = new Vector<String>(3);
        parameterNames.put("setGeolocationOverride", v);
        Collections.addAll(v, new String[]
        { "latitude", "longitude", "accuracy", });

        v = new Vector<String>(2);
        parameterNames.put("setIdleOverride", v);
        Collections.addAll(v, new String[]
        { "isUserActive", "isScreenUnlocked", });

        parameterNames.put("clearIdleOverride", EMPTY_VEC_STR);

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

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

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

        v = new Vector<String>(2);
        parameterNames.put("setTouchEmulationEnabled", v);
        Collections.addAll(v, new String[]
        { "enabled", "maxTouchPoints", });

        v = new Vector<String>(5);
        parameterNames.put("setVirtualTimePolicy", v);
        Collections.addAll(v, new String[]
        { "policy", "budget", "maxVirtualTimeTaskStarvationCount", "waitForNavigation", "initialVirtualTime", });

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

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

        v = new Vector<String>(2);
        parameterNames.put("setVisibleSize", v);
        Collections.addAll(v, new String[]
        { "width", "height", });

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

        v = new Vector<String>(4);
        parameterNames.put("setUserAgentOverride", v);
        Collections.addAll(v, new String[]
        { "userAgent", "acceptLanguage", "platform", "userAgentMetadata", });
    }


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

    /**
     * advance: If the scheduler runs out of immediate work, the virtual time base may fast forward to
     * allow the next delayed task (if any) to run; pause: The virtual time base may not advance;
     * pauseIfNetworkFetchesPending: The virtual time base may not advance if there are any pending
     * resource fetches.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static final String[] VirtualTimePolicy =
    { "advance", "pause", "pauseIfNetworkFetchesPending", };
    
    /**
     * Enum of image types that can be disabled.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static final String[] DisabledImageType =
    { "avif", "jxl", "webp", };
    
    /** Screen orientation. */
    public static class ScreenOrientation
        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, }; }
        
        /** Orientation type. */
        public final String type;
        
        /** Orientation angle. */
        public final int angle;
        
        /**
         * Constructor
         *
         * @param type Orientation type.
         * <BR />Acceptable Values: ["portraitPrimary", "portraitSecondary", "landscapePrimary", "landscapeSecondary"]
         * 
         * @param angle Orientation angle.
         */
        public ScreenOrientation(String type, int angle)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (type == null) BRDPC.throwNPE("type");
            
            // Exception-Check(s) to ensure that if any parameters which must adhere to a
            // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
            
            BRDPC.checkIAE(
                "type", type,
                "portraitPrimary", "portraitSecondary", "landscapePrimary", "landscapeSecondary"
            );
            
            this.type   = type;
            this.angle  = angle;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'ScreenOrientation'}.
         */
        public ScreenOrientation (JsonObject jo)
        {
            this.type   = ReadJSON.getString(jo, "type", false, true);
            this.angle  = ReadPrimJSON.getInt(jo, "angle");
        }
        
        
        /** 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;
        
            ScreenOrientation o = (ScreenOrientation) other;
        
            return
                    Objects.equals(this.type, o.type)
                &&  (this.angle == o.angle);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.type)
                +   this.angle;
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class DisplayFeature
        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, }; }
        
        /** Orientation of a display feature in relation to screen */
        public final String orientation;
        
        /**
         * The offset from the screen origin in either the x (for vertical
         * orientation) or y (for horizontal orientation) direction.
         */
        public final int offset;
        
        /**
         * A display feature may mask content such that it is not physically
         * displayed - this length along with the offset describes this area.
         * A display feature that only splits content will have a 0 mask_length.
         */
        public final int maskLength;
        
        /**
         * Constructor
         *
         * @param orientation Orientation of a display feature in relation to screen
         * <BR />Acceptable Values: ["vertical", "horizontal"]
         * 
         * @param offset 
         * The offset from the screen origin in either the x (for vertical
         * orientation) or y (for horizontal orientation) direction.
         * 
         * @param maskLength 
         * A display feature may mask content such that it is not physically
         * displayed - this length along with the offset describes this area.
         * A display feature that only splits content will have a 0 mask_length.
         */
        public DisplayFeature(String orientation, int offset, int maskLength)
        {
            // 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 (orientation == null) BRDPC.throwNPE("orientation");
            
            // 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(
                "orientation", orientation,
                "vertical", "horizontal"
            );
            
            this.orientation  = orientation;
            this.offset       = offset;
            this.maskLength   = maskLength;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'DisplayFeature'}.
         */
        public DisplayFeature (JsonObject jo)
        {
            this.orientation  = ReadJSON.getString(jo, "orientation", false, true);
            this.offset       = ReadPrimJSON.getInt(jo, "offset");
            this.maskLength   = ReadPrimJSON.getInt(jo, "maskLength");
        }
        
        
        /** 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;
        
            DisplayFeature o = (DisplayFeature) other;
        
            return
                    Objects.equals(this.orientation, o.orientation)
                &&  (this.offset == o.offset)
                &&  (this.maskLength == o.maskLength);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.orientation)
                +   this.offset
                +   this.maskLength;
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class MediaFeature
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String name;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String value;
        
        /**
         * Constructor
         *
         * @param name -
         * 
         * @param value -
         */
        public MediaFeature(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 'MediaFeature'}.
         */
        public MediaFeature (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;
        
            MediaFeature o = (MediaFeature) 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);
        }
    }
    
    /**
     * Used to specify User Agent Cient Hints to emulate. See https://wicg.github.io/ua-client-hints
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class UserAgentBrandVersion
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String brand;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String version;
        
        /**
         * Constructor
         *
         * @param brand -
         * 
         * @param version -
         */
        public UserAgentBrandVersion(String brand, String version)
        {
            // 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 (brand == null)   BRDPC.throwNPE("brand");
            if (version == null) BRDPC.throwNPE("version");
            
            this.brand    = brand;
            this.version  = version;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'UserAgentBrandVersion'}.
         */
        public UserAgentBrandVersion (JsonObject jo)
        {
            this.brand    = ReadJSON.getString(jo, "brand", false, true);
            this.version  = ReadJSON.getString(jo, "version", 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;
        
            UserAgentBrandVersion o = (UserAgentBrandVersion) other;
        
            return
                    Objects.equals(this.brand, o.brand)
                &&  Objects.equals(this.version, o.version);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.brand)
                +   Objects.hashCode(this.version);
        }
    }
    
    /**
     * Used to specify User Agent Cient Hints to emulate. See https://wicg.github.io/ua-client-hints
     * Missing optional values will be filled in by the target with what it would normally use.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     */
    public static class UserAgentMetadata
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { true, true, false, false, false, false, false, }; }
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final Emulation.UserAgentBrandVersion[] brands;
        
        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR />
         * <BR /><B>OPTIONAL</B>
         */
        public final String fullVersion;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String platform;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String platformVersion;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String architecture;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String model;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final boolean mobile;
        
        /**
         * Constructor
         *
         * @param brands -
         * <BR /><B>OPTIONAL</B>
         * 
         * @param fullVersion -
         * <BR /><B>OPTIONAL</B>
         * 
         * @param platform -
         * 
         * @param platformVersion -
         * 
         * @param architecture -
         * 
         * @param model -
         * 
         * @param mobile -
         */
        public UserAgentMetadata(
                Emulation.UserAgentBrandVersion[] brands, String fullVersion, String platform, 
                String platformVersion, String architecture, String model, boolean mobile
            )
        {
            // 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 (platform == null)        BRDPC.throwNPE("platform");
            if (platformVersion == null) BRDPC.throwNPE("platformVersion");
            if (architecture == null)    BRDPC.throwNPE("architecture");
            if (model == null)           BRDPC.throwNPE("model");
            
            this.brands           = brands;
            this.fullVersion      = fullVersion;
            this.platform         = platform;
            this.platformVersion  = platformVersion;
            this.architecture     = architecture;
            this.model            = model;
            this.mobile           = mobile;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'UserAgentMetadata'}.
         */
        public UserAgentMetadata (JsonObject jo)
        {
            this.brands = (jo.getJsonArray("brands") == null)
                ? null
                : ReadArrJSON.DimN.objArr(jo.getJsonArray("brands"), null, 0, Emulation.UserAgentBrandVersion[].class);
        
            this.fullVersion      = ReadJSON.getString(jo, "fullVersion", true, false);
            this.platform         = ReadJSON.getString(jo, "platform", false, true);
            this.platformVersion  = ReadJSON.getString(jo, "platformVersion", false, true);
            this.architecture     = ReadJSON.getString(jo, "architecture", false, true);
            this.model            = ReadJSON.getString(jo, "model", false, true);
            this.mobile           = ReadPrimJSON.getBoolean(jo, "mobile");
        }
        
        
        /** 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;
        
            UserAgentMetadata o = (UserAgentMetadata) other;
        
            return
                    Arrays.deepEquals(this.brands, o.brands)
                &&  Objects.equals(this.fullVersion, o.fullVersion)
                &&  Objects.equals(this.platform, o.platform)
                &&  Objects.equals(this.platformVersion, o.platformVersion)
                &&  Objects.equals(this.architecture, o.architecture)
                &&  Objects.equals(this.model, o.model)
                &&  (this.mobile == o.mobile);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Arrays.deepHashCode(this.brands)
                +   Objects.hashCode(this.fullVersion)
                +   Objects.hashCode(this.platform)
                +   Objects.hashCode(this.platformVersion)
                +   Objects.hashCode(this.architecture)
                +   Objects.hashCode(this.model)
                +   (this.mobile ? 1 : 0);
        }
    }
    
    /**
     * Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
     * <BR />
     * <BR /><B>EXPERIMENTAL</B>
     *
     * <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 virtualTimeBudgetExpired
        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 virtualTimeBudgetExpired(JsonObject jo)
        { super("Emulation", "virtualTimeBudgetExpired", 0); }
    
        @Override
        public String toString() { return "Emulation.virtualTimeBudgetExpired Marker Event\n"; }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * Tells whether emulation is supported.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * Boolean&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,
     * Boolean&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>Boolean (<B>result</B></CODE>)
     *     <BR />True if emulation is supported.
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Boolean> canEmulate()
    {
        final int          webSocketID = 21000000 + 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("canEmulate"),
            parameterNames.get("canEmulate"),
            optionals, webSocketID,
            "Emulation.canEmulate"
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Boolean'
        Function<JsonObject, Boolean> responseProcessor = (JsonObject jo) ->
            ReadPrimJSON.getBoolean(jo, "result");
        
        // 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);
    }
    
    /**
     * Clears the overridden device metrics.
     * 
     * @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> clearDeviceMetricsOverride()
    {
        final int          webSocketID = 21001000 + 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("clearDeviceMetricsOverride"),
            parameterNames.get("clearDeviceMetricsOverride"),
            optionals, webSocketID,
            "Emulation.clearDeviceMetricsOverride"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Clears the overridden Geolocation Position and Error.
     * 
     * @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> clearGeolocationOverride()
    {
        final int          webSocketID = 21002000 + 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("clearGeolocationOverride"),
            parameterNames.get("clearGeolocationOverride"),
            optionals, webSocketID,
            "Emulation.clearGeolocationOverride"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Requests that page scale factor is reset to initial values.
     * <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> resetPageScaleFactor()
    {
        final int          webSocketID = 21003000 + 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("resetPageScaleFactor"),
            parameterNames.get("resetPageScaleFactor"),
            optionals, webSocketID,
            "Emulation.resetPageScaleFactor"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables or disables simulating a focused and active page.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param enabled Whether to enable to disable focus emulation.
     * 
     * @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> setFocusEmulationEnabled(boolean enabled)
    {
        final int       webSocketID = 21004000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setFocusEmulationEnabled"),
            parameterNames.get("setFocusEmulationEnabled"),
            optionals, webSocketID,
            "Emulation.setFocusEmulationEnabled",
            enabled
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Automatically render all web contents using a dark theme.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param enabled 
     * Whether to enable or disable automatic dark mode.
     * If not specified, any existing override will be cleared.
     * <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> setAutoDarkModeOverride(Boolean enabled)
    {
        final int       webSocketID = 21005000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setAutoDarkModeOverride"),
            parameterNames.get("setAutoDarkModeOverride"),
            optionals, webSocketID,
            "Emulation.setAutoDarkModeOverride",
            enabled
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables CPU throttling to emulate slow CPUs.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param rate Throttling rate as a slowdown factor (1 is no throttle, 2 is 2x slowdown, etc).
     * 
     * @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> setCPUThrottlingRate(Number rate)
    {
        // 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 (rate == null) BRDPC.throwNPE("rate");
        
        final int       webSocketID = 21006000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setCPUThrottlingRate"),
            parameterNames.get("setCPUThrottlingRate"),
            optionals, webSocketID,
            "Emulation.setCPUThrottlingRate",
            rate
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets or clears an override of the default background color of the frame. This override is used
     * if the content does not specify one.
     * 
     * @param color 
     * RGBA of the default background color. If not specified, any existing override will be
     * cleared.
     * <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> setDefaultBackgroundColorOverride
        (DOM.RGBA color)
    {
        final int       webSocketID = 21007000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setDefaultBackgroundColorOverride"),
            parameterNames.get("setDefaultBackgroundColorOverride"),
            optionals, webSocketID,
            "Emulation.setDefaultBackgroundColorOverride",
            color
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
     * window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
     * query results).
     * 
     * @param width Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
     * 
     * @param height Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.
     * 
     * @param deviceScaleFactor Overriding device scale factor value. 0 disables the override.
     * 
     * @param mobile 
     * Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text
     * autosizing and more.
     * 
     * @param scale Scale to apply to resulting view image.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param screenWidth Overriding screen width value in pixels (minimum 0, maximum 10000000).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param screenHeight Overriding screen height value in pixels (minimum 0, maximum 10000000).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param positionX Overriding view X position on screen in pixels (minimum 0, maximum 10000000).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param positionY Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param dontSetVisibleSize Do not set visible view size, rely upon explicit setVisibleSize call.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param screenOrientation Screen orientation override.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param viewport 
     * If set, the visible area of the page will be overridden to this viewport. This viewport
     * change is not observed by the page, e.g. viewport-relative elements do not change positions.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param displayFeature 
     * If set, the display feature of a multi-segment screen. If not set, multi-segment support
     * is turned-off.
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setDeviceMetricsOverride(
            int width, int height, Number deviceScaleFactor, boolean mobile, Number scale, 
            Integer screenWidth, Integer screenHeight, Integer positionX, Integer positionY, 
            Boolean dontSetVisibleSize, Emulation.ScreenOrientation screenOrientation, 
            Page.Viewport viewport, Emulation.DisplayFeature displayFeature
        )
    {
        // 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 (deviceScaleFactor == null) BRDPC.throwNPE("deviceScaleFactor");
        
        final int       webSocketID = 21008000 + counter++;
        final boolean[] optionals   = { false, false, false, false, true, true, true, true, true, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setDeviceMetricsOverride"),
            parameterNames.get("setDeviceMetricsOverride"),
            optionals, webSocketID,
            "Emulation.setDeviceMetricsOverride",
            width, height, deviceScaleFactor, mobile, scale, screenWidth, screenHeight, positionX,
            positionY, dontSetVisibleSize, screenOrientation, viewport, displayFeature
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param hidden Whether scrollbars should be always hidden.
     * 
     * @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> setScrollbarsHidden(boolean hidden)
    {
        final int       webSocketID = 21009000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setScrollbarsHidden"),
            parameterNames.get("setScrollbarsHidden"),
            optionals, webSocketID,
            "Emulation.setScrollbarsHidden",
            hidden
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param disabled Whether document.coookie API should be disabled.
     * 
     * @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> setDocumentCookieDisabled(boolean disabled)
    {
        final int       webSocketID = 21010000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setDocumentCookieDisabled"),
            parameterNames.get("setDocumentCookieDisabled"),
            optionals, webSocketID,
            "Emulation.setDocumentCookieDisabled",
            disabled
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param enabled Whether touch emulation based on mouse input should be enabled.
     * 
     * @param configuration Touch/gesture events configuration. Default: current platform.
     * <BR />Acceptable Values: ["mobile", "desktop"]
     * <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> setEmitTouchEventsForMouse
        (boolean enabled, String configuration)
    {
        // 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(
            "configuration", configuration,
            "mobile", "desktop"
        );
        
        final int       webSocketID = 21011000 + 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("setEmitTouchEventsForMouse"),
            parameterNames.get("setEmitTouchEventsForMouse"),
            optionals, webSocketID,
            "Emulation.setEmitTouchEventsForMouse",
            enabled, configuration
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Emulates the given media type or media feature for CSS media queries.
     * 
     * @param media Media type to emulate. Empty string disables the override.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param features Media features to emulate.
     * <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> setEmulatedMedia
        (String media, Emulation.MediaFeature[] features)
    {
        final int       webSocketID = 21012000 + 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("setEmulatedMedia"),
            parameterNames.get("setEmulatedMedia"),
            optionals, webSocketID,
            "Emulation.setEmulatedMedia",
            media, features
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Emulates the given vision deficiency.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param type Vision deficiency to emulate.
     * <BR />Acceptable Values: ["none", "achromatopsia", "blurredVision", "deuteranopia", "protanopia", "tritanopia"]
     * 
     * @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> setEmulatedVisionDeficiency(String type)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (type == null) BRDPC.throwNPE("type");
        
        // Exception-Check(s) to ensure that if any parameters which must adhere to a
        // provided List of Enumerated Values, fails, then IllegalArgumentException shall throw.
        
        BRDPC.checkIAE(
            "type", type,
            "none", "achromatopsia", "blurredVision", "deuteranopia", "protanopia", "tritanopia"
        );
        
        final int       webSocketID = 21013000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setEmulatedVisionDeficiency"),
            parameterNames.get("setEmulatedVisionDeficiency"),
            optionals, webSocketID,
            "Emulation.setEmulatedVisionDeficiency",
            type
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position
     * unavailable.
     * 
     * @param latitude Mock latitude
     * <BR /><B>OPTIONAL</B>
     * 
     * @param longitude Mock longitude
     * <BR /><B>OPTIONAL</B>
     * 
     * @param accuracy Mock accuracy
     * <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> setGeolocationOverride
        (Number latitude, Number longitude, Number accuracy)
    {
        final int       webSocketID = 21014000 + 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("setGeolocationOverride"),
            parameterNames.get("setGeolocationOverride"),
            optionals, webSocketID,
            "Emulation.setGeolocationOverride",
            latitude, longitude, accuracy
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Overrides the Idle state.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param isUserActive Mock isUserActive
     * 
     * @param isScreenUnlocked Mock isScreenUnlocked
     * 
     * @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> setIdleOverride
        (boolean isUserActive, boolean isScreenUnlocked)
    {
        final int       webSocketID = 21015000 + 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("setIdleOverride"),
            parameterNames.get("setIdleOverride"),
            optionals, webSocketID,
            "Emulation.setIdleOverride",
            isUserActive, isScreenUnlocked
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Clears Idle state overrides.
     * <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> clearIdleOverride()
    {
        final int          webSocketID = 21016000 + 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("clearIdleOverride"),
            parameterNames.get("clearIdleOverride"),
            optionals, webSocketID,
            "Emulation.clearIdleOverride"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Overrides value returned by the javascript navigator object.
     * <BR /><B>EXPERIMENTAL</B>
     * <BR /><B>DEPRECATED</B>
     * 
     * @param platform The platform navigator.platform should return.
     * 
     * @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> setNavigatorOverrides(String platform)
    {
        // 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 (platform == null) BRDPC.throwNPE("platform");
        
        final int       webSocketID = 21017000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setNavigatorOverrides"),
            parameterNames.get("setNavigatorOverrides"),
            optionals, webSocketID,
            "Emulation.setNavigatorOverrides",
            platform
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Sets a specified page scale factor.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param pageScaleFactor Page scale factor.
     * 
     * @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> setPageScaleFactor(Number pageScaleFactor)
    {
        // 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 (pageScaleFactor == null) BRDPC.throwNPE("pageScaleFactor");
        
        final int       webSocketID = 21018000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setPageScaleFactor"),
            parameterNames.get("setPageScaleFactor"),
            optionals, webSocketID,
            "Emulation.setPageScaleFactor",
            pageScaleFactor
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Switches script execution in the page.
     * 
     * @param value Whether script execution should be disabled in the 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> setScriptExecutionDisabled(boolean value)
    {
        final int       webSocketID = 21019000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setScriptExecutionDisabled"),
            parameterNames.get("setScriptExecutionDisabled"),
            optionals, webSocketID,
            "Emulation.setScriptExecutionDisabled",
            value
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables touch on platforms which do not support them.
     * 
     * @param enabled Whether the touch event emulation should be enabled.
     * 
     * @param maxTouchPoints Maximum touch points supported. Defaults to one.
     * <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> setTouchEmulationEnabled
        (boolean enabled, Integer maxTouchPoints)
    {
        final int       webSocketID = 21020000 + 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("setTouchEmulationEnabled"),
            parameterNames.get("setTouchEmulationEnabled"),
            optionals, webSocketID,
            "Emulation.setTouchEmulationEnabled",
            enabled, maxTouchPoints
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets
     * the current virtual time policy.  Note this supersedes any previous time budget.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param policy -
     * 
     * @param budget 
     * If set, after this many virtual milliseconds have elapsed virtual time will be paused and a
     * virtualTimeBudgetExpired event is sent.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param maxVirtualTimeTaskStarvationCount 
     * If set this specifies the maximum number of tasks that can be run before virtual is forced
     * forwards to prevent deadlock.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param waitForNavigation 
     * If set the virtual time policy change should be deferred until any frame starts navigating.
     * Note any previous deferred policy change is superseded.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param initialVirtualTime If set, base::Time::Now will be overridden to initially return this value.
     * <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>virtualTimeTicksBase</B></CODE>)
     *     <BR />Absolute timestamp at which virtual time was first enabled (up time in milliseconds).
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, Number> setVirtualTimePolicy(
            String policy, Number budget, Integer maxVirtualTimeTaskStarvationCount, 
            Boolean waitForNavigation, Number initialVirtualTime
        )
    {
        // 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 (policy == null) BRDPC.throwNPE("policy");
        
        // 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("policy", policy, "Emulation.VirtualTimePolicy", Emulation.VirtualTimePolicy);
        
        final int       webSocketID = 21021000 + counter++;
        final boolean[] optionals   = { false, true, true, true, true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setVirtualTimePolicy"),
            parameterNames.get("setVirtualTimePolicy"),
            optionals, webSocketID,
            "Emulation.setVirtualTimePolicy",
            policy, budget, maxVirtualTimeTaskStarvationCount, waitForNavigation, initialVirtualTime
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'Number'
        Function<JsonObject, Number> responseProcessor = (JsonObject jo) ->
            ReadNumberJSON.get(jo, "virtualTimeTicksBase", 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);
    }
    
    /**
     * Overrides default host system locale with the specified one.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param locale 
     * ICU style C locale (e.g. "en_US"). If not specified or empty, disables the override and
     * restores default host system locale.
     * <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> setLocaleOverride(String locale)
    {
        final int       webSocketID = 21022000 + counter++;
        final boolean[] optionals   = { true, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setLocaleOverride"),
            parameterNames.get("setLocaleOverride"),
            optionals, webSocketID,
            "Emulation.setLocaleOverride",
            locale
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Overrides default host system timezone with the specified one.
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param timezoneId 
     * The timezone identifier. If empty, disables the override and
     * restores default host system timezone.
     * 
     * @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> setTimezoneOverride(String timezoneId)
    {
        // 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 (timezoneId == null) BRDPC.throwNPE("timezoneId");
        
        final int       webSocketID = 21023000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setTimezoneOverride"),
            parameterNames.get("setTimezoneOverride"),
            optionals, webSocketID,
            "Emulation.setTimezoneOverride",
            timezoneId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Resizes the frame/viewport of the page. Note that this does not affect the frame's container
     * (e.g. browser window). Can be used to produce screenshots of the specified size. Not supported
     * on Android.
     * <BR /><B>EXPERIMENTAL</B>
     * <BR /><B>DEPRECATED</B>
     * 
     * @param width Frame width (DIP).
     * 
     * @param height Frame height (DIP).
     * 
     * @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> setVisibleSize(int width, int height)
    {
        final int       webSocketID = 21024000 + 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("setVisibleSize"),
            parameterNames.get("setVisibleSize"),
            optionals, webSocketID,
            "Emulation.setVisibleSize",
            width, height
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @param imageTypes Image types to 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> setDisabledImageTypes(String[] imageTypes)
    {
        // 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 (imageTypes == null) BRDPC.throwNPE("imageTypes");
        
        final int       webSocketID = 21025000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setDisabledImageTypes"),
            parameterNames.get("setDisabledImageTypes"),
            optionals, webSocketID,
            "Emulation.setDisabledImageTypes",
            (Object) imageTypes
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Allows overriding user agent with the given string.
     * 
     * @param userAgent User agent to use.
     * 
     * @param acceptLanguage Browser langugage to emulate.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param platform The platform navigator.platform should return.
     * <BR /><B>OPTIONAL</B>
     * 
     * @param userAgentMetadata To be sent in Sec-CH-UA-* headers and returned in navigator.userAgentData
     * <BR /><B>OPTIONAL</B>
     * <BR /><B>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setUserAgentOverride(
            String userAgent, String acceptLanguage, String platform, 
            Emulation.UserAgentMetadata userAgentMetadata
        )
    {
        // 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 (userAgent == null) BRDPC.throwNPE("userAgent");
        
        final int       webSocketID = 21026000 + 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("setUserAgentOverride"),
            parameterNames.get("setUserAgentOverride"),
            optionals, webSocketID,
            "Emulation.setUserAgentOverride",
            userAgent, acceptLanguage, platform, userAgentMetadata
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}