devtools-protocol 0.0.1682007 → 0.0.1684464

package/types/protocol.d.ts

@@ -3193,9 +3193,32 @@ export namespace Protocol {
             removeAdFrames: Page.FrameId[];
         }
 
+        /**
+         * An ad script.
+         * Note: when the script is a transitive ad script, we only fill in the
+         * immediate ancestor script in the provenance's adScriptAncestry field (as its
+         * first entry), rather than filling in the full ancestry. This saves work for
+         * the backend, and the frontend can reconstruct the full ancestry if
+         * necessary.
+         */
+        export interface AdScript {
+            /**
+             * The script ID.
+             */
+            scriptId: Runtime.ScriptId;
+            /**
+             * The ad provenance.
+             */
+            provenance: Network.AdProvenance;
+        }
+
         export interface GetAdMetricsResponse {
             metrics: AdMetrics;
         }
+
+        export interface GetAdScriptsResponse {
+            newScripts: AdScript[];
+        }
     }
 
     /**
@@ -13899,6 +13922,9 @@ export namespace Protocol {
             filterlistRule?: string;
             /**
              * The script ancestry that created the ad, if any.
+             * Note: depending on the context, this may represent the full ancestry up
+             * to the root script, or it may contain only one script representing the
+             * immediate ancestor.
              */
             adScriptAncestry?: AdAncestry;
         }
