@types/chrome 0.0.300 → 0.0.302

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: Thu, 30 Jan 2025 16:37:44 GMT
+ * Last updated: Fri, 07 Feb 2025 19:02:24 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

@@ -7596,6 +7596,116 @@ declare namespace chrome {
         export var onProxyError: ProxyErrorEvent;
     }
 
+    ////////////////////
+    // ReadingList
+    ////////////////////
+    /**
+     * Use the `chrome.readingList` API to read from and modify the items in the Reading List.
+     *
+     * Permissions: "readingList"
+     * @since Chrome 120, MV3
+     */
+    export namespace readingList {
+        export interface AddEntryOptions {
+            /** Will be `true` if the entry has been read. */
+            hasBeenRead: boolean;
+            /** The title of the entry. */
+            title: string;
+            /** The url of the entry. */
+            url: string;
+        }
+
+        export interface QueryInfo {
+            /** Indicates whether to search for read (`true`) or unread (`false`) items. */
+            hasBeenRead?: boolean | undefined;
+            /** A title to search for. */
+            title?: string | undefined;
+            /** A url to search for. */
+            url?: string | undefined;
+        }
+
+        export interface ReadingListEntry {
+            /** The time the entry was created. Recorded in milliseconds since Jan 1, 1970. */
+            creationTime: number;
+            /** Will be `true` if the entry has been read. */
+            hasBeenRead: boolean;
+            /** The last time the entry was updated. This value is in milliseconds since Jan 1, 1970. */
+            lastUpdateTime: number;
+            /** The title of the entry. */
+            title: string;
+            /** The url of the entry. */
+            url: string;
+        }
+
+        export interface RemoveOptions {
+            /** The url to remove. */
+            url: string;
+        }
+
+        export interface UpdateEntryOptions {
+            /** The updated read status. The existing status remains if a value isn't provided. */
+            hasBeenRead?: boolean | undefined;
+            /** The new title. The existing tile remains if a value isn't provided. */
+            title?: string | undefined;
+            /** The url that will be updated. */
+            url: string;
+        }
+
+        /**
+         * Adds an entry to the reading list if it does not exist.
+         * @since Chrome 120, MV3
+         * @param entry The entry to add to the reading list.
+         * @param callback
+         */
+        export function addEntry(entry: AddEntryOptions): Promise<void>;
+        export function addEntry(entry: AddEntryOptions, callback: () => void): void;
+
+        /**
+         * Retrieves all entries that match the `QueryInfo` properties. Properties that are not provided will not be matched.
+         * @since Chrome 120, MV3
+         * @param info The properties to search for.
+         * @param callback
+         */
+        export function query(info: QueryInfo): Promise<ReadingListEntry[]>;
+        export function query(info: QueryInfo, callback: (entries: ReadingListEntry[]) => void): void;
+
+        /**
+         * Removes an entry from the reading list if it exists.
+         * @since Chrome 120, MV3
+         * @param info The entry to remove from the reading list.
+         * @param callback
+         */
+        export function removeEntry(info: RemoveOptions): Promise<void>;
+        export function removeEntry(info: RemoveOptions, callback: () => void): void;
+
+        /**
+         * Updates a reading list entry if it exists.
+         * @since Chrome 120, MV3
+         * @param info The entry to update.
+         * @param callback
+         */
+        export function updateEntry(info: UpdateEntryOptions): Promise<void>;
+        export function updateEntry(info: UpdateEntryOptions, callback: () => void): void;
+
+        /**
+         * Triggered when a ReadingListEntry is added to the reading list.
+         * @since Chrome 120, MV3
+         */
+        export const onEntryAdded: chrome.events.Event<(entry: ReadingListEntry) => void>;
+
+        /**
+         * Triggered when a ReadingListEntry is removed from the reading list.
+         * @since Chrome 120, MV3
+         */
+        export const onEntryRemoved: chrome.events.Event<(entry: ReadingListEntry) => void>;
+
+        /**
+         * Triggered when a ReadingListEntry is updated in the reading list.
+         * @since Chrome 120, MV3
+         */
+        export const onEntryUpdated: chrome.events.Event<(entry: ReadingListEntry) => void>;
+    }
+
     ////////////////////
     // Search
     ////////////////////
@@ -14126,26 +14236,22 @@ declare namespace chrome {
          */
         export type ExecutionWorld = "MAIN" | "USER_SCRIPT";
 
-        /**
-         * Properties for configuring the user script world.
-         */
         export interface WorldProperties {
             /** Specifies the world csp. The default is the `ISOLATED` world csp. */
             csp?: string;
             /** Specifies whether messaging APIs are exposed. The default is false.*/
             messaging?: boolean;
+            /**
+             * Specifies the ID of the specific user script world to update. If not provided, updates the properties of the default user script world. Values with leading underscores (`_`) are reserved.
+             * @since Chrome 133
+             */
+            worldId?: string;
         }
 
-        /**
-         * Properties for filtering user scripts.
-         */
         export interface UserScriptFilter {
             ids?: string[];
         }
 
-        /**
-         * Properties for a registered user script.
-         */
         export interface RegisteredUserScript {
             /** If true, it will inject into all frames, even if the frame is not the top-most frame in the tab. Each frame is checked independently for URL requirements; it will not inject into child frames if the URL requirements are not met. Defaults to false, meaning that only the top frame is matched. */
             allFrames?: boolean;
@@ -14165,6 +14271,11 @@ declare namespace chrome {
             runAt?: RunAt;
             /** The JavaScript execution environment to run the script in. The default is `USER_SCRIPT` */
             world?: ExecutionWorld;
+            /**
+             * Specifies the user script world ID to execute in. If omitted, the script will execute in the default user script world. Only valid if `world` is omitted or is `USER_SCRIPT`. Values with leading underscores (`_`) are reserved.
+             * @since Chrome 133
+             */
+            worldId?: string;
         }
 
         /**
@@ -14212,6 +14323,13 @@ declare namespace chrome {
          */
         export function getScripts(filter: UserScriptFilter, callback: (scripts: RegisteredUserScript[]) => void): void;
 
+        /**
+         * Retrieves all registered world configurations.
+         * @since Chrome 133
+         */
+        export function getWorldConfigurations(): Promise<WorldProperties[]>;
+        export function getWorldConfigurations(callback: (worlds: WorldProperties[]) => void): void;
+
         /**
          * Registers one or more user scripts for this extension.
          *
@@ -14227,6 +14345,14 @@ declare namespace chrome {
          */
         export function register(scripts: RegisteredUserScript[], callback: () => void): void;
 
+        /**
+         * Resets the configuration for a user script world. Any scripts that inject into the world with the specified ID will use the default world configuration.
+         * @param worldId The ID of the user script world to reset. If omitted, resets the default world's configuration.
+         */
+        export function resetWorldConfiguration(worldId?: string): Promise<void>;
+        export function resetWorldConfiguration(worldId: string, callback: () => void): void;
+        export function resetWorldConfiguration(callback: () => void): void;
+
         /**
          * Unregisters all dynamically-registered user scripts for this extension.
          *

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.0.300",
+    "version": "0.0.302",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -94,6 +94,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "0cbcca2b19b5e0ccd0a0fdd1266a84b83ad6a9bf73b0c8a4a84e60e15f0aec1e",
+    "typesPublisherContentHash": "59f391614360d0b95023326c7a11bc865b13e26fd8b986fbf780a96c8cde90b5",
     "typeScriptVersion": "5.0"
 }