package Torello.Browser.BrowserAPI;

// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// Java-HTML Imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

import Torello.Browser.*;
import Torello.Browser.helper.*;
import Torello.Browser.JavaScriptAPI.*;
import Torello.JSON.*;

import Torello.Java.ReadOnly.ReadOnlyList;
import Torello.Java.ReadOnly.ReadOnlyArrayList;

import Torello.JavaDoc.Annotations.StaticFunctional;
import Torello.JavaDoc.Annotations.JDHeaderBackgroundImg;

import Torello.Browser.BrowserAPI.NestedHelpers.Commands.Browser$$Commands;


// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
// JDK Imports
// *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***

import javax.json.JsonObject;
import javax.json.JsonValue;

/**
 * <SPAN CLASS=COPIEDJDK><B>The Browser domain defines methods and events for browser managing.</B></SPAN>
 * <EMBED CLASS='external-html' DATA-FILE-ID=CDP.CODE_GEN_NOTE>
 */
@StaticFunctional@JDHeaderBackgroundImg(EmbedTagFileID="CDP.WOOD_PLANK_NOTE")
public class Browser
{
    // No Pubic Constructors
    private Browser() { }


    // ********************************************************************************************
    // ********************************************************************************************
    // Eliminated Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>

     * <EMBED CLASS='external-html' DATA-CTAS='String' DATA-FILE-ID=CDP.EliminatedType
     *     DATA-NAME=BrowserContextID>
     */
    public static final String BrowserContextID =
        "BrowserContextID has been eliminated.\n" +
        "It was replaced with the standard Java-Type: String";

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>

     * <EMBED CLASS='external-html' DATA-CTAS='int' DATA-FILE-ID=CDP.EliminatedType
     *     DATA-NAME=WindowID>
     */
    public static final String WindowID =
        "WindowID has been eliminated.\n" +
        "It was replaced with the standard Java-Type: int";


    // ********************************************************************************************
    // ********************************************************************************************
    // Enumerated String Constants Lists
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Browser command ids used by executeBrowserCommand.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> BrowserCommandId = new ReadOnlyArrayList<>
        (String.class, "closeTabSearch", "openGlic", "openTabSearch");

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> PermissionSetting = new ReadOnlyArrayList<>
        (String.class, "denied", "granted", "prompt");

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> PermissionType = new ReadOnlyArrayList<>(
        String.class, 
        "ar", "audioCapture", "automaticFullscreen", "backgroundFetch", "backgroundSync",
        "cameraPanTiltZoom", "capturedSurfaceControl", "clipboardReadWrite",
        "clipboardSanitizedWrite", "displayCapture", "durableStorage", "geolocation",
        "handTracking", "idleDetection", "keyboardLock", "localFonts", "localNetworkAccess", "midi",
        "midiSysex", "nfc", "notifications", "paymentHandler", "periodicBackgroundSync",
        "pointerLock", "protectedMediaIdentifier", "sensors", "smartCard", "speakerSelection",
        "storageAccess", "topLevelStorageAccess", "videoCapture", "vr", "wakeLockScreen",
        "wakeLockSystem", "webAppInstallation", "webPrinting", "windowManagement"
    );

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> PrivacySandboxAPI = new ReadOnlyArrayList<>
        (String.class, "BiddingAndAuctionServices", "TrustedKeyValue");

