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.Target$$Commands;


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

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

/**
 * <SPAN CLASS=COPIEDJDK><B>Supports additional targets discovery and allows to attach to them.</B></SPAN>
 * <EMBED CLASS='external-html' DATA-FILE-ID=CDP.CODE_GEN_NOTE>
 */
@StaticFunctional@JDHeaderBackgroundImg(EmbedTagFileID="CDP.WOOD_PLANK_NOTE")
public class Target
{
    // No Pubic Constructors
    private Target() { }


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


    /**
     * Unique identifier of attached debugging session.

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

    /**
     * The entries in TargetFilter are matched sequentially against targets and
     * the first entry that matches determines if the target is included or not,
     * depending on the value of <CODE>exclude</CODE> field in the entry.
     * If filter is not specified, the one assumed is
     * [{type: "browser", exclude: true}, {type: "tab", exclude: true}, {}]
     * (i.e. include everything but <CODE>browser</CODE> and <CODE>tab</CODE>).
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>

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

    /**
     * <CODE>[No Description Provided by Google]</CODE>

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


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


    /**
     * The state of the target 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
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * A filter used by target query/discovery/auto-attach operations.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class FilterEntry
        extends BaseType<FilterEntry>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /**
         * If set, causes exclusion of matching targets from the list.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Boolean exclude;

        /**
         * If not present, matches any type.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String type;

        /** Constructor.  Please review this class' fields for documentation. */
        public FilterEntry(ReadOnlyList<Boolean> isPresent, Boolean exclude, String type)
        {
            super(singleton, Domains.Target, "FilterEntry", 2);

            this.exclude    = exclude;
            this.type       = type;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 2, "Target.FilterEntry");
        }

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

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

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class RemoteLocation
        extends BaseType<RemoteLocation>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String host;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final int port;

        /** Constructor.  Please review this class' fields for documentation. */
        public RemoteLocation(ReadOnlyList<Boolean> isPresent, String host, int port)
        {
            super(singleton, Domains.Target, "RemoteLocation", 2);

            this.host = host;
            this.port = port;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 2, "Target.RemoteLocation");
        }

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

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

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class TargetInfo
        extends BaseType<TargetInfo>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String targetId;

        /** List of types: https://source.chromium.org/chromium/chromium/src/+/main:content/browser/devtools/devtools_agent_host_impl.cc?ss=chromium&amp;q=f:devtools%20-f:out%20%22::kTypeTab%5B%5D%22 */
        public final String type;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String title;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String url;

        /** Whether the target has an attached client. */
        public final boolean attached;

        /**
         * Opener target Id
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String openerId;

        /**
         * Whether the target has access to the originating window.
         * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
         */
        public final boolean canAccessOpener;

        /**
         * Frame id of originating window (is only set if target has an opener).
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
         */
        public final String openerFrameId;

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
         */
        public final String browserContextId;

        /**
         * Provides additional details for specific target types. For example, for
         * the type of "page", this may be set to "prerender".
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
         */
        public final String subtype;

        /** Constructor.  Please review this class' fields for documentation. */
        public TargetInfo(
                ReadOnlyList<Boolean> isPresent, String targetId, String type, String title,
                String url, boolean attached, String openerId, boolean canAccessOpener,
                String openerFrameId, String browserContextId, String subtype
            )
        {
            super(singleton, Domains.Target, "TargetInfo", 10);

            this.targetId           = targetId;
            this.type               = type;
            this.title              = title;
            this.url                = url;
            this.attached           = attached;
            this.openerId           = openerId;
            this.canAccessOpener    = canAccessOpener;
            this.openerFrameId      = openerFrameId;
            this.browserContextId   = browserContextId;
            this.subtype            = subtype;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 10, "Target.TargetInfo");
        }

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

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


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


    /**
     * Issued when attached to target because of auto-attach or <CODE>attachToTarget</CODE> command.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class attachedToTarget
        extends BrowserEvent<attachedToTarget>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** Identifier assigned to the session used to send/receive messages. */
        public final String sessionId;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Target.TargetInfo targetInfo;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final boolean waitingForDebugger;

        /** Constructor.  Please review this class' fields for documentation. */
        public attachedToTarget(
                ReadOnlyList<Boolean> isPresent, String sessionId, TargetInfo targetInfo,
                boolean waitingForDebugger
            )
        {
            super(singleton, Domains.Target, "attachedToTarget", 3);

            this.sessionId          = sessionId;
            this.targetInfo         = targetInfo;
            this.waitingForDebugger = waitingForDebugger;

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

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

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

    /**
     * Issued when detached from target for any reason (including <CODE>detachFromTarget</CODE> command). Can be
     * issued multiple times per target if multiple sessions have been attached to it.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class detachedFromTarget
        extends BrowserEvent<detachedFromTarget>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** Detached session identifier. */
        public final String sessionId;

        /**
         * Deprecated.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final String targetId;

        /** Constructor.  Please review this class' fields for documentation. */
        public detachedFromTarget
            (ReadOnlyList<Boolean> isPresent, String sessionId, String targetId)
        {
            super(singleton, Domains.Target, "detachedFromTarget", 2);

            this.sessionId  = sessionId;
            this.targetId   = targetId;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 2, "Target.detachedFromTarget");
        }

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

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

    /**
     * Notifies about a new protocol message received from the session (as reported in
     * <CODE>attachedToTarget</CODE> event).
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class receivedMessageFromTarget
        extends BrowserEvent<receivedMessageFromTarget>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** Identifier of a session which sends a message. */
        public final String sessionId;

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String message;

        /**
         * Deprecated.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final String targetId;

        /** Constructor.  Please review this class' fields for documentation. */
        public receivedMessageFromTarget
            (ReadOnlyList<Boolean> isPresent, String sessionId, String message, String targetId)
        {
            super(singleton, Domains.Target, "receivedMessageFromTarget", 3);

            this.sessionId  = sessionId;
            this.message    = message;
            this.targetId   = targetId;

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

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

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

    /**
     * Issued when a target has crashed.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class targetCrashed
        extends BrowserEvent<targetCrashed>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String targetId;

        /** Termination status type. */
        public final String status;

        /** Termination error code. */
        public final int errorCode;

        /** Constructor.  Please review this class' fields for documentation. */
        public targetCrashed
            (ReadOnlyList<Boolean> isPresent, String targetId, String status, int errorCode)
        {
            super(singleton, Domains.Target, "targetCrashed", 3);

            this.targetId   = targetId;
            this.status     = status;
            this.errorCode  = errorCode;

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

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

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

    /**
     * Issued when a possible inspection target is created.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class targetCreated
        extends BrowserEvent<targetCreated>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Target.TargetInfo targetInfo;

        /** Constructor.  Please review this class' fields for documentation. */
        public targetCreated(ReadOnlyList<Boolean> isPresent, TargetInfo targetInfo)
        {
            super(singleton, Domains.Target, "targetCreated", 1);

            this.targetInfo = targetInfo;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 1, "Target.targetCreated");
        }

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

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

    /**
     * Issued when a target is destroyed.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class targetDestroyed
        extends BrowserEvent<targetDestroyed>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String targetId;

        /** Constructor.  Please review this class' fields for documentation. */
        public targetDestroyed(ReadOnlyList<Boolean> isPresent, String targetId)
        {
            super(singleton, Domains.Target, "targetDestroyed", 1);

            this.targetId = targetId;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 1, "Target.targetDestroyed");
        }

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

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

    /**
     * Issued when some information about a target has changed. This only happens between
     * <CODE>targetCreated</CODE> and <CODE>targetDestroyed</CODE>.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Target DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class targetInfoChanged
        extends BrowserEvent<targetInfoChanged>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Target.TargetInfo targetInfo;

        /** Constructor.  Please review this class' fields for documentation. */
        public targetInfoChanged(ReadOnlyList<Boolean> isPresent, TargetInfo targetInfo)
        {
            super(singleton, Domains.Target, "targetInfoChanged", 1);

            this.targetInfo = targetInfo;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 1, "Target.targetInfoChanged");
        }

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

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




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


    /**
     * Activates (focuses) the target.
     * 
     * @param targetId -
     * 
     * @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> activateTarget(String targetId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "targetId", false, "Target.activateTarget", targetId);

        return Script.NO_RET(Domains.Target, "activateTarget", requestJSON);
    }

    /**
     * Attaches to the browser target, only uses flat sessionId mode.
     * 
     * <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>sessionId</B>)</CODE>
     * <BR />
     * Id assigned to the session.
     * </DIV>
     */
    public static Script<String> attachToBrowserTarget()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Target.attachToBrowserTarget\"}";

        return new Script<>(
            Domains.Target, "attachToBrowserTarget", requestJSON,
            jo -> ReadJSON.getString(jo, "sessionId", true, false),
            String.class
        );
    }

    /**
     * Attaches to the target with given id.
     * 
     * @param targetId -
     * 
     * @param flatten 
     * Enables "flat" access to the session via specifying sessionId attribute in the commands.
     * We plan to make this the default, deprecate non-flattened mode,
     * and eventually retire it. See crbug.com/991325.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</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>sessionId</B>)</CODE>
     * <BR />
     * Id assigned to the session.
     * </DIV>
     */
    public static Script<String> attachToTarget(String targetId, Boolean flatten)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.attachToTarget$$, "Target.attachToTarget",
            targetId, flatten
        );

        return new Script<>(
            Domains.Target, "attachToTarget", requestJSON,
            jo -> ReadJSON.getString(jo, "sessionId", true, false),
            String.class
        );
    }

    /**
     * Adds the specified target to the list of targets that will be monitored for any related target
     * creation (such as child frames, child workers and new versions of service worker) and reported
     * through <CODE>attachedToTarget</CODE>. The specified target is also auto-attached.
     * This cancels the effect of any previous <CODE>setAutoAttach</CODE> and is also cancelled by subsequent
     * <CODE>setAutoAttach</CODE>. Only available at the Browser target.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param targetId -
     * 
     * @param waitForDebuggerOnStart 
     * Whether to pause new targets when attaching to them. Use <CODE>RunTime.runIfWaitingForDebugger</CODE>
     * to run paused targets.
     * 
     * @param filter Only targets matching filter will be attached.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><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> autoAttachRelated
        (String targetId, boolean waitForDebuggerOnStart, FilterEntry[] filter)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.autoAttachRelated$$, "Target.autoAttachRelated",
            targetId, waitForDebuggerOnStart, filter
        );

        return Script.NO_RET(Domains.Target, "autoAttachRelated", requestJSON);
    }

    /**
     * Closes the target. If the target is a page that gets closed too.
     * 
     * @param targetId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;Boolean&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;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
     * be retrieved.</I>
     *
     * <BR /><BR /><DIV CLASS=JDHint>
     * This Browser Function's {@code Promise} returns:
     * <CODE>Boolean (<B>success</B>)</CODE>
     * <BR />
     * Always set to true. If an error occurs, the response indicates protocol error.
     * </DIV>
     */
    public static Script<Boolean> closeTarget(String targetId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "targetId", false, "Target.closeTarget", targetId);

        return new Script<>(
            Domains.Target, "closeTarget", requestJSON,
            jo -> ReadBoxedJSON.getBoolean(jo, "success", JFlag.RD_N | JFlag.RD_M, DV.NULL_BOOL),
            Boolean.class
        );
    }

    /**
     * Creates a new empty BrowserContext. Similar to an incognito profile but you can have more than
     * one.
     * 
     * @param disposeOnDetach If specified, disposes this context when debugging session disconnects.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param proxyServer Proxy server, similar to the one passed to --proxy-server
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param proxyBypassList Proxy bypass list, similar to the one passed to --proxy-bypass-list
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param originsWithUniversalNetworkAccess 
     * An optional list of origins to grant unlimited cross-origin access to.
     * Parts of the URL other than those constituting origin are ignored.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><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>browserContextId</B>)</CODE>
     * <BR />
     * The id of the context created.
     * </DIV>
     */
    public static Script<String> createBrowserContext(
            Boolean disposeOnDetach, String proxyServer, String proxyBypassList,
            String[] originsWithUniversalNetworkAccess
        )
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.createBrowserContext$$, "Target.createBrowserContext",
            disposeOnDetach, proxyServer, proxyBypassList, originsWithUniversalNetworkAccess
        );

        return new Script<>(
            Domains.Target, "createBrowserContext", requestJSON,
            jo -> ReadJSON.getString(jo, "browserContextId", true, false),
            String.class
        );
    }

    /**
     * Creates a new page.
     * 
     * <BR /><BR /><DIV CLASS=JDHint>
     * 👍 Because of the sheer number of input parameters to this method, there is a
     * a {@link CommandBuilder} variant to this method which may be invoked instead.
     * 
     * <BR /><BR />
     * Please View: {@link #createTarget()}
     * </DIV>
     * 
     * @param url The initial URL the page will be navigated to. An empty string indicates about:blank.
     * 
     * @param left Frame left origin in DIP (requires newWindow to be true or headless shell).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param top Frame top origin in DIP (requires newWindow to be true or headless shell).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param width Frame width in DIP (requires newWindow to be true or headless shell).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param height Frame height in DIP (requires newWindow to be true or headless shell).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param windowState 
     * Frame window state (requires newWindow to be true or headless shell).
     * Default is normal.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param browserContextId The browser context to create the page in.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param enableBeginFrameControl 
     * Whether BeginFrames for this target will be controlled via DevTools (headless shell only,
     * not supported on MacOS yet, false by default).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param newWindow Whether to create a new Window or Tab (false by default, not supported by headless shell).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param background 
     * Whether to create the target in background or foreground (false by default, not supported
     * by headless shell).
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param forTab Whether to create the target of type "tab".
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param hidden 
     * Whether to create a hidden target. The hidden target is observable via protocol, but not
     * present in the tab UI strip. Cannot be created with <CODE>forTab: true</CODE>, <CODE>newWindow: true</CODE> or
     * <CODE>background: false</CODE>. The life-time of the tab is limited to the life-time of the session.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><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>targetId</B>)</CODE>
     * <BR />
     * The id of the page opened.
     * </DIV>
     */
    public static Script<String> createTarget(
            String url, Integer left, Integer top, Integer width, Integer height,
            String windowState, String browserContextId, Boolean enableBeginFrameControl,
            Boolean newWindow, Boolean background, Boolean forTab, Boolean hidden
        )
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.createTarget$$, "Target.createTarget",
            url, left, top, width, height, windowState, browserContextId, enableBeginFrameControl,
            newWindow, background, forTab, hidden
        );

        return new Script<>(
            Domains.Target, "createTarget", requestJSON,
            jo -> ReadJSON.getString(jo, "targetId", true, false),
            String.class
        );
    }

    /**
     * Detaches session with given id.
     * 
     * @param sessionId Session to detach.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param targetId Deprecated.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Dep-Top>DEPRECATED</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> detachFromTarget(String sessionId, String targetId)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.detachFromTarget$$, "Target.detachFromTarget",
            sessionId, targetId
        );

        return Script.NO_RET(Domains.Target, "detachFromTarget", requestJSON);
    }

    /**
     * Deletes a BrowserContext. All the belonging pages will be closed without calling their
     * beforeunload hooks.
     * 
     * @param browserContextId -
     * 
     * @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> disposeBrowserContext(String browserContextId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get(
            CDPTypes.STRING, "browserContextId", false, "Target.disposeBrowserContext",
            browserContextId
        );

        return Script.NO_RET(Domains.Target, "disposeBrowserContext", requestJSON);
    }

    /**
     * Inject object to the target's main frame that provides a communication
     * channel with browser target.
     * 
     * Injected object will be available as <CODE>window[bindingName]</CODE>.
     * 
     * The object has the following API:
     * - <CODE>binding.send(json)</CODE> - a method to send messages over the remote debugging protocol
     * - <CODE>binding.onmessage = json =&gt; handleMessage(json)</CODE> - a callback that will be called for the protocol notifications and command responses.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param targetId -
     * 
     * @param bindingName Binding name, 'cdp' if not specified.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param inheritPermissions If true, inherits the current root session's permissions (default: 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> exposeDevToolsProtocol
        (String targetId, String bindingName, Boolean inheritPermissions)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.exposeDevToolsProtocol$$, "Target.exposeDevToolsProtocol",
            targetId, bindingName, inheritPermissions
        );

        return Script.NO_RET(Domains.Target, "exposeDevToolsProtocol", requestJSON);
    }

    /**
     * Returns all browser contexts created with <CODE>Target.createBrowserContext</CODE> method.
     * 
     * @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>browserContextIds</B>)</CODE>
     * <BR />
     * An array of browser context ids.
     * </DIV>
     */
    public static Script<String[]> getBrowserContexts()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Target.getBrowserContexts\"}";

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

    /**
     * Returns information about a target.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param targetId -
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link Target.TargetInfo}&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 Target.TargetInfo}&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 Target.TargetInfo} (<B>targetInfo</B>)</CODE>
     * </DIV>
     */
    public static Script<Target.TargetInfo> getTargetInfo(String targetId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "targetId", true, "Target.getTargetInfo", targetId);

        return new Script<>(
            Domains.Target, "getTargetInfo", requestJSON,
            Target$$Commands::getTargetInfo,
            Target.TargetInfo.class
        );
    }

    /**
     * Retrieves a list of available targets.
     * 
     * @param filter 
     * Only targets matching filter will be reported. If filter is not specified
     * and target discovery is currently enabled, a filter used for target discovery
     * is used for consistency.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @return An instance of <CODE>{@link Script}&lt;{@link Target.TargetInfo}[]&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 Target.TargetInfo}[]&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 Target.TargetInfo}[] (<B>targetInfos</B>)</CODE>
     * <BR />
     * The list of targets.
     * </DIV>
     */
    public static Script<Target.TargetInfo[]> getTargets(FilterEntry[] filter)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.CDP_TYPE, "filter", true, "Target.getTargets", (Object) filter);

        return new Script<>(
            Domains.Target, "getTargets", requestJSON,
            Target$$Commands::getTargets,
            Target.TargetInfo[].class
        );
    }

    /**
     * Opens a DevTools window for the target.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param targetId This can be the page or tab target ID.
     * 
     * @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>targetId</B>)</CODE>
     * <BR />
     * The targetId of DevTools page target.
     * </DIV>
     */
    public static Script<String> openDevTools(String targetId)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get
            (CDPTypes.STRING, "targetId", false, "Target.openDevTools", targetId);

        return new Script<>(
            Domains.Target, "openDevTools", requestJSON,
            jo -> ReadJSON.getString(jo, "targetId", true, false),
            String.class
        );
    }

    /**
     * Sends protocol message over session with given id.
     * Consider using flat mode instead; see commands attachToTarget, setAutoAttach,
     * and crbug.com/991325.
     * 
     * <BR /><B CLASS=Dep-Top>DEPRECATED</B>
     * 
     * @param message -
     * 
     * @param sessionId Identifier of the session.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
     * 
     * @param targetId Deprecated.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Dep-Top>DEPRECATED</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> sendMessageToTarget
        (String message, String sessionId, String targetId)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.sendMessageToTarget$$, "Target.sendMessageToTarget",
            message, sessionId, targetId
        );

        return Script.NO_RET(Domains.Target, "sendMessageToTarget", requestJSON);
    }

    /**
     * Controls whether to automatically attach to new targets which are considered
     * to be directly related to this one (for example, iframes or workers).
     * When turned on, attaches to all existing related targets as well. When turned off,
     * automatically detaches from all currently attached targets.
     * This also clears all targets added by <CODE>autoAttachRelated</CODE> from the list of targets to watch
     * for creation of related targets.
     * You might want to call this recursively for auto-attached targets to attach
     * to all available targets.
     * 
     * @param autoAttach Whether to auto-attach to related targets.
     * 
     * @param waitForDebuggerOnStart 
     * Whether to pause new targets when attaching to them. Use <CODE>RunTime.runIfWaitingForDebugger</CODE>
     * to run paused targets.
     * 
     * @param flatten 
     * Enables "flat" access to the session via specifying sessionId attribute in the commands.
     * We plan to make this the default, deprecate non-flattened mode,
     * and eventually retire it. See crbug.com/991325.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param filter Only targets matching filter will be attached.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><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> setAutoAttach
        (boolean autoAttach, boolean waitForDebuggerOnStart, Boolean flatten, FilterEntry[] filter)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.setAutoAttach$$, "Target.setAutoAttach",
            autoAttach, waitForDebuggerOnStart, flatten, filter
        );

        return Script.NO_RET(Domains.Target, "setAutoAttach", requestJSON);
    }

    /**
     * Controls whether to discover available targets and notify via
     * <CODE>targetCreated/targetInfoChanged/targetDestroyed</CODE> events.
     * 
     * @param discover Whether to discover available targets.
     * 
     * @param filter 
     * Only targets matching filter will be attached. If <CODE>discover</CODE> is false,
     * <CODE>filter</CODE> must be omitted or empty.
     * <BR /><B CLASS=Opt-Top>OPTIONAL</B><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> setDiscoverTargets(boolean discover, FilterEntry[] filter)
    {
        // Convert all Method Parameters into a JSON Request-Object (as a String)
        final String requestJSON = WriteJSON.get(
            Target$$Commands.setDiscoverTargets$$, "Target.setDiscoverTargets",
            discover, filter
        );

        return Script.NO_RET(Domains.Target, "setDiscoverTargets", requestJSON);
    }

    /**
     * Enables target discovery for the specified locations, when <CODE>setDiscoverTargets</CODE> was set to
     * <CODE>true</CODE>.
     * 
     * <BR /><B CLASS=Exp-Top>EXPERIMENTAL</B>
     * 
     * @param locations List of remote locations.
     * 
     * @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> setRemoteLocations(RemoteLocation[] locations)
    {
        // Build the JSON Request-Object (as a String); only 1 Parameter is passed
        final String requestJSON = WriteJSON.get(
            CDPTypes.CDP_TYPE_ARRAY_1D, "locations", false, "Target.setRemoteLocations",
            (Object) locations
        );

        return Script.NO_RET(Domains.Target, "setRemoteLocations", requestJSON);
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // CommandBuilder Getter-Methods
    // ********************************************************************************************
    // ********************************************************************************************


    /**
     * Creates a buider for conveniently assigning parameters to this method.
     * 
     * <BR /><BR /><DIV CLASS=JDHint>
     * Note that the original method expects 12 parameters, and can be cumbersome.
     * </DIV>
     * 
     * @return {@link CommandBuilder} instance, for assigning parameter values, one by one.
     * @see #createTarget
     */
    public static CommandBuilder<String> createTarget()
    { return CommandBuilder.builder(Target$$Commands.createTarget$$); }


}