Storage

This CDP domain is experimental.

• Types

• Commands

• Events

Types

Generally, you do not need to instantiate CDP types yourself. Instead, the API creates objects for you as return values from commands, and then you can use those objects as arguments to other commands.

class SerializedStorageKey

class StorageType(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Enum of possible storage types.

COOKIES = 'cookies'

FILE_SYSTEMS = 'file_systems'

INDEXEDDB = 'indexeddb'

LOCAL_STORAGE = 'local_storage'

SHADER_CACHE = 'shader_cache'

WEBSQL = 'websql'

SERVICE_WORKERS = 'service_workers'

CACHE_STORAGE = 'cache_storage'

INTEREST_GROUPS = 'interest_groups'

SHARED_STORAGE = 'shared_storage'

STORAGE_BUCKETS = 'storage_buckets'

ALL_ = 'all'

OTHER = 'other'

class UsageForType(storage_type, usage)

Usage for a storage type.

storage_type: StorageType

Name of storage type.

usage: float

Storage usage (bytes).

class TrustTokens(issuer_origin, count)

Pair of issuer origin and number of available (signed, but not used) Trust Tokens from that issuer.

issuer_origin: str

count: float

class InterestGroupAuctionId

Protected audience interest group auction identifier.

class InterestGroupAccessType(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Enum of interest group access types.

JOIN = 'join'

LEAVE = 'leave'

UPDATE = 'update'

LOADED = 'loaded'

BID = 'bid'

WIN = 'win'

ADDITIONAL_BID = 'additionalBid'

ADDITIONAL_BID_WIN = 'additionalBidWin'

TOP_LEVEL_BID = 'topLevelBid'

TOP_LEVEL_ADDITIONAL_BID = 'topLevelAdditionalBid'

CLEAR = 'clear'

class InterestGroupAuctionEventType(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Enum of auction events.

STARTED = 'started'

CONFIG_RESOLVED = 'configResolved'

class InterestGroupAuctionFetchType(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Enum of network fetches auctions can do.

BIDDER_JS = 'bidderJs'

BIDDER_WASM = 'bidderWasm'

SELLER_JS = 'sellerJs'

BIDDER_TRUSTED_SIGNALS = 'bidderTrustedSignals'

SELLER_TRUSTED_SIGNALS = 'sellerTrustedSignals'

class SharedStorageAccessScope(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Enum of shared storage access scopes.

WINDOW = 'window'

SHARED_STORAGE_WORKLET = 'sharedStorageWorklet'

PROTECTED_AUDIENCE_WORKLET = 'protectedAudienceWorklet'

HEADER = 'header'

class SharedStorageAccessMethod(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

Enum of shared storage access methods.

ADD_MODULE = 'addModule'

CREATE_WORKLET = 'createWorklet'

SELECT_URL = 'selectURL'

RUN = 'run'

BATCH_UPDATE = 'batchUpdate'

SET_ = 'set'

APPEND = 'append'

DELETE = 'delete'

CLEAR = 'clear'

GET = 'get'

KEYS = 'keys'

VALUES = 'values'

ENTRIES = 'entries'

LENGTH = 'length'

REMAINING_BUDGET = 'remainingBudget'

class SharedStorageEntry(key, value)

Struct for a single key-value pair in an origin’s shared storage.

key: str

value: str

class SharedStorageMetadata(creation_time, length, remaining_budget, bytes_used)

Details for an origin’s shared storage.

creation_time: TimeSinceEpoch

Time when the origin’s shared storage was last created.

length: int

Number of key-value pairs stored in origin’s shared storage.

remaining_budget: float

Current amount of bits of entropy remaining in the navigation budget.

bytes_used: int

Total number of bytes stored as key-value pairs in origin’s shared storage.

class SharedStoragePrivateAggregationConfig(filtering_id_max_bytes, aggregation_coordinator_origin=None, context_id=None, max_contributions=None)

Represents a dictionary object passed in as privateAggregationConfig to run or selectURL.

filtering_id_max_bytes: int

Configures the maximum size allowed for filtering IDs.

aggregation_coordinator_origin: Optional[str] = None

The chosen aggregation service deployment.

context_id: Optional[str] = None

The context ID provided.

max_contributions: Optional[int] = None

The limit on the number of contributions in the final report.

class SharedStorageReportingMetadata(event_type, reporting_url)

Pair of reporting metadata details for a candidate URL for selectURL().

event_type: str

reporting_url: str

class SharedStorageUrlWithMetadata(url, reporting_metadata)

Bundles a candidate URL with its reporting metadata.

url: str

Spec of candidate URL.

reporting_metadata: List[SharedStorageReportingMetadata]

Any associated reporting metadata.

class SharedStorageAccessParams(script_source_url=None, data_origin=None, operation_name=None, operation_id=None, keep_alive=None, private_aggregation_config=None, serialized_data=None, urls_with_metadata=None, urn_uuid=None, key=None, value=None, ignore_if_present=None, worklet_ordinal=None, worklet_target_id=None, with_lock=None, batch_update_id=None, batch_size=None)

Bundles the parameters for shared storage access events whose presence/absence can vary according to SharedStorageAccessType.

script_source_url: Optional[str] = None

Spec of the module script URL. Present only for SharedStorageAccessMethods: addModule and createWorklet.

data_origin: Optional[str] = None

String denoting “context-origin”, “script-origin”, or a custom origin to be used as the worklet’s data origin. Present only for SharedStorageAccessMethod: createWorklet.

operation_name: Optional[str] = None

Name of the registered operation to be run. Present only for SharedStorageAccessMethods: run and selectURL.

operation_id: Optional[str] = None

ID of the operation call. Present only for SharedStorageAccessMethods: run and selectURL.

keep_alive: Optional[bool] = None

Whether or not to keep the worket alive for future run or selectURL calls. Present only for SharedStorageAccessMethods: run and selectURL.

private_aggregation_config: Optional[SharedStoragePrivateAggregationConfig] = None

Configures the private aggregation options. Present only for SharedStorageAccessMethods: run and selectURL.

serialized_data: Optional[str] = None

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.

urls_with_metadata: Optional[List[SharedStorageUrlWithMetadata]] = None

Array of candidate URLs’ specs, along with any associated metadata. Present only for SharedStorageAccessMethod: selectURL.

urn_uuid: Optional[str] = None

UUID generated for a selectURL call. Present only for SharedStorageAccessMethod: selectURL.

Type:

Spec of the URN

key: Optional[str] = None

Key for a specific entry in an origin’s shared storage. Present only for SharedStorageAccessMethods: set, append, delete, and get.

value: Optional[str] = None

Value for a specific entry in an origin’s shared storage. Present only for SharedStorageAccessMethods: set and append.

ignore_if_present: Optional[bool] = None

Whether or not to set an entry for a key if that key is already present. Present only for SharedStorageAccessMethod: set.

worklet_ordinal: Optional[int] = None

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.

worklet_target_id: Optional[TargetID] = None

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.

with_lock: Optional[str] = None

Name of the lock to be acquired, if present. Optionally present only for SharedStorageAccessMethods: batchUpdate, set, append, delete, and clear.

batch_update_id: Optional[str] = None

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.

batch_size: Optional[int] = None

Number of modifier methods sent in batch. Present only for SharedStorageAccessMethod: batchUpdate.

class StorageBucketsDurability(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

RELAXED = 'relaxed'

STRICT = 'strict'

class StorageBucket(storage_key, name=None)

storage_key: SerializedStorageKey

name: Optional[str] = None

If not specified, it is the default bucket of the storageKey.

class StorageBucketInfo(bucket, id_, expiration, quota, persistent, durability)

bucket: StorageBucket

id_: str

expiration: TimeSinceEpoch

quota: float

Storage quota (bytes).

persistent: bool

durability: StorageBucketsDurability

class AttributionReportingSourceType(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

NAVIGATION = 'navigation'

EVENT = 'event'

class UnsignedInt64AsBase10

class UnsignedInt128AsBase16

class SignedInt64AsBase10

class AttributionReportingFilterDataEntry(key, values)

key: str

values: List[str]

class AttributionReportingFilterConfig(filter_values, lookback_window=None)

filter_values: List[AttributionReportingFilterDataEntry]

lookback_window: Optional[int] = None

duration in seconds

class AttributionReportingFilterPair(filters, not_filters)

filters: List[AttributionReportingFilterConfig]

not_filters: List[AttributionReportingFilterConfig]

class AttributionReportingAggregationKeysEntry(key, value)

key: str

value: UnsignedInt128AsBase16

class AttributionReportingEventReportWindows(start, ends)

start: int

duration in seconds

ends: List[int]

duration in seconds

class AttributionReportingTriggerDataMatching(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

EXACT = 'exact'

MODULUS = 'modulus'

class AttributionReportingAggregatableDebugReportingData(key_piece, value, types)

key_piece: UnsignedInt128AsBase16

value: float

number instead of integer because not all uint32 can be represented by int

types: List[str]

class AttributionReportingAggregatableDebugReportingConfig(key_piece, debug_data, budget=None, aggregation_coordinator_origin=None)

key_piece: UnsignedInt128AsBase16

debug_data: List[AttributionReportingAggregatableDebugReportingData]

budget: Optional[float] = None

number instead of integer because not all uint32 can be represented by int, only present for source registrations

aggregation_coordinator_origin: Optional[str] = None

class AttributionScopesData(values, limit, max_event_states)

values: List[str]

limit: float

number instead of integer because not all uint32 can be represented by int

max_event_states: float

class AttributionReportingNamedBudgetDef(name, budget)

name: str

budget: int

class AttributionReportingSourceRegistration(time, expiry, trigger_data, event_report_windows, aggregatable_report_window, type_, source_origin, reporting_origin, destination_sites, event_id, priority, filter_data, aggregation_keys, trigger_data_matching, destination_limit_priority, aggregatable_debug_reporting_config, max_event_level_reports, named_budgets, debug_reporting, event_level_epsilon, debug_key=None, scopes_data=None)

time: TimeSinceEpoch

expiry: int

duration in seconds

trigger_data: List[float]

number instead of integer because not all uint32 can be represented by int

event_report_windows: AttributionReportingEventReportWindows

aggregatable_report_window: int

duration in seconds

type_: AttributionReportingSourceType

source_origin: str

reporting_origin: str

destination_sites: List[str]

event_id: UnsignedInt64AsBase10

priority: SignedInt64AsBase10

filter_data: List[AttributionReportingFilterDataEntry]

aggregation_keys: List[AttributionReportingAggregationKeysEntry]

trigger_data_matching: AttributionReportingTriggerDataMatching

destination_limit_priority: SignedInt64AsBase10

aggregatable_debug_reporting_config: AttributionReportingAggregatableDebugReportingConfig

max_event_level_reports: int

named_budgets: List[AttributionReportingNamedBudgetDef]

debug_reporting: bool

event_level_epsilon: float

debug_key: Optional[UnsignedInt64AsBase10] = None

scopes_data: Optional[AttributionScopesData] = None

class AttributionReportingSourceRegistrationResult(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

SUCCESS = 'success'

INTERNAL_ERROR = 'internalError'

INSUFFICIENT_SOURCE_CAPACITY = 'insufficientSourceCapacity'

INSUFFICIENT_UNIQUE_DESTINATION_CAPACITY = 'insufficientUniqueDestinationCapacity'

EXCESSIVE_REPORTING_ORIGINS = 'excessiveReportingOrigins'

PROHIBITED_BY_BROWSER_POLICY = 'prohibitedByBrowserPolicy'

SUCCESS_NOISED = 'successNoised'

DESTINATION_REPORTING_LIMIT_REACHED = 'destinationReportingLimitReached'

DESTINATION_GLOBAL_LIMIT_REACHED = 'destinationGlobalLimitReached'

DESTINATION_BOTH_LIMITS_REACHED = 'destinationBothLimitsReached'

REPORTING_ORIGINS_PER_SITE_LIMIT_REACHED = 'reportingOriginsPerSiteLimitReached'

EXCEEDS_MAX_CHANNEL_CAPACITY = 'exceedsMaxChannelCapacity'

EXCEEDS_MAX_SCOPES_CHANNEL_CAPACITY = 'exceedsMaxScopesChannelCapacity'

EXCEEDS_MAX_TRIGGER_STATE_CARDINALITY = 'exceedsMaxTriggerStateCardinality'

EXCEEDS_MAX_EVENT_STATES_LIMIT = 'exceedsMaxEventStatesLimit'

DESTINATION_PER_DAY_REPORTING_LIMIT_REACHED = 'destinationPerDayReportingLimitReached'

class AttributionReportingSourceRegistrationTimeConfig(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

INCLUDE = 'include'

EXCLUDE = 'exclude'

class AttributionReportingAggregatableValueDictEntry(key, value, filtering_id)

key: str

value: float

number instead of integer because not all uint32 can be represented by int

filtering_id: UnsignedInt64AsBase10

class AttributionReportingAggregatableValueEntry(values, filters)

values: List[AttributionReportingAggregatableValueDictEntry]

filters: AttributionReportingFilterPair

class AttributionReportingEventTriggerData(data, priority, filters, dedup_key=None)

data: UnsignedInt64AsBase10

priority: SignedInt64AsBase10

filters: AttributionReportingFilterPair

dedup_key: Optional[UnsignedInt64AsBase10] = None

class AttributionReportingAggregatableTriggerData(key_piece, source_keys, filters)

key_piece: UnsignedInt128AsBase16

source_keys: List[str]

filters: AttributionReportingFilterPair

class AttributionReportingAggregatableDedupKey(filters, dedup_key=None)

filters: AttributionReportingFilterPair

dedup_key: Optional[UnsignedInt64AsBase10] = None

class AttributionReportingNamedBudgetCandidate(filters, name=None)

filters: AttributionReportingFilterPair

name: Optional[str] = None

class AttributionReportingTriggerRegistration(filters, aggregatable_dedup_keys, event_trigger_data, aggregatable_trigger_data, aggregatable_values, aggregatable_filtering_id_max_bytes, debug_reporting, source_registration_time_config, aggregatable_debug_reporting_config, scopes, named_budgets, debug_key=None, aggregation_coordinator_origin=None, trigger_context_id=None)

filters: AttributionReportingFilterPair

aggregatable_dedup_keys: List[AttributionReportingAggregatableDedupKey]

event_trigger_data: List[AttributionReportingEventTriggerData]

aggregatable_trigger_data: List[AttributionReportingAggregatableTriggerData]

aggregatable_values: List[AttributionReportingAggregatableValueEntry]

aggregatable_filtering_id_max_bytes: int

debug_reporting: bool

source_registration_time_config: AttributionReportingSourceRegistrationTimeConfig

aggregatable_debug_reporting_config: AttributionReportingAggregatableDebugReportingConfig

scopes: List[str]

named_budgets: List[AttributionReportingNamedBudgetCandidate]

debug_key: Optional[UnsignedInt64AsBase10] = None

aggregation_coordinator_origin: Optional[str] = None

trigger_context_id: Optional[str] = None

class AttributionReportingEventLevelResult(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

SUCCESS = 'success'

SUCCESS_DROPPED_LOWER_PRIORITY = 'successDroppedLowerPriority'

INTERNAL_ERROR = 'internalError'

NO_CAPACITY_FOR_ATTRIBUTION_DESTINATION = 'noCapacityForAttributionDestination'

NO_MATCHING_SOURCES = 'noMatchingSources'

DEDUPLICATED = 'deduplicated'

EXCESSIVE_ATTRIBUTIONS = 'excessiveAttributions'

PRIORITY_TOO_LOW = 'priorityTooLow'

NEVER_ATTRIBUTED_SOURCE = 'neverAttributedSource'

EXCESSIVE_REPORTING_ORIGINS = 'excessiveReportingOrigins'

NO_MATCHING_SOURCE_FILTER_DATA = 'noMatchingSourceFilterData'

PROHIBITED_BY_BROWSER_POLICY = 'prohibitedByBrowserPolicy'

NO_MATCHING_CONFIGURATIONS = 'noMatchingConfigurations'

EXCESSIVE_REPORTS = 'excessiveReports'

FALSELY_ATTRIBUTED_SOURCE = 'falselyAttributedSource'

REPORT_WINDOW_PASSED = 'reportWindowPassed'

NOT_REGISTERED = 'notRegistered'

REPORT_WINDOW_NOT_STARTED = 'reportWindowNotStarted'

NO_MATCHING_TRIGGER_DATA = 'noMatchingTriggerData'

class AttributionReportingAggregatableResult(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

SUCCESS = 'success'

INTERNAL_ERROR = 'internalError'

NO_CAPACITY_FOR_ATTRIBUTION_DESTINATION = 'noCapacityForAttributionDestination'

NO_MATCHING_SOURCES = 'noMatchingSources'

EXCESSIVE_ATTRIBUTIONS = 'excessiveAttributions'

EXCESSIVE_REPORTING_ORIGINS = 'excessiveReportingOrigins'

NO_HISTOGRAMS = 'noHistograms'

INSUFFICIENT_BUDGET = 'insufficientBudget'

INSUFFICIENT_NAMED_BUDGET = 'insufficientNamedBudget'

NO_MATCHING_SOURCE_FILTER_DATA = 'noMatchingSourceFilterData'

NOT_REGISTERED = 'notRegistered'

PROHIBITED_BY_BROWSER_POLICY = 'prohibitedByBrowserPolicy'

DEDUPLICATED = 'deduplicated'

REPORT_WINDOW_PASSED = 'reportWindowPassed'

EXCESSIVE_REPORTS = 'excessiveReports'

class AttributionReportingReportResult(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

SENT = 'sent'

PROHIBITED = 'prohibited'

FAILED_TO_ASSEMBLE = 'failedToAssemble'

EXPIRED = 'expired'

class RelatedWebsiteSet(primary_sites, associated_sites, service_sites)

A single Related Website Set object.

primary_sites: List[str]

The primary site of this set, along with the ccTLDs if there is any.

associated_sites: List[str]

The associated sites of this set, along with the ccTLDs if there is any.

service_sites: List[str]

The service sites of this set, along with the ccTLDs if there is any.

Commands

Each command is a generator function. The return type Generator[x, y, z] indicates that the generator yields arguments of type x, it must be resumed with an argument of type y, and it returns type z. In this library, types x and y are the same for all commands, and z is the return type you should pay attention to. For more information, see Getting Started: Commands.

clear_cookies(browser_context_id=None)

Clears cookies.

Parameters:

browser_context_id (Optional[BrowserContextID]) – (Optional) Browser context to use when called on the browser endpoint.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

clear_data_for_origin(origin, storage_types)

Clears storage for origin.

Parameters:

• origin (str) – Security origin.

• storage_types (str) – Comma separated list of StorageType to clear.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

clear_data_for_storage_key(storage_key, storage_types)

Clears storage for storage key.

Parameters:

• storage_key (str) – Storage key.

• storage_types (str) – Comma separated list of StorageType to clear.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

clear_shared_storage_entries(owner_origin)

Clears all entries for a given origin’s shared storage.

EXPERIMENTAL

Parameters:

owner_origin (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

clear_trust_tokens(issuer_origin)

Removes all Trust Tokens issued by the provided issuerOrigin. Leaves other stored data, including the issuer’s Redemption Records, intact.

EXPERIMENTAL

Parameters:

issuer_origin (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], bool]

Returns:

True if any tokens were deleted, false otherwise.

delete_shared_storage_entry(owner_origin, key)

Deletes entry for key (if it exists) for a given origin’s shared storage.

EXPERIMENTAL

Parameters:

• owner_origin (str) –

• key (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

delete_storage_bucket(bucket)

Deletes the Storage Bucket with the given storage key and bucket name.

EXPERIMENTAL

Parameters:

bucket (StorageBucket) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

get_affected_urls_for_third_party_cookie_metadata(first_party_url, third_party_urls)

Returns the list of URLs from a page and its embedded resources that match existing grace period URL pattern rules. https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period

EXPERIMENTAL

Parameters:

• first_party_url (str) – The URL of the page currently being visited.

• third_party_urls (List[str]) – The list of embedded resource URLs from the page.

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[str]]

Returns:

Array of matching URLs. If there is a primary pattern match for the first- party URL, only the first-party URL is returned in the array.

get_cookies(browser_context_id=None)

Returns all browser cookies.

Parameters:

browser_context_id (Optional[BrowserContextID]) – (Optional) Browser context to use when called on the browser endpoint.

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[Cookie]]

Returns:

Array of cookie objects.

get_interest_group_details(owner_origin, name)

Gets details for a named interest group.

EXPERIMENTAL

Parameters:

• owner_origin (str) –

• name (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], dict]

Returns:

This largely corresponds to: https://wicg.github.io/turtledove/#dictdef-generatebidinterestgroup but has absolute expirationTime instead of relative lifetimeMs and also adds joiningOrigin.

get_related_website_sets()

Returns the effective Related Website Sets in use by this profile for the browser session. The effective Related Website Sets will not change during a browser session.

EXPERIMENTAL

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[RelatedWebsiteSet]]

Returns:

get_shared_storage_entries(owner_origin)

Gets the entries in an given origin’s shared storage.

EXPERIMENTAL

Parameters:

owner_origin (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[SharedStorageEntry]]

Returns:

get_shared_storage_metadata(owner_origin)

Gets metadata for an origin’s shared storage.

EXPERIMENTAL

Parameters:

owner_origin (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], SharedStorageMetadata]

Returns:

get_storage_key_for_frame(frame_id)

Returns a storage key given a frame id.

Parameters:

frame_id (FrameId) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], SerializedStorageKey]

Returns:

get_trust_tokens()

Returns the number of stored Trust Tokens per issuer for the current browsing context.

EXPERIMENTAL

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[TrustTokens]]

Returns:

get_usage_and_quota(origin)

Returns usage and quota in bytes.

Parameters:

origin (str) – Security origin.

Return type:

Generator[Dict[str, Any], Dict[str, Any], Tuple[float, float, bool, List[UsageForType]]]

Returns:

A tuple with the following items:

0. usage - Storage usage (bytes).

1. quota - Storage quota (bytes).

2. overrideActive - Whether or not the origin has an active storage quota override

3. usageBreakdown - Storage usage per type (bytes).

override_quota_for_origin(origin, quota_size=None)

Override quota for the specified origin

EXPERIMENTAL

Parameters:

• origin (str) – Security origin.

• quota_size (Optional[float]) – (Optional) The quota size (in bytes) to override the original quota with. If this is called multiple times, the overridden quota will be equal to the quotaSize provided in the final call. If this is called without specifying a quotaSize, the quota will be reset to the default value for the specified origin. If this is called multiple times with different origins, the override will be maintained for each origin until it is disabled (called without a quotaSize).

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

reset_shared_storage_budget(owner_origin)

Resets the budget for ownerOrigin by clearing all budget withdrawals.

EXPERIMENTAL

Parameters:

owner_origin (str) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

run_bounce_tracking_mitigations()

Deletes state for sites identified as potential bounce trackers, immediately.

EXPERIMENTAL

Return type:

Generator[Dict[str, Any], Dict[str, Any], List[str]]

Returns:

send_pending_attribution_reports()

Sends all pending Attribution Reports immediately, regardless of their scheduled report time.

EXPERIMENTAL

Return type:

Generator[Dict[str, Any], Dict[str, Any], int]

Returns:

The number of reports that were sent.

set_attribution_reporting_local_testing_mode(enabled)

https://wicg.github.io/attribution-reporting-api/

EXPERIMENTAL

Parameters:

enabled (bool) – If enabled, noise is suppressed and reports are sent immediately.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_attribution_reporting_tracking(enable)

Enables/disables issuing of Attribution Reporting events.

EXPERIMENTAL

Parameters:

enable (bool) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_cookies(cookies, browser_context_id=None)

Sets given cookies.

Parameters:

• cookies (List[CookieParam]) – Cookies to be set.

• browser_context_id (Optional[BrowserContextID]) – (Optional) Browser context to use when called on the browser endpoint.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_interest_group_auction_tracking(enable)

Enables/Disables issuing of interestGroupAuctionEventOccurred and interestGroupAuctionNetworkRequestCreated.

EXPERIMENTAL

Parameters:

enable (bool) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_interest_group_tracking(enable)

Enables/Disables issuing of interestGroupAccessed events.

EXPERIMENTAL

Parameters:

enable (bool) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_protected_audience_k_anonymity(owner, name, hashes)

Parameters:

• owner (str) –

• name (str) –

• hashes (List[str]) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_shared_storage_entry(owner_origin, key, value, ignore_if_present=None)

Sets entry with key and value for a given origin’s shared storage.

EXPERIMENTAL

Parameters:

• owner_origin (str) –

• key (str) –

• value (str) –

• ignore_if_present (Optional[bool]) – (Optional) If `ignoreIfPresent`` is included and true, then only sets the entry if ``key` doesn’t already exist.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_shared_storage_tracking(enable)

Enables/disables issuing of sharedStorageAccessed events.

EXPERIMENTAL

Parameters:

enable (bool) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

set_storage_bucket_tracking(storage_key, enable)

Set tracking for a storage key’s buckets.

EXPERIMENTAL

Parameters:

• storage_key (str) –

• enable (bool) –

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

track_cache_storage_for_origin(origin)

Registers origin to be notified when an update occurs to its cache storage list.

Parameters:

origin (str) – Security origin.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

track_cache_storage_for_storage_key(storage_key)

Registers storage key to be notified when an update occurs to its cache storage list.

Parameters:

storage_key (str) – Storage key.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

track_indexed_db_for_origin(origin)

Registers origin to be notified when an update occurs to its IndexedDB.

Parameters:

origin (str) – Security origin.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

track_indexed_db_for_storage_key(storage_key)

Registers storage key to be notified when an update occurs to its IndexedDB.

Parameters:

storage_key (str) – Storage key.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

untrack_cache_storage_for_origin(origin)

Unregisters origin from receiving notifications for cache storage.

Parameters:

origin (str) – Security origin.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

untrack_cache_storage_for_storage_key(storage_key)

Unregisters storage key from receiving notifications for cache storage.

Parameters:

storage_key (str) – Storage key.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

untrack_indexed_db_for_origin(origin)

Unregisters origin from receiving notifications for IndexedDB.

Parameters:

origin (str) – Security origin.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

untrack_indexed_db_for_storage_key(storage_key)

Unregisters storage key from receiving notifications for IndexedDB.

Parameters:

storage_key (str) – Storage key.

Return type:

Generator[Dict[str, Any], Dict[str, Any], None]

Events

Generally, you do not need to instantiate CDP events yourself. Instead, the API creates events for you and then you use the event’s attributes.

class CacheStorageContentUpdated(origin, storage_key, bucket_id, cache_name)

A cache’s contents have been modified.

origin: str

Origin to update.

storage_key: str

Storage key to update.

bucket_id: str

Storage bucket to update.

cache_name: str

Name of cache in origin.

class CacheStorageListUpdated(origin, storage_key, bucket_id)

A cache has been added/deleted.

origin: str

Origin to update.

storage_key: str

Storage key to update.

bucket_id: str

Storage bucket to update.

class IndexedDBContentUpdated(origin, storage_key, bucket_id, database_name, object_store_name)

The origin’s IndexedDB object store has been modified.

origin: str

Origin to update.

storage_key: str

Storage key to update.

bucket_id: str

Storage bucket to update.

database_name: str

Database to update.

object_store_name: str

ObjectStore to update.

class IndexedDBListUpdated(origin, storage_key, bucket_id)

The origin’s IndexedDB database list has been modified.

origin: str

Origin to update.

storage_key: str

Storage key to update.

bucket_id: str

Storage bucket to update.

class InterestGroupAccessed(access_time, type_, owner_origin, name, component_seller_origin, bid, bid_currency, unique_auction_id)

One of the interest groups was accessed. Note that these events are global to all targets sharing an interest group store.

access_time: TimeSinceEpoch

type_: InterestGroupAccessType

owner_origin: str

name: str

component_seller_origin: Optional[str]

For topLevelBid/topLevelAdditionalBid, and when appropriate, win and additionalBidWin

bid: Optional[float]

For bid or somethingBid event, if done locally and not on a server.

bid_currency: Optional[str]

unique_auction_id: Optional[InterestGroupAuctionId]

For non-global events — links to interestGroupAuctionEvent

class InterestGroupAuctionEventOccurred(event_time, type_, unique_auction_id, parent_auction_id, auction_config)

An auction involving interest groups is taking place. These events are target-specific.

event_time: TimeSinceEpoch

type_: InterestGroupAuctionEventType

unique_auction_id: InterestGroupAuctionId

parent_auction_id: Optional[InterestGroupAuctionId]

Set for child auctions.

auction_config: Optional[dict]

Set for started and configResolved

class InterestGroupAuctionNetworkRequestCreated(type_, request_id, auctions)

Specifies which auctions a particular network fetch may be related to, and in what role. Note that it is not ordered with respect to Network.requestWillBeSent (but will happen before loadingFinished loadingFailed).

type_: InterestGroupAuctionFetchType

request_id: RequestId

auctions: List[InterestGroupAuctionId]

This is the set of the auctions using the worklet that issued this request. In the case of trusted signals, it’s possible that only some of them actually care about the keys being queried.

class SharedStorageAccessed(access_time, scope, method, main_frame_id, owner_origin, owner_site, params)

Shared storage was accessed by the associated page. The following parameters are included in all events.

access_time: TimeSinceEpoch

Time of the access.

scope: SharedStorageAccessScope

Enum value indicating the access scope.

method: SharedStorageAccessMethod

Enum value indicating the Shared Storage API method invoked.

main_frame_id: FrameId

DevTools Frame Token for the primary frame tree’s root.

owner_origin: str

Serialization of the origin owning the Shared Storage data.

owner_site: str

Serialization of the site owning the Shared Storage data.

params: SharedStorageAccessParams

The sub-parameters wrapped by params are all optional and their presence/absence depends on type.

class SharedStorageWorkletOperationExecutionFinished(finished_time, execution_time, method, operation_id, worklet_target_id, main_frame_id, owner_origin)

A shared storage run or selectURL operation finished its execution. The following parameters are included in all events.

finished_time: TimeSinceEpoch

Time that the operation finished.

execution_time: int

Time, in microseconds, from start of shared storage JS API call until end of operation execution in the worklet.

method: SharedStorageAccessMethod

Enum value indicating the Shared Storage API method invoked.

operation_id: str

ID of the operation call.

worklet_target_id: TargetID

Hex representation of the DevTools token used as the TargetID for the associated shared storage worklet.

main_frame_id: FrameId

DevTools Frame Token for the primary frame tree’s root.

owner_origin: str

Serialization of the origin owning the Shared Storage data.

class StorageBucketCreatedOrUpdated(bucket_info)

bucket_info: StorageBucketInfo

class StorageBucketDeleted(bucket_id)

bucket_id: str

class AttributionReportingSourceRegistered(registration, result)

EXPERIMENTAL

registration: AttributionReportingSourceRegistration

result: AttributionReportingSourceRegistrationResult

class AttributionReportingTriggerRegistered(registration, event_level, aggregatable)

EXPERIMENTAL

registration: AttributionReportingTriggerRegistration

event_level: AttributionReportingEventLevelResult

aggregatable: AttributionReportingAggregatableResult

class AttributionReportingReportSent(url, body, result, net_error, net_error_name, http_status_code)

EXPERIMENTAL

url: str

body: dict

result: AttributionReportingReportResult

net_error: Optional[int]

If result is sent, populated with net/HTTP status.

net_error_name: Optional[str]

http_status_code: Optional[int]

class AttributionReportingVerboseDebugReportSent(url, body, net_error, net_error_name, http_status_code)

EXPERIMENTAL

url: str

body: Optional[List[dict]]

net_error: Optional[int]

net_error_name: Optional[str]

http_status_code: Optional[int]