    /**
     * The state of the browser window.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> WindowState = new ReadOnlyArrayList<>
        (String.class, "fullscreen", "maximized", "minimized", "normal");



    // ********************************************************************************************
    // ********************************************************************************************
    // Basic Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Browser window bounds information
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class Bounds
        extends BaseType<Bounds>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.Bounds> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Browser$$Bounds$$.singleton;

        /**
         * The offset from the left edge of the screen to the window in pixels.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Integer left;

        /**
         * The offset from the top edge of the screen to the window in pixels.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Integer top;

        /**
         * The window width in pixels.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Integer width;

        /**
         * The window height in pixels.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Integer height;

        /**
         * The window state. Default to normal.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         * <EMBED CLASS='external-html' DATA-D=Browser DATA-C=WindowState DATA-F=windowState DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String windowState;

        /** Constructor.  Please review this class' fields for documentation. */
        public Bounds(
                ReadOnlyList<Boolean> isPresent, Integer left, Integer top, Integer width,
                Integer height, String windowState
            )
        {
            super(singleton, Domains.Browser, "Bounds", 5);

            this.left           = left;
            this.top            = top;
            this.width          = width;
            this.height         = height;
            this.windowState    = windowState;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 5, "Browser.Bounds");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static Bounds fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<Bounds> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Chrome histogram bucket.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class Bucket
        extends BaseType<Bucket>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.Bucket> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Browser$$Bucket$$.singleton;

        /** Minimum value (inclusive). */
        public final int low;

        /** Maximum value (exclusive). */
        public final int high;

        /** Number of samples. */
        public final int count;

        /** Constructor.  Please review this class' fields for documentation. */
        public Bucket(ReadOnlyList<Boolean> isPresent, int low, int high, int count)
        {
            super(singleton, Domains.Browser, "Bucket", 3);

            this.low    = low;
            this.high   = high;
            this.count  = count;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 3, "Browser.Bucket");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static Bucket fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<Bucket> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Chrome histogram.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class Histogram
        extends BaseType<Histogram>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.Histogram> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Browser$$Histogram$$.singleton;

        /** Name. */
        public final String name;

        /** Sum of sample values. */
        public final int sum;

        /** Total number of samples. */
        public final int count;

        /** Buckets. */
        public final Browser.Bucket[] buckets;

        /** Constructor.  Please review this class' fields for documentation. */
        public Histogram
            (ReadOnlyList<Boolean> isPresent, String name, int sum, int count, Bucket[] buckets)
        {
            super(singleton, Domains.Browser, "Histogram", 4);

            this.name       = name;
            this.sum        = sum;
            this.count      = count;
            this.buckets    = buckets;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 4, "Browser.Histogram");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static Histogram fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<Histogram> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Definition of PermissionDescriptor defined in the Permissions API:
     * https://w3c.github.io/permissions/#dom-permissiondescriptor.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class PermissionDescriptor
        extends BaseType<PermissionDescriptor>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.PermissionDescriptor> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Types.
                Browser$$PermissionDescriptor$$.singleton;

        /**
         * Name of permission.
         * See https://cs.chromium.org/chromium/src/third_party/blink/renderer/modules/permissions/permission_descriptor.idl for valid permission names.
         */
        public final String name;

        /**
         * For "midi" permission, may also specify sysex control.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Boolean sysex;

        /**
         * For "push" permission, may specify userVisibleOnly.
         * Note that userVisibleOnly = true is the only currently supported type.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Boolean userVisibleOnly;

        /**
         * For "clipboard" permission, may specify allowWithoutSanitization.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Boolean allowWithoutSanitization;

        /**
         * For "fullscreen" permission, must specify allowWithoutGesture:true.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Boolean allowWithoutGesture;

        /**
         * For "camera" permission, may specify panTiltZoom.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Boolean panTiltZoom;

        /** Constructor.  Please review this class' fields for documentation. */
        public PermissionDescriptor(
                ReadOnlyList<Boolean> isPresent, String name, Boolean sysex,
                Boolean userVisibleOnly, Boolean allowWithoutSanitization,
                Boolean allowWithoutGesture, Boolean panTiltZoom
            )
        {
            super(singleton, Domains.Browser, "PermissionDescriptor", 6);

            this.name                       = name;
            this.sysex                      = sysex;
            this.userVisibleOnly            = userVisibleOnly;
            this.allowWithoutSanitization   = allowWithoutSanitization;
            this.allowWithoutGesture        = allowWithoutGesture;
            this.panTiltZoom                = panTiltZoom;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 6, "Browser.PermissionDescriptor");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static PermissionDescriptor fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<PermissionDescriptor> descriptor()
        { return singleton.descriptor(); }
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Command-Return Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Returns version information.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI DATA-CMD=getVersion>
     * @see Browser#getVersion
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_CMD_JDHBI")
    public static class getVersion$$RET
        extends BaseType<getVersion$$RET>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.getVersion$$RET> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.CmdReturns.
                Browser$$getVersion$$RET.singleton;

