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;


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

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

/**
 * <SPAN CLASS=COPIEDJDK><B><CODE>[No Description Provided by Google]</CODE></B></SPAN>
 * <EMBED CLASS='external-html' DATA-FILE-ID=CDP.CODE_GEN_NOTE>
 */
@StaticFunctional@JDHeaderBackgroundImg(EmbedTagFileID="CDP.WOOD_PLANK_NOTE")
public class Preload
{
    // No Pubic Constructors
    private Preload() { }


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


    /**
     * Chrome manages different types of preloads together using a
     * concept of preloading pipeline. For example, if a site uses a
     * SpeculationRules for prerender, Chrome first starts a prefetch and
     * then upgrades it to prerender.
     * 
     * CDP events for them are emitted separately but they share
     * <CODE>PreloadPipelineId</CODE>.

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

    /**
     * Unique id

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


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


    /**
     * TODO(https://crbug.com/1384419): revisit the list of PrefetchStatus and
     * filter out the ones that aren't necessary to the developers.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> PrefetchStatus = new ReadOnlyArrayList<>(
        String.class, 
        "PrefetchAllowed", "PrefetchEvictedAfterBrowsingDataRemoved",
        "PrefetchEvictedAfterCandidateRemoved", "PrefetchEvictedForNewerPrefetch",
        "PrefetchFailedIneligibleRedirect", "PrefetchFailedInvalidRedirect",
        "PrefetchFailedMIMENotSupported", "PrefetchFailedNetError", "PrefetchFailedNon2XX",
        "PrefetchHeldback", "PrefetchIneligibleRetryAfter", "PrefetchIsPrivacyDecoy",
        "PrefetchIsStale", "PrefetchNotEligibleBatterySaverEnabled",
        "PrefetchNotEligibleBrowserContextOffTheRecord", "PrefetchNotEligibleDataSaverEnabled",
        "PrefetchNotEligibleExistingProxy", "PrefetchNotEligibleHostIsNonUnique",
        "PrefetchNotEligibleNonDefaultStoragePartition", "PrefetchNotEligiblePreloadingDisabled",
        "PrefetchNotEligibleRedirectFromServiceWorker",
        "PrefetchNotEligibleRedirectToServiceWorker",
        "PrefetchNotEligibleSameSiteCrossOriginPrefetchRequiredProxy",
        "PrefetchNotEligibleSchemeIsNotHttps", "PrefetchNotEligibleUserHasCookies",
        "PrefetchNotEligibleUserHasServiceWorker",
        "PrefetchNotEligibleUserHasServiceWorkerNoFetchHandler", "PrefetchNotFinishedInTime",
        "PrefetchNotStarted", "PrefetchNotUsedCookiesChanged", "PrefetchNotUsedProbeFailed",
        "PrefetchProxyNotAvailable", "PrefetchResponseUsed", "PrefetchSuccessfulButNotUsed"
    );

    /**
     * Preloading status values, see also PreloadingTriggeringOutcome. This
     * status is shared by prefetchStatusUpdated and prerenderStatusUpdated.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> PreloadingStatus = new ReadOnlyArrayList<>
        (String.class, "Failure", "NotSupported", "Pending", "Ready", "Running", "Success");

    /**
     * List of FinalStatus reasons for Prerender2.
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> PrerenderFinalStatus = new ReadOnlyArrayList<>(
        String.class, 
        "Activated", "ActivatedBeforeStarted", "ActivatedDuringMainFrameNavigation",
        "ActivatedInBackground", "ActivatedWithAuxiliaryBrowsingContexts",
        "ActivationFramePolicyNotCompatible", "ActivationNavigationDestroyedBeforeSuccess",
        "ActivationNavigationParameterMismatch", "ActivationUrlHasEffectiveUrl",
        "AllPrerenderingCanceled", "AudioOutputDeviceRequested", "BatterySaverEnabled",
        "BlockedByClient", "BrowsingDataRemoved", "CancelAllHostsForTesting", "ClientCertRequested",
        "CrossSiteNavigationInInitialNavigation", "CrossSiteNavigationInMainFrameNavigation",
        "CrossSiteRedirectInInitialNavigation", "CrossSiteRedirectInMainFrameNavigation",
        "DataSaverEnabled", "Destroyed", "DidFailLoad", "Download", "EmbedderHostDisallowed",
        "InactivePageRestriction", "InvalidSchemeNavigation", "InvalidSchemeRedirect",
        "JavaScriptInterfaceAdded", "JavaScriptInterfaceRemoved", "LoginAuthRequested",
        "LowEndDevice", "MaxNumOfRunningEagerPrerendersExceeded",
        "MaxNumOfRunningEmbedderPrerendersExceeded", "MaxNumOfRunningNonEagerPrerendersExceeded",
        "MemoryLimitExceeded", "MemoryPressureAfterTriggered", "MemoryPressureOnTrigger",
        "MixedContent", "MojoBinderPolicy", "NavigationBadHttpStatus", "NavigationNotCommitted",
        "NavigationRequestBlockedByCsp", "NavigationRequestNetworkError",
        "OtherPrerenderedPageActivated", "PreloadingDisabled", "PreloadingUnsupportedByWebContents",
        "PrerenderFailedDuringPrefetch", "PrerenderHostReused", "PrerenderingDisabledByDevTools",
        "PrerenderingUrlHasEffectiveUrl", "PrimaryMainFrameRendererProcessCrashed",
        "PrimaryMainFrameRendererProcessKilled", "RedirectedPrerenderingUrlHasEffectiveUrl",
        "RendererProcessCrashed", "RendererProcessKilled",
        "SameSiteCrossOriginNavigationNotOptInInInitialNavigation",
        "SameSiteCrossOriginNavigationNotOptInInMainFrameNavigation",
        "SameSiteCrossOriginRedirectNotOptInInInitialNavigation",
        "SameSiteCrossOriginRedirectNotOptInInMainFrameNavigation", "SlowNetwork",
        "SpeculationRuleRemoved", "SslCertificateError", "StartFailed", "Stop",
        "TabClosedByUserGesture", "TabClosedWithoutUserGesture", "TimeoutBackgrounded",
        "TriggerBackgrounded", "TriggerDestroyed", "TriggerUrlHasEffectiveUrl",
        "UaChangeRequiresReload", "V8OptimizerDisabled", "WindowClosed"
    );

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> RuleSetErrorType = new ReadOnlyArrayList<>
        (String.class, "InvalidRulesSkipped", "InvalidRulesetLevelTag", "SourceIsNotJsonObject");

    /**
     * The type of preloading attempted. It corresponds to
     * mojom::SpeculationAction (although PrefetchWithSubresources is omitted as it
     * isn't being used by clients).
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> SpeculationAction = new ReadOnlyArrayList<>
        (String.class, "Prefetch", "Prerender");

    /**
     * Corresponds to mojom::SpeculationTargetHint.
     * See https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
     * <BR /><BR /><B CLASS=StrEnumType>String-Enumeration Type</B>
     */
    public static final ReadOnlyList<String> SpeculationTargetHint = new ReadOnlyArrayList<>
        (String.class, "Blank", "Self");



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