@@ -18179,9 +18205,21 @@ export namespace Protocol {
              */
             maxHeight?: integer;
             /**
-             * Send every n-th frame.
+             * Send every n-th frame. Must be a positive integer.
              */
             everyNthFrame?: integer;
+            /**
+             * Maximum number of frames sent until screencastFrameAck is required.
+             * Defaults to 3. Must be a positive integer.
+             */
+            maxFramesInFlight?: integer;
+            /**
+             * By default, after screencastFrameAck arrives, the next produced frame is sent.
+             * Passing this flag enables storing the last produced frame in memory, which is
+             * immediately sent upon screencastFrameAck. This way, overall performance is
+             * traded for a better latency.
+             */
+            sendLastFrame?: boolean;
         }
 
         export interface StartScreenRecordingRequest {
@@ -19460,6 +19498,55 @@ export namespace Protocol {
 
         export type ServiceWorkerVersionStatus = ('new' | 'installing' | 'installed' | 'activating' | 'activated' | 'redundant');
 
+        /**
+         * Mostly corresponds to `RouterCondition` in ServiceWorker spec
+         * (https://www.w3.org/TR/service-workers/#dictdef-routercondition) while this
+         * currently lacks support for the nested conditions ("or" and "not").
+         * TODO(crbug.com/540469610): Support recursive conditions.
+         */
+        export interface ServiceWorkerRouterCondition {
+            /**
+             * Plain text, or JSON serialization of URLPatternInit or URLPattern
+             */
+            urlPattern?: string;
+            requestMethod?: string;
+            requestMode?: string;
+            requestDestination?: string;
+            runningStatus?: ServiceWorkerVersionRunningStatus;
+        }
+
+        export type ServiceWorkerRouterSourceType = ('cache' | 'fetchEvent' | 'network' | 'raceNetworkAndFetchHandler' | 'raceNetworkAndCache' | 'sourceDict');
+
+        /**
+         * https://www.w3.org/TR/service-workers/#dictdef-routersourcedict
+         */
+        export interface ServiceWorkerRouterSourceDict {
+            cacheName: string;
+        }
+
+        /**
+         * Corresponds to `RouterSource` in the spec while the representation is different as follows.
+         * (https://www.w3.org/TR/service-workers/#typedefdef-routersource)
+         * - `RouterSourceEnum`: `type` equals `cache`, `sourceDict` is null.
+         * - `RouterSourceDict`: `type` equals `sourceDict`, `sourceDict` has valid value.
+         */
+        export interface ServiceWorkerRouterSource {
+            type: ServiceWorkerRouterSourceType;
+            /**
+             * Non-empty iff `type` equals "sourceDict".
+             */
+            sourceDict?: ServiceWorkerRouterSourceDict;
+        }
+
+        export interface ServiceWorkerRouterRule {
+            condition: ServiceWorkerRouterCondition;
+            source: ServiceWorkerRouterSource;
+            /**
+             * Rule ID assigned by the browser. Unique within each ServiceWorkerVersion.
+             */
+            id: integer;
+        }
+
         /**
          * ServiceWorker version.
          */
@@ -19480,7 +19567,13 @@ export namespace Protocol {
             scriptResponseTime?: number;
             controlledClients?: Target.TargetID[];
             targetId?: Target.TargetID;
+            /**
+             * Migration to `typedRouterRules` is in progress. The browser sends either
+             * `routerRules` or `typedRouterRules`.
+             * TODO(crbug.com/540469610): Remove `routerRules` after the migration.
+             */
             routerRules?: string;
+            typedRouterRules?: ServiceWorkerRouterRule[];
         }
 
         /**
@@ -19871,7 +19964,7 @@ export namespace Protocol {
         /**
          * Enum of possible storage types.
          */
-        export type StorageType = ('cookies' | 'file_systems' | 'indexeddb' | 'local_storage' | 'shader_cache' | 'websql' | 'service_workers' | 'cache_storage' | 'shared_storage' | 'storage_buckets' | 'all' | 'other');
+        export type StorageType = ('cookies' | 'file_systems' | 'indexeddb' | 'local_storage' | 'shader_cache' | 'websql' | 'service_workers' | 'cache_storage' | 'storage_buckets' | 'all' | 'other');
 
         /**
          * Usage for a storage type.
@@ -19897,197 +19990,6 @@ export namespace Protocol {
             count: number;
         }
 
-        /**
-         * Enum of shared storage access scopes.
-         */
-        export type SharedStorageAccessScope = ('window' | 'sharedStorageWorklet' | 'header');
-
-        /**
-         * Enum of shared storage access methods.
-         */
-        export type SharedStorageAccessMethod = ('addModule' | 'createWorklet' | 'selectURL' | 'run' | 'batchUpdate' | 'set' | 'append' | 'delete' | 'clear' | 'get' | 'keys' | 'values' | 'entries' | 'length' | 'remainingBudget');
-
-        /**
-         * Struct for a single key-value pair in an origin's shared storage.
-         */
-        export interface SharedStorageEntry {
-            key: string;
-            value: string;
-        }
-
-        /**
-         * Details for an origin's shared storage.
-         */
-        export interface SharedStorageMetadata {
-            /**
-             * Time when the origin's shared storage was last created.
-             */
-            creationTime: Network.TimeSinceEpoch;
-            /**
-             * Number of key-value pairs stored in origin's shared storage.
-             */
-            length: integer;
-            /**
-             * Current amount of bits of entropy remaining in the navigation budget.
-             */
-            remainingBudget: number;
-            /**
-             * Total number of bytes stored as key-value pairs in origin's shared
-             * storage.
-             */
-            bytesUsed: integer;
-        }
-
-        /**
-         * Represents a dictionary object passed in as privateAggregationConfig to
-         * run or selectURL.
-         */
-        export interface SharedStoragePrivateAggregationConfig {
-            /**
-             * The chosen aggregation service deployment.
-             */
-            aggregationCoordinatorOrigin?: string;
-            /**
-             * The context ID provided.
-             */
-            contextId?: string;
-            /**
-             * Configures the maximum size allowed for filtering IDs.
-             */
-            filteringIdMaxBytes: integer;
-            /**
-             * The limit on the number of contributions in the final report.
-             */
-            maxContributions?: integer;
-        }
-
-        /**
-         * Pair of reporting metadata details for a candidate URL for `selectURL()`.
-         */
-        export interface SharedStorageReportingMetadata {
-            eventType: string;
-            reportingUrl: string;
-        }
-
-        /**
-         * Bundles a candidate URL with its reporting metadata.
-         */
-        export interface SharedStorageUrlWithMetadata {
-            /**
-             * Spec of candidate URL.
-             */
-            url: string;
-            /**
-             * Any associated reporting metadata.
-             */
-            reportingMetadata: SharedStorageReportingMetadata[];
-        }
-
-        /**
-         * Bundles the parameters for shared storage access events whose
-         * presence/absence can vary according to SharedStorageAccessType.
-         */
-        export interface SharedStorageAccessParams {
-            /**
-             * Spec of the module script URL.
-             * Present only for SharedStorageAccessMethods: addModule and
-             * createWorklet.
-             */
-            scriptSourceUrl?: string;
-            /**
-             * String denoting "context-origin", "script-origin", or a custom
-             * origin to be used as the worklet's data origin.
-             * Present only for SharedStorageAccessMethod: createWorklet.
-             */
-            dataOrigin?: string;
-            /**
-             * Name of the registered operation to be run.
-             * Present only for SharedStorageAccessMethods: run and selectURL.
-             */
-            operationName?: string;
-            /**
-             * ID of the operation call.
-             * Present only for SharedStorageAccessMethods: run and selectURL.
-             */
-            operationId?: string;
-            /**
-             * Whether or not to keep the worket alive for future run or selectURL
-             * calls.
-             * Present only for SharedStorageAccessMethods: run and selectURL.
-             */
-            keepAlive?: boolean;
-            /**
-             * Configures the private aggregation options.
-             * Present only for SharedStorageAccessMethods: run and selectURL.
-             */
-            privateAggregationConfig?: SharedStoragePrivateAggregationConfig;
-            /**
-             * The operation's serialized data in bytes (converted to a string).
-             * Present only for SharedStorageAccessMethods: run and selectURL.
-             * TODO(crbug.com/401011862): Consider updating this parameter to binary.
-             */
-            serializedData?: string;
-            /**
-             * Array of candidate URLs' specs, along with any associated metadata.
-             * Present only for SharedStorageAccessMethod: selectURL.
-             */
-            urlsWithMetadata?: SharedStorageUrlWithMetadata[];
-            /**
-             * Spec of the URN:UUID generated for a selectURL call.
-             * Present only for SharedStorageAccessMethod: selectURL.
-             */
-            urnUuid?: string;
-            /**
-             * Key for a specific entry in an origin's shared storage.
-             * Present only for SharedStorageAccessMethods: set, append, delete, and
-             * get.
-             */
-            key?: string;
-            /**
-             * Value for a specific entry in an origin's shared storage.
-             * Present only for SharedStorageAccessMethods: set and append.
-             */
-            value?: string;
-            /**
-             * Whether or not to set an entry for a key if that key is already present.
-             * Present only for SharedStorageAccessMethod: set.
-             */
-            ignoreIfPresent?: boolean;
-            /**
-             * A number denoting the (0-based) order of the worklet's
-             * creation relative to all other shared storage worklets created by
-             * documents using the current storage partition.
-             * Present only for SharedStorageAccessMethods: addModule, createWorklet.
-             */
-            workletOrdinal?: integer;
-            /**
-             * Hex representation of the DevTools token used as the TargetID for the
-             * associated shared storage worklet.
-             * Present only for SharedStorageAccessMethods: addModule, createWorklet,
-             * run, selectURL, and any other SharedStorageAccessMethod when the
-             * SharedStorageAccessScope is sharedStorageWorklet.
-             */
-            workletTargetId?: Target.TargetID;
-            /**
-             * Name of the lock to be acquired, if present.
-             * Optionally present only for SharedStorageAccessMethods: batchUpdate,
-             * set, append, delete, and clear.
-             */
-            withLock?: string;
-            /**
-             * If the method has been called as part of a batchUpdate, then this
-             * number identifies the batch to which it belongs.
-             * Optionally present only for SharedStorageAccessMethods:
-             * batchUpdate (required), set, append, delete, and clear.
-             */
-            batchUpdateId?: string;
-            /**
-             * Number of modifier methods sent in batch.
-             * Present only for SharedStorageAccessMethod: batchUpdate.
-             */
-            batchSize?: integer;
-        }
-
         export type StorageBucketsDurability = ('relaxed' | 'strict');
 
         export interface StorageBucket {
@@ -20313,50 +20215,6 @@ export namespace Protocol {
             didDeleteTokens: boolean;
         }
 
-        export interface GetSharedStorageMetadataRequest {
-            ownerOrigin: string;
-        }
-
-        export interface GetSharedStorageMetadataResponse {
-            metadata: SharedStorageMetadata;
-        }
-
-        export interface GetSharedStorageEntriesRequest {
-            ownerOrigin: string;
-        }
-
-        export interface GetSharedStorageEntriesResponse {
-            entries: SharedStorageEntry[];
-        }
-
-        export interface SetSharedStorageEntryRequest {
-            ownerOrigin: string;
-            key: string;
-            value: string;
-            /**
-             * If `ignoreIfPresent` is included and true, then only sets the entry if
-             * `key` doesn't already exist.
-             */
-            ignoreIfPresent?: boolean;
-        }
-
-        export interface DeleteSharedStorageEntryRequest {
-            ownerOrigin: string;
-            key: string;
-        }
-
-        export interface ClearSharedStorageEntriesRequest {
-            ownerOrigin: string;
-        }
-
-        export interface ResetSharedStorageBudgetRequest {
-            ownerOrigin: string;
-        }
-
-        export interface SetSharedStorageTrackingRequest {
-            enable: boolean;
-        }
-
         export interface SetStorageBucketTrackingRequest {
             storageKey: string;
             enable: boolean;
@@ -20458,79 +20316,6 @@ export namespace Protocol {
             bucketId: string;
         }
 
-        /**
-         * Shared storage was accessed by the associated page.
-         * The following parameters are included in all events.
-         */
-        export interface SharedStorageAccessedEvent {
-            /**
-             * Time of the access.
-             */
-            accessTime: Network.TimeSinceEpoch;
-            /**
-             * Enum value indicating the access scope.
-             */
-            scope: SharedStorageAccessScope;
-            /**
-             * Enum value indicating the Shared Storage API method invoked.
-             */
-            method: SharedStorageAccessMethod;
-            /**
-             * DevTools Frame Token for the primary frame tree's root.
-             */
-            mainFrameId: Page.FrameId;
-            /**
-             * Serialization of the origin owning the Shared Storage data.
-             */
-            ownerOrigin: string;
-            /**
-             * Serialization of the site owning the Shared Storage data.
-             */
-            ownerSite: string;
-            /**
-             * The sub-parameters wrapped by `params` are all optional and their
-             * presence/absence depends on `type`.
-             */
-            params: SharedStorageAccessParams;
-        }
-
-        /**
-         * A shared storage run or selectURL operation finished its execution.
-         * The following parameters are included in all events.
-         */
-        export interface SharedStorageWorkletOperationExecutionFinishedEvent {
-            /**
-             * Time that the operation finished.
-             */
-            finishedTime: Network.TimeSinceEpoch;
-            /**
-             * Time, in microseconds, from start of shared storage JS API call until
-             * end of operation execution in the worklet.
-             */
-            executionTime: integer;
-            /**
-             * Enum value indicating the Shared Storage API method invoked.
-             */
-            method: SharedStorageAccessMethod;
-            /**
-             * ID of the operation call.
-             */
-            operationId: string;
-            /**
-             * Hex representation of the DevTools token used as the TargetID for the
-             * associated shared storage worklet.
-             */
-            workletTargetId: Target.TargetID;
-            /**
-             * DevTools Frame Token for the primary frame tree's root.
-             */
-            mainFrameId: Page.FrameId;
-            /**
-             * Serialization of the origin owning the Shared Storage data.
-             */
-            ownerOrigin: string;
-        }
-
         export interface StorageBucketCreatedOrUpdatedEvent {
             bucketInfo: StorageBucketInfo;
         }
@@ -22106,6 +21891,10 @@ export namespace Protocol {
              * A hint indicating that the tool output may contain untrusted content, ex: UGC, 3rd party data.
              */
             untrustedContent?: boolean;
+            /**
+             * A hint indicating that executing the tool will result in consequential actions, ex: booking a flight, transferring money.
+             */
+            consequential?: boolean;
             /**
              * If the declarative tool was declared with the autosubmit attribute.
              */