        /** Protocol version. */
        public final String protocolVersion;

        /** Product name. */
        public final String product;

        /** Product revision. */
        public final String revision;

        /** User-Agent. */
        public final String userAgent;

        /** V8 version. */
        public final String jsVersion;

        /** Constructor.  Please review this class' fields for documentation. */
        public getVersion$$RET(
                ReadOnlyList<Boolean> isPresent, String protocolVersion, String product,
                String revision, String userAgent, String jsVersion
            )
        {
            super(singleton, Domains.Browser, "getVersion", 5);

            this.protocolVersion    = protocolVersion;
            this.product            = product;
            this.revision           = revision;
            this.userAgent          = userAgent;
            this.jsVersion          = jsVersion;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 5, "Browser.getVersion$$RET");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static getVersion$$RET fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<getVersion$$RET> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Get the browser window that contains the devtools target.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI DATA-CMD=getWindowForTarget>
     * @see Browser#getWindowForTarget
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_CMD_JDHBI")
    public static class getWindowForTarget$$RET
        extends BaseType<getWindowForTarget$$RET>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.getWindowForTarget$$RET> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.CmdReturns.
                Browser$$getWindowForTarget$$RET.singleton;

        /** Browser window id. */
        public final int windowId;

        /**
         * Bounds information of the window. When window state is 'minimized', the restored window
         * position and size are returned.
         */
        public final Browser.Bounds bounds;

        /** Constructor.  Please review this class' fields for documentation. */
        public getWindowForTarget$$RET
            (ReadOnlyList<Boolean> isPresent, int windowId, Bounds bounds)
        {
            super(singleton, Domains.Browser, "getWindowForTarget", 2);

            this.windowId   = windowId;
            this.bounds     = bounds;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 2, "Browser.getWindowForTarget$$RET");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static getWindowForTarget$$RET fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<getWindowForTarget$$RET> descriptor()
        { return singleton.descriptor(); }
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Event Types
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Fired when download makes progress. Last call has |done| == true.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class downloadProgress
        extends BrowserEvent<downloadProgress>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.downloadProgress> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Events.
                Browser$$downloadProgress$$.singleton;

        /** Global unique identifier of the download. */
        public final String guid;

        /** Total expected bytes to download. */
        public final Number totalBytes;

        /** Total bytes received. */
        public final Number receivedBytes;

        /**
         * Download status.
         * <EMBED CLASS='external-html' DATA-D=Browser DATA-C=downloadProgress DATA-F=state DATA-FILE-ID=CDP.EL1>
         * @see BaseType#enumStrList(String)
         */
        public final String state;

        /**
         * If download is "completed", provides the path of the downloaded file.
         * Depending on the platform, it is not guaranteed to be set, nor the file
         * is guaranteed to exist.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
         */
        public final String filePath;

