@types/chrome 0.0.256 → 0.0.258

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (http://developer.chrome.com/e
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Fri, 05 Jan 2024 07:06:59 GMT
+ * Last updated: Wed, 17 Jan 2024 07:06:54 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/index.d.ts

@@ -5394,6 +5394,86 @@ declare namespace chrome.input.ime {
     export var onReset: InputResetEvent;
 }
 
+/**
+ * Use chrome.instanceID to access the Instance ID service.
+ * Permissions: "gcm"
+ * @since Chrome 44.
+ */
+declare namespace chrome.instanceID {
+    export interface TokenRefreshEvent extends chrome.events.Event<() => void> {}
+
+    /**
+     * Resets the app instance identifier and revokes all tokens associated with it.
+     *
+     * The `deleteID()` method doesn't return any value, but can be used with a callback or asynchronously,
+     * with a Promise (MV3 only).
+     */
+    export function deleteID(): Promise<void>;
+    export function deleteID(callback: () => void): void;
+
+    interface DeleteTokenParams {
+        /**
+         * Identifies the entity that is authorized to access resources associated with this Instance ID.
+         * It can be a project ID from Google developer console.
+         */
+        authorizedEntity: string;
+        /**
+         * Identifies authorized actions that the authorized entity can take.
+         * In other words, the scope that is used to obtain the token.
+         * E.g. for sending GCM messages, `GCM` scope should be used.
+         */
+        scope: string;
+    }
+    /**
+     * Revoked a granted token.
+     *
+     * The `deleteToken()` method doesn't return any value, but can be used with a callback or
+     * asynchronously, with a Promise (MV3 only).
+     */
+    export function deleteToken(deleteTokenParams: DeleteTokenParams): Promise<void>;
+    export function deleteToken(
+        deleteTokenParams: DeleteTokenParams,
+        callback: () => void,
+    ): void;
+
+    /**
+     * Retrieves the time when the InstanceID has been generated.
+     *
+     * @return The time when the Instance ID has been generated, represented in milliseconds since the epoch.
+     * It can return via a callback or asynchronously, with a Promise (MV3 only).
+     */
+    export function getCreationTime(): Promise<number>;
+    export function getCreationTime(callback: (creationTime: number) => void): void;
+
+    /**
+     * Retrieves an identifier for the app instance.
+     * The same ID will be returned as long as the application identity has not been revoked or expired.
+     *
+     * @return An Instance ID assigned to the app instance. Can be returned by a callback or a Promise (MV3 only).
+     */
+    export function getID(): Promise<string>;
+    export function getID(callback: (instanceID: string) => void): void;
+
+    interface GetTokenParams extends DeleteTokenParams {
+        /**
+         * Allows including a small number of string key/value pairs that will be associated with the token
+         * and may be used in processing the request.
+         *
+         * @deprecated Since Chrome 89. `options` are deprecated and will be ignored.
+         */
+        options?: { [key: string]: string };
+    }
+    /**
+     * Return a token that allows the authorized entity to access the service defined by scope.
+     *
+     * @return A token assigned by the requested service. Can be returned by a callback or a Promise (MV3 only).
+     */
+    export function getToken(getTokenParams: GetTokenParams): Promise<string>;
+    export function getToken(getTokenParams: GetTokenParams, callback: (token: string) => void): void;
+
+    export var onTokenRefresh: TokenRefreshEvent;
+}
+
 ////////////////////
 // LoginState
 ////////////////////
@@ -6957,6 +7037,14 @@ declare namespace chrome.runtime {
     export type PlatformArch = "arm" | "arm64" | "x86-32" | "x86-64" | "mips" | "mips64";
     /** https://developer.chrome.com/docs/extensions/reference/runtime/#type-PlatformNaclArch */
     export type PlatformNaclArch = "arm" | "x86-32" | "x86-64" | "mips" | "mips64";
+    /** https://developer.chrome.com/docs/extensions/reference/api/runtime#type-ContextFilter */
+    export enum ContextType {
+        TAB = "TAB",
+        POPUP = "POPUP",
+        BACKGROUND = "BACKGROUND",
+        OFFSCREEN_DOCUMENT = "OFFSCREEN_DOCUMENT",
+        SIDE_PANEL = "SIDE_PANEL",
+    }
     /** https://developer.chrome.com/docs/extensions/reference/runtime/#type-OnInstalledReason */
     export enum OnInstalledReason {
         INSTALL = "install",
@@ -6970,6 +7058,22 @@ declare namespace chrome.runtime {
         message?: string | undefined;
     }
 
+    /**
+     * A filter to match against certain extension contexts. Matching contexts must match all specified filters; any filter that is not specified matches all available contexts. Thus, a filter of `{}` will match all available contexts.
+     * @since Chrome 114.
+     */
+    export interface ContextFilter {
+        contextIds?: string[] | undefined;
+        contextTypes?: ContextType[] | undefined;
+        documentIds?: string[] | undefined;
+        documentOrigins?: string[] | undefined;
+        documentUrls?: string[] | undefined;
+        frameIds?: number[] | undefined;
+        incognito?: boolean | undefined;
+        tabIds?: number[] | undefined;
+        windowIds?: number[] | undefined;
+    }
+
     export interface ConnectInfo {
         name?: string | undefined;
         includeTlsChannelId?: boolean | undefined;
@@ -6993,6 +7097,40 @@ declare namespace chrome.runtime {
         id?: string | undefined;
     }
 
+    /**
+     * A context hosting extension content.
+     * @since Chrome 114.
+     */
+    export interface ExtensionContext {
+        /** A unique identifier for this context */
+        contextId: string;
+        /** The type of context this corresponds to. */
+        contextType: ContextType;
+        /**
+         * Optional.
+         * A UUID for the document associated with this context, or undefined if this context is hosted not in a document.
+         */
+        documentId?: string | undefined;
+        /**
+         * Optional.
+         * The origin of the document associated with this context, or undefined if the context is not hosted in a document.
+         */
+        documentOrigin?: string | undefined;
+        /**
+         * Optional.
+         * The URL of the document associated with this context, or undefined if the context is not hosted in a document.
+         */
+        documentUrl?: string | undefined;
+        /** The ID of the frame for this context, or -1 if this context is not hosted in a frame. */
+        frameId: number;
+        /** Whether the context is associated with an incognito profile. */
+        incognito: boolean;
+        /** The ID of the tab for this context, or -1 if this context is not hosted in a tab. */
+        tabId: number;
+        /** The ID of the window for this context, or -1 if this context is not hosted in a window. */
+        windowId: number;
+    }
+
     export interface MessageOptions {
         /** Whether the TLS channel ID will be passed into onMessageExternal for processes that are listening for the connection event. */
         includeTlsChannelId?: boolean | undefined;
@@ -7492,6 +7630,21 @@ declare namespace chrome.runtime {
     export function connectNative(application: string): Port;
     /** Retrieves the JavaScript 'window' object for the background page running inside the current extension/app. If the background page is an event page, the system will ensure it is loaded before calling the callback. If there is no background page, an error is set. */
     export function getBackgroundPage(callback: (backgroundPage?: Window) => void): void;
+    /**
+     * Fetches information about active contexts associated with this extension
+     * @since Chrome 116 MV3.
+     * @return Provides the matching context, if any via callback or returned as a `Promise` (MV3 only).
+     * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
+     */
+    export function getContexts(filter: ContextFilter): Promise<ExtensionContext[]>;
+    /**
+     * Fetches information about active contexts associated with this extension
+     * @since Chrome 116 MV3.
+     * @return Provides the matching context, if any via callback or returned as a `Promise` (MV3 only).
+     * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
+     * @param callback Called with results
+     */
+    export function getContexts(filter: ContextFilter, callback: (contexts: ExtensionContext[]) => void): void;
     /**
      * Returns details about the app or extension from the manifest. The object returned is a serialization of the full manifest file.
      * @return The manifest details.

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.0.256",
+    "version": "0.0.258",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -93,6 +93,6 @@
         "@types/filesystem": "*",
         "@types/har-format": "*"
     },
-    "typesPublisherContentHash": "c2685c92f0b761556508a66a51a25539da302cf89a4e3dc1a341bc0142c6871f",
+    "typesPublisherContentHash": "581693ead7a4b515a196100a0b909475c8e789d7eccb65e95f3bc6e2faedafc1",
     "typeScriptVersion": "4.6"
 }