    /**
     * A key that identifies a preloading attempt.
     * 
     * The url used is the url specified by the trigger (i.e. the initial URL), and
     * not the final url that is navigated to. For example, prerendering allows
     * same-origin main frame navigations during the attempt, but the attempt is
     * still keyed with the initial URL.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class PreloadingAttemptKey
        extends BaseType<PreloadingAttemptKey>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

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

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=SpeculationAction DATA-F=action DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String action;

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

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=SpeculationTargetHint DATA-F=targetHint DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String targetHint;

        /** Constructor.  Please review this class' fields for documentation. */
        public PreloadingAttemptKey(
                ReadOnlyList<Boolean> isPresent, String loaderId, String action, String url,
                String targetHint
            )
        {
            super(singleton, Domains.Preload, "PreloadingAttemptKey", 4);

            this.loaderId   = loaderId;
            this.action     = action;
            this.url        = url;
            this.targetHint = targetHint;

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

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

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

    /**
     * Lists sources for a preloading attempt, specifically the ids of rule sets
     * that had a speculation rule that triggered the attempt, and the
     * BackendNodeIds of {@code <a href> or <area href>} elements that triggered the
     * attempt (in the case of attempts triggered by a document rule). It is
     * possible for multiple rule sets and links to trigger a single attempt.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class PreloadingAttemptSource
        extends BaseType<PreloadingAttemptSource>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Preload.PreloadingAttemptKey key;

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

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

        /** Constructor.  Please review this class' fields for documentation. */
        public PreloadingAttemptSource(
                ReadOnlyList<Boolean> isPresent, PreloadingAttemptKey key, String[] ruleSetIds,
                int[] nodeIds
            )
        {
            super(singleton, Domains.Preload, "PreloadingAttemptSource", 3);

            this.key        = key;
            this.ruleSetIds = ruleSetIds;
            this.nodeIds    = nodeIds;

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

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

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

    /**
     * Information of headers to be displayed when the header mismatch occurred.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class PrerenderMismatchedHeaders
        extends BaseType<PrerenderMismatchedHeaders>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

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

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

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

        /** Constructor.  Please review this class' fields for documentation. */
        public PrerenderMismatchedHeaders(
                ReadOnlyList<Boolean> isPresent, String headerName, String initialValue,
                String activationValue
            )
        {
            super(singleton, Domains.Preload, "PrerenderMismatchedHeaders", 3);

            this.headerName         = headerName;
            this.initialValue       = initialValue;
            this.activationValue    = activationValue;

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

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

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

    /**
     * Corresponds to SpeculationRuleSet
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_TYPE_JDHBI")
    public static class RuleSet
        extends BaseType<RuleSet>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

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

        /** Identifies a document which the rule set is associated with. */
        public final String loaderId;

        /**
         * Source text of JSON representing the rule set. If it comes from
         * <CODE>{@code <script>}</CODE> tag, it is the textContent of the node. Note that it is
         * a JSON for valid case.
         * 
         * See also:
         * - https://wicg.github.io/nav-speculation/speculation-rules.html
         * - https://github.com/WICG/nav-speculation/blob/main/triggers.md
         */
        public final String sourceText;

        /**
         * A speculation rule set is either added through an inline
         * <CODE>{@code <script>}</CODE> tag or through an external resource via the
         * 'Speculation-Rules' HTTP header. For the first case, we include
         * the BackendNodeId of the relevant <CODE>{@code <script>}</CODE> tag. For the second
         * case, we include the external URL where the rule set was loaded
         * from, and also RequestId if Network domain is enabled.
         * 
         * See also:
         * - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-script
         * - https://wicg.github.io/nav-speculation/speculation-rules.html#speculation-rules-header
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Integer backendNodeId;

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

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

        /**
         * Error information
         * <CODE>errorMessage</CODE> is null iff <CODE>errorType</CODE> is null.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=RuleSetErrorType DATA-F=errorType DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String errorType;

        /**
         * TODO(https://crbug.com/1425354): Replace this property with structured error.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B><B CLASS=Dep-Top>DEPRECATED</B>
         */
        public final String errorMessage;

        /** Constructor.  Please review this class' fields for documentation. */
        public RuleSet(
                ReadOnlyList<Boolean> isPresent, String id, String loaderId, String sourceText,
                Integer backendNodeId, String url, String requestId, String errorType,
                String errorMessage
            )
        {
            super(singleton, Domains.Preload, "RuleSet", 8);

            this.id             = id;
            this.loaderId       = loaderId;
            this.sourceText     = sourceText;
            this.backendNodeId  = backendNodeId;
            this.url            = url;
            this.requestId      = requestId;
            this.errorType      = errorType;
            this.errorMessage   = errorMessage;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 8, "Preload.RuleSet");
        }

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

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


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


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

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Preload.PreloadingAttemptKey key;

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

        /** The frame id of the frame initiating prefetch. */
        public final String initiatingFrameId;

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

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=PreloadingStatus DATA-F=status DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String status;

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=PrefetchStatus DATA-F=prefetchStatus DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String prefetchStatus;

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

        /** Constructor.  Please review this class' fields for documentation. */
        public prefetchStatusUpdated(
                ReadOnlyList<Boolean> isPresent, PreloadingAttemptKey key, String pipelineId,
                String initiatingFrameId, String prefetchUrl, String status, String prefetchStatus,
                String requestId
            )
        {
            super(singleton, Domains.Preload, "prefetchStatusUpdated", 7);

            this.key                = key;
            this.pipelineId         = pipelineId;
            this.initiatingFrameId  = initiatingFrameId;
            this.prefetchUrl        = prefetchUrl;
            this.status             = status;
            this.prefetchStatus     = prefetchStatus;
            this.requestId          = requestId;

            this.isPresent = (isPresent == null)
                ? singleton.generateIsPresentList(this)
                : THROWS.check(isPresent, 7, "Preload.prefetchStatusUpdated");
        }

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

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

    /**
     * Fired when a preload enabled state is updated.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class preloadEnabledStateUpdated
        extends BrowserEvent<preloadEnabledStateUpdated>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

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

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

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

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

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

        /** Constructor.  Please review this class' fields for documentation. */
        public preloadEnabledStateUpdated(
                ReadOnlyList<Boolean> isPresent, boolean disabledByPreference,
                boolean disabledByDataSaver, boolean disabledByBatterySaver,
                boolean disabledByHoldbackPrefetchSpeculationRules,
                boolean disabledByHoldbackPrerenderSpeculationRules
            )
        {
            super(singleton, Domains.Preload, "preloadEnabledStateUpdated", 5);

            this.disabledByPreference                           = disabledByPreference;
            this.disabledByDataSaver                            = disabledByDataSaver;
            this.disabledByBatterySaver                         = disabledByBatterySaver;
            this.disabledByHoldbackPrefetchSpeculationRules     = disabledByHoldbackPrefetchSpeculationRules;
            this.disabledByHoldbackPrerenderSpeculationRules    = disabledByHoldbackPrerenderSpeculationRules;

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

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

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

    /**
     * Send a list of sources for all preloading attempts in a document.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class preloadingAttemptSourcesUpdated
        extends BrowserEvent<preloadingAttemptSourcesUpdated>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Preload.PreloadingAttemptSource[] preloadingAttemptSources;

        /** Constructor.  Please review this class' fields for documentation. */
        public preloadingAttemptSourcesUpdated(
                ReadOnlyList<Boolean> isPresent, String loaderId,
                PreloadingAttemptSource[] preloadingAttemptSources
            )
        {
            super(singleton, Domains.Preload, "preloadingAttemptSourcesUpdated", 2);

            this.loaderId                   = loaderId;
            this.preloadingAttemptSources   = preloadingAttemptSources;

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

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

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

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

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Preload.PreloadingAttemptKey key;

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

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=PreloadingStatus DATA-F=status DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String status;

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         * <EMBED CLASS='external-html' DATA-D=Preload DATA-C=PrerenderFinalStatus DATA-F=prerenderStatus DATA-FILE-ID=CDP.EL2>
         * @see BaseType#enumStrList(String)
         */
        public final String prerenderStatus;

        /**
         * This is used to give users more information about the name of Mojo interface
         * that is incompatible with prerender and has caused the cancellation of the attempt.
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final String disallowedMojoInterface;

        /**
         * <CODE>[No Description Provided by Google]</CODE>
         * <BR /><B CLASS=Opt-Top>OPTIONAL</B>
         */
        public final Preload.PrerenderMismatchedHeaders[] mismatchedHeaders;

        /** Constructor.  Please review this class' fields for documentation. */
        public prerenderStatusUpdated(
                ReadOnlyList<Boolean> isPresent, PreloadingAttemptKey key, String pipelineId,
                String status, String prerenderStatus, String disallowedMojoInterface,
                PrerenderMismatchedHeaders[] mismatchedHeaders
            )
        {
            super(singleton, Domains.Preload, "prerenderStatusUpdated", 6);

            this.key                        = key;
            this.pipelineId                 = pipelineId;
            this.status                     = status;
            this.prerenderStatus            = prerenderStatus;
            this.disallowedMojoInterface    = disallowedMojoInterface;
            this.mismatchedHeaders          = mismatchedHeaders;

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

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

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

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

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

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

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

            this.id = id;

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

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

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

    /**
     * Upsert. Currently, it is only emitted when a rule set added.
     * 
     * <EMBED CLASS=globalDefs DATA-DOMAIN=Preload DATA-API=BrowserAPI>
     */
    @JDHeaderBackgroundImg(EmbedTagFileID="CDP.NESTED_EVENT_JDHBI")
    public static class ruleSetUpdated
        extends BrowserEvent<ruleSetUpdated>
        implements java.io.Serializable
    {
        /** <EMBED CLASS='external-html' DATA-FILE-ID=SVUID> */
        protected static final long serialVersionUID = 1;

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

        /** <CODE>[No Description Provided by Google]</CODE> */
        public final Preload.RuleSet ruleSet;

        /** Constructor.  Please review this class' fields for documentation. */
        public ruleSetUpdated(ReadOnlyList<Boolean> isPresent, RuleSet ruleSet)
        {
            super(singleton, Domains.Preload, "ruleSetUpdated", 1);

            this.ruleSet = ruleSet;

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

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

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




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


    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @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> disable()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Preload.disable\"}";

        return Script.NO_RET(Domains.Preload, "disable", requestJSON);
    }

    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @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> enable()
    {
        // Ultra-Simple Request JSON - Because this method has no parameters
        final String requestJSON = "{\"method\":\"Preload.enable\"}";

        return Script.NO_RET(Domains.Preload, "enable", requestJSON);
    }


}