* Called using either a chrome tab object or by id * get({tabId: ###}); * @returns {Tab|undefined}

* @param {string} featureName * @param {string} subFeatureName * @param {string} [cohortName] * @returns {boolean}

* * @param {Config} configValue

* Checks different toggles we have in the application: * - User toggle off * - Remotely disable it * - tempAllowlist * -

* Generates a declarativeNetRequest rule with the given details. * * @overload * @param {Omit<generateDNRRuleDetails, 'id'>} ruleDetails * @return

* @param {string} key * @param {number} [now] optional timestamp to use as the current time

* @template {InstanceType<typeof TabState>} T * @template {keyof T} K * @param {K} key * @param {T[K]} value

* This will be called for every 'blocked' event. It can be called many times * and in quick succession, hence the debouncing * * @param

* * @param {string} featureName * @param {string} subFeatureName * @returns {string | null}

* Generates a declarativeNetRequest ruleset for the given block list and * compares that to an expected ruleset. Optionally also compares the generat

* Generated an extension configuration declarativeNetRequest ruleset. * @param {object} extensionConfig * The extension configuration. * @param {

* Enqueue a request to the native app and wait for a response, * blocking subsequent callers until the request is complete. * If cacheKey an

* @param {number} tabId * @param {string} action * @param {any} message

* Stores the given values in the given lookup for the given key. Takes care to * create the values array for the key if it doesn't already exist. Han

* @param {string} host * @returns {Promise<Boolean>}

* Converts a Tracker Blocking configuration into a declarativeNetRequest * ruleset that blocks/redirects requests to known trackers. * @param {objec

* This will allowlist any open tabs with the same domain * * @param {object} data * @param {allowlistName} data.list - name of the allo

* Send a request to the native app and wait for a response. * * @param {string} method - The method name to call on the native side * @

* @param {OnUpdatedCallback} cb

* Persist data into the extensions storage in the following format

* @param {number} [now] - optional timestamp to use as the current time * @return {PlainEntries}

* Every hour, pack up the current entries and start a new pack * @param {number} [now] optional timestamp to use as the current time

* Enqueue a notification message to be sent to the native app. * @param {string} method * @param {Record<string, any>} params

* Get the user's assigned cohort for this feature and subfeature * @param {string} featureName * @param {string} subFeatureName * @retu

* Mark that the user should be enrolled in the experiment for the given feature and sub feature. * * This will send the enrollment * @p

* Check if the toggle report UI flow should been displayed display for the * currently focused tab. * * @returns {Promise<boolean>}

* Load the given declarativeNetRequest rules into the test * extension. * @param {object[]} rules * The rules to add.

* @param {string} host * @returns {Boolean|null}

* Build HTTP cookie blocking rules from the blocklist and cookie configuration * @param {import('./utils').TDS} tds The tracker blocklist * @param {

* Converts a list of HTTPS enabled domains into a declarativeNetRequest ruleset * that upgrades HTTP requests to HTTPS for those domains. * @param {

* Modify resource data in-place * @param {(data: any) => any} func

* @param t * @param {string} baseDomain * @param {string} url * @returns {Tracker}

* @param {string} url either domain (example.com) or a full URL (http://example.com/about) * @returns {null|boolean|Promise<boolean>} returns tru

* Helper to cast JavaScript strings to the TypeScript enum types expected by * @types/chrome for declarativeNetRequest rules. Does not change the pro

* @param {object} params * @param {number} params.totalCount * @param {Pack} params.current * @param {Pack[]} params.packs

* @param {*} backgroundPage * @returns {Promise<import('@playwright/test').JSHandle>}

* * @param {string} featureName * @param {string} subFeatureName * @param {ChosenCohort | null} cohort

* Only the dashboard sends this message, so we import the types from there. * @param {import('@duckduckgo/privacy-dashboard/schema/__generated__/

* @param {import('../helpers/requests').LoggedRequestDetails[]} requests

* Used for removing the stored tab state. * @param {number} tabId

* @param {string} urlToCheck * @param {string} siteUrl * @param {RequestExpression} request * @param {Set<string>} [supportedCustomRule