        /** Constructor.  Please review this class' fields for documentation. */
        public downloadProgress(
                ReadOnlyList<Boolean> isPresent, String guid, Number totalBytes,
                Number receivedBytes, String state, String filePath
            )
        {
            super(singleton, Domains.Browser, "downloadProgress", 5);

            this.guid           = guid;
            this.totalBytes     = totalBytes;
            this.receivedBytes  = receivedBytes;
            this.state          = state;
            this.filePath       = filePath;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 5, "Browser.downloadProgress");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static downloadProgress fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<downloadProgress> descriptor()
        { return singleton.descriptor(); }
    }

    /**
     * Fired when page is about to start a download.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Browser DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class downloadWillBegin
        extends BrowserEvent<downloadWillBegin>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

        private static final NestedHelper<Browser.downloadWillBegin> singleton =
            Torello.Browser.BrowserAPI.NestedHelpers.Events.
                Browser$$downloadWillBegin$$.singleton;

        /** Id of the frame that caused the download to begin. */
        public final String frameId;

        /** Global unique identifier of the download. */
        public final String guid;

        /** URL of the resource being downloaded. */
        public final String url;

        /** Suggested file name of the resource (the actual name of the file saved on disk may differ). */
        public final String suggestedFilename;

        /** Constructor.  Please review this class' fields for documentation. */
        public downloadWillBegin(
                ReadOnlyList<Boolean> isPresent, String frameId, String guid, String url,
                String suggestedFilename
            )
        {
            super(singleton, Domains.Browser, "downloadWillBegin", 4);

            this.frameId            = frameId;
            this.guid               = guid;
            this.url                = url;
            this.suggestedFilename  = suggestedFilename;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 4, "Browser.downloadWillBegin");
        }

        /** Creates an instance of this class from a {@link JsonObject}.*/
        public static downloadWillBegin fromJSON(JsonObject jo)
        { return singleton.fromJSON(jo); }

        /** Returns this class's {@link NestedDescriptor} singleton-instance. class / type.*/
        public static NestedDescriptor<downloadWillBegin> descriptor()
        { return singleton.descriptor(); }
    }




    // ********************************************************************************************
    // ********************************************************************************************
    // Commands
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Configures encryption keys used with a given privacy sandbox API to talk
     * to a trusted coordinator.  Since this is intended for test automation only,
     * coordinatorOrigin must be a .test domain. No existing coordinator
     * configuration for the origin may exist.
     * 
     * @param api -
     * 
     * @param coordinatorOrigin -
     * 
     * @param keyConfig -
     * 
     * @param browserContextId 
     * BrowserContext to perform the action in. When omitted, default browser
     * context is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> addPrivacySandboxCoordinatorKeyConfig
        (String api, String coordinatorOrigin, String keyConfig, String browserContextId)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.addPrivacySandboxCoordinatorKeyConfig$$,
            "Browser.addPrivacySandboxCoordinatorKeyConfig",
            api, coordinatorOrigin, keyConfig, browserContextId
        );

        return Script.NO_RET(Domains.Browser, "addPrivacySandboxCoordinatorKeyConfig", requestJSON);
    }

    /**
     * Allows a site to use privacy sandbox features that require enrollment
     * without the site actually being enrolled. Only supported on page targets.
     * 
     * @param url -
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> addPrivacySandboxEnrollmentOverride(String url)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "url", false, "Browser.addPrivacySandboxEnrollmentOverride", url);

        return Script.NO_RET(Domains.Browser, "addPrivacySandboxEnrollmentOverride", requestJSON);
    }

    /**
     * Cancel a download if in progress
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param guid Global unique identifier of the download.
     * 
     * @param browserContextId BrowserContext to perform the action in. When omitted, default browser context is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> cancelDownload(String guid, String browserContextId)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.cancelDownload$$, "Browser.cancelDownload",
            guid, browserContextId
        );

        return Script.NO_RET(Domains.Browser, "cancelDownload", requestJSON);
    }

    /**
     * Close browser gracefully.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> close()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Browser.close\"}";

        return Script.NO_RET(Domains.Browser, "close", requestJSON);
    }

    /**
     * Crashes browser on the main thread.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> crash()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Browser.crash\"}";

        return Script.NO_RET(Domains.Browser, "crash", requestJSON);
    }

    /**
     * Crashes GPU process.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> crashGpuProcess()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Browser.crashGpuProcess\"}";

        return Script.NO_RET(Domains.Browser, "crashGpuProcess", requestJSON);
    }

    /**
     * Invoke custom browser commands used by telemetry.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param commandId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> executeBrowserCommand(String commandId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "commandId", false, "Browser.executeBrowserCommand", commandId);

        return Script.NO_RET(Domains.Browser, "executeBrowserCommand", requestJSON);
    }

    /**
     * Returns the command line switches for the browser process if, and only if
     * --enable-automation is on the commandline.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;String[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>String[] (<B>arguments</B>)</CODE>
     * <BR />
     * Commandline parameters
     * </DIV>
     */
    public static Script<String[]> getBrowserCommandLine()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Browser.getBrowserCommandLine\"}";

        return new Script<>(
            Domains.Browser, "getBrowserCommandLine", requestJSON,
            Browser$$Commands::getBrowserCommandLine,
            String[].class
        );
    }

    /**
     * Get a Chrome histogram by name.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param name Requested histogram name.
     * 
     * @param delta If true, retrieve delta since last delta call.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link Browser.Histogram}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link Browser.Histogram}&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>{@link Browser.Histogram} (<B>histogram</B>)</CODE>
     * <BR />
     * Histogram.
     * </DIV>
     */
    public static Script<Browser.Histogram> getHistogram(String name, Boolean delta)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.getHistogram$$, "Browser.getHistogram",
            name, delta
        );

        return new Script<>(
            Domains.Browser, "getHistogram", requestJSON,
            Browser$$Commands::getHistogram,
            Browser.Histogram.class
        );
    }

    /**
     * Get Chrome histograms.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param query 
     * Requested substring in name. Only histograms which have query as a
     * substring in their name are extracted. An empty or absent query returns
     * all histograms.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param delta If true, retrieve delta since last delta call.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link Browser.Histogram}[]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link Browser.Histogram}[]&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>{@link Browser.Histogram}[] (<B>histograms</B>)</CODE>
     * <BR />
     * Histograms.
     * </DIV>
     */
    public static Script<Browser.Histogram[]> getHistograms(String query, Boolean delta)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.getHistograms$$, "Browser.getHistograms",
            query, delta
        );

        return new Script<>(
            Domains.Browser, "getHistograms", requestJSON,
            Browser$$Commands::getHistograms,
            Browser.Histogram[].class
        );
    }

    /**
     * Returns version information.
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link getVersion$$RET}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link getVersion$$RET}&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:{@link getVersion$$RET}
     * A dedicated return type implies that the browser may return more than 1 datum
     * </DIV>
     */
    public static Script<getVersion$$RET> getVersion()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Browser.getVersion\"}";

        return new Script<>(
            Domains.Browser, "getVersion", requestJSON,
            getVersion$$RET::fromJSON,
            getVersion$$RET.class
        );
    }

    /**
     * Get position and size of the browser window.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param windowId Browser window id.
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link Browser.Bounds}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link Browser.Bounds}&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>{@link Browser.Bounds} (<B>bounds</B>)</CODE>
     * <BR />
     * Bounds information of the window. When window state is 'minimized', the restored window
     *     position and size are returned.
     * </DIV>
     */
    public static Script<Browser.Bounds> getWindowBounds(int windowId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.PRIMITIVE_INT, "windowId", false, "Browser.getWindowBounds", windowId);

        return new Script<>(
            Domains.Browser, "getWindowBounds", requestJSON,
            Browser$$Commands::getWindowBounds,
            Browser.Bounds.class
        );
    }

    /**
     * Get the browser window that contains the devtools target.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param targetId Devtools agent host id. If called as a part of the session, associated targetId is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link getWindowForTarget$$RET}&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec(WebSocketSender) Script.exec}, and afterwards, a {@link Promise}
     * <CODE>&lt;{@link getWindowForTarget$$RET}&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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:{@link getWindowForTarget$$RET}
     * A dedicated return type implies that the browser may return more than 1 datum
     * </DIV>
     */
    public static Script<getWindowForTarget$$RET> getWindowForTarget(String targetId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "targetId", true, "Browser.getWindowForTarget", targetId);

        return new Script<>(
            Domains.Browser, "getWindowForTarget", requestJSON,
            getWindowForTarget$$RET::fromJSON,
            getWindowForTarget$$RET.class
        );
    }

    /**
     * Grant specific permissions to the given origin and reject all others.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param permissions -
     * 
     * @param origin Origin the permission applies to, all origins if not specified.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param browserContextId BrowserContext to override permissions. When omitted, default browser context is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> grantPermissions
        (String[] permissions, String origin, String browserContextId)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.grantPermissions$$, "Browser.grantPermissions",
            permissions, origin, browserContextId
        );

        return Script.NO_RET(Domains.Browser, "grantPermissions", requestJSON);
    }

    /**
     * Reset all permission management for all origins.
     * 
     * @param browserContextId BrowserContext to reset permissions. When omitted, default browser context is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> resetPermissions(String browserContextId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get(
            CDPTypes.STRING, "browserContextId", true, "Browser.resetPermissions",
            browserContextId
        );

        return Script.NO_RET(Domains.Browser, "resetPermissions", requestJSON);
    }

    /**
     * Set size of the browser contents resizing browser window as necessary.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param windowId Browser window id.
     * 
     * @param width 
     * The window contents width in DIP. Assumes current width if omitted.
     * Must be specified if 'height' is omitted.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param height 
     * The window contents height in DIP. Assumes current height if omitted.
     * Must be specified if 'width' is omitted.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setContentsSize(int windowId, Integer width, Integer height)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.setContentsSize$$, "Browser.setContentsSize",
            windowId, width, height
        );

        return Script.NO_RET(Domains.Browser, "setContentsSize", requestJSON);
    }

    /**
     * Set dock tile details, platform-specific.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param badgeLabel -
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param image Png encoded image. (Encoded as a base64 string when passed over JSON)
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setDockTile(String badgeLabel, String image)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.setDockTile$$, "Browser.setDockTile",
            badgeLabel, image
        );

        return Script.NO_RET(Domains.Browser, "setDockTile", requestJSON);
    }

    /**
     * Set the behavior when downloading a file.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param behavior 
     * Whether to allow all or deny all download requests, or use default Chrome behavior if
     * available (otherwise deny). |allowAndName| allows download and names files according to
     * their download guids.
     * <BR />Acceptable Values: ["allow", "allowAndName", "default", "deny"]
     * 
     * @param browserContextId BrowserContext to set download behavior. When omitted, default browser context is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param downloadPath 
     * The default path to save downloaded files to. This is required if behavior is set to 'allow'
     * or 'allowAndName'.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param eventsEnabled Whether to emit download events (defaults to false).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setDownloadBehavior
        (String behavior, String browserContextId, String downloadPath, Boolean eventsEnabled)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.setDownloadBehavior$$, "Browser.setDownloadBehavior",
            behavior, browserContextId, downloadPath, eventsEnabled
        );

        return Script.NO_RET(Domains.Browser, "setDownloadBehavior", requestJSON);
    }

    /**
     * Set permission settings for given origin.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param permission Descriptor of permission to override.
     * 
     * @param setting Setting of the permission.
     * 
     * @param origin Origin the permission applies to, all origins if not specified.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param browserContextId Context to override. When omitted, default browser context is used.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setPermission
        (PermissionDescriptor permission, String setting, String origin, String browserContextId)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.setPermission$$, "Browser.setPermission",
            permission, setting, origin, browserContextId
        );

        return Script.NO_RET(Domains.Browser, "setPermission", requestJSON);
    }

    /**
     * Set position and/or size of the browser window.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param windowId Browser window id.
     * 
     * @param bounds 
     * New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined
     * with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
     * 
     * @return An instance of <CODE>{@link Script}&lt;Void&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 /><DIV CLASS=JDHint>
     * 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 <Void>} to ensure that
     * the Browser Function has run to completion.
     * </DIV>
     */
    public static Script<Void> setWindowBounds(int windowId, Bounds bounds)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Browser$$Commands.setWindowBounds$$, "Browser.setWindowBounds",
            windowId, bounds
        );

        return Script.NO_RET(Domains.Browser, "setWindowBounds", requestJSON);
    }


}