Skip to content

[pull] master from DefinitelyTyped:master #1416

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pull merged 2 commits into from
Oct 11, 2025
Merged

[pull] master from DefinitelyTyped:master #1416

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b09e28b
🤖 Merge PR #73809 [chrome] add extension_ids, use_dynamic_url to mv3 …
aeharding Oct 11, 2025
9ec7983
🤖 Merge PR #73719 [chrome] update printerProvider namespace by @erwan…
erwanjugand Oct 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
103 changes: 75 additions & 28 deletions types/chrome/index.d.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7899,58 +7899,94 @@ declare namespace chrome {
id: string;
/** Printer's human readable name. */
name: string;
/** Optional. Printer's human readable description. */
/** Printer's human readable description. */
description?: string | undefined;
}

/** Error codes returned in response to {@link onPrintRequested} event. */
export enum PrintError {
/** Specifies that the operation was completed successfully. */
OK = "OK",
/** Specifies that a general failure occured. */
FAILED = "FAILED",
/** Specifies that the print ticket is invalid. For example, the ticket is inconsistent with some capabilities, or the extension is not able to handle all settings from the ticket. */
INVALID_TICKET = "INVALID_TICKET",
/** Specifies that the document is invalid. For example, data may be corrupted or the format is incompatible with the extension. */
INVALID_DATA = "INVALID_DATA",
}

export interface PrinterCapabilities {
/** Device capabilities in CDD format. */
capabilities: any;
capabilities: { [key: string]: unknown };
}

export interface PrintJob {
/** ID of the printer which should handle the job. */
printerId: string;
/** The print job title. */
title: string;
/** Print ticket in CJT format. */
/** Print ticket in CJT format. */
ticket: { [key: string]: unknown };
/** The document content type. Supported formats are "application/pdf" and "image/pwg-raster". */
/** The document content type. Supported formats are `application/pdf` and `image/pwg-raster`. */
contentType: string;
/** Blob containing the document data to print. Format must match |contentType|. */
/** Blob containing the document data to print. Format must match `contentType`. */
document: Blob;
}

export interface PrinterRequestedEvent
extends chrome.events.Event<(resultCallback: (printerInfo: PrinterInfo[]) => void) => void>
{}

export interface PrinterInfoRequestedEvent
extends chrome.events.Event<(device: any, resultCallback: (printerInfo?: PrinterInfo) => void) => void>
{}

export interface CapabilityRequestedEvent extends
chrome.events.Event<
(printerId: string, resultCallback: (capabilities: PrinterCapabilities) => void) => void
>
{}

export interface PrintRequestedEvent
extends chrome.events.Event<(printJob: PrintJob, resultCallback: (result: string) => void) => void>
{}
/** from https://developer.chrome.com/docs/apps/reference/usb#type-Device */
export interface Device {
/** An opaque ID for the USB device. It remains unchanged until the device is unplugged. */
device: number;
/**
* The iManufacturer string read from the device, if available.
* @since Chrome 46
*/
manufacturerName: string;
/** The product ID. */
productId: number;
/**
* The iProduct string read from the device, if available.
* @since Chrome 46
*/
productName: string;
/**
* The iSerialNumber string read from the device, if available.
* @since Chrome 46
*/
serialNumber: string;
/** The device vendor ID. */
vendorId: number;
/**
* The device version (bcdDevice field).
* @since Chrome 51
*/
version: number;
}

/** Event fired when print manager requests printers provided by extensions. */
export var onGetPrintersRequested: PrinterRequestedEvent;
export const onGetPrintersRequested: events.Event<
(resultCallback: (printerInfo: PrinterInfo[]) => void) => void
>;

/**
* Event fired when print manager requests information about a USB device that may be a printer.
* Note: An application should not rely on this event being fired more than once per device. If a connected device is supported it should be returned in the onGetPrintersRequested event.
*
* Note: An application should not rely on this event being fired more than once per device. If a connected device is supported it should be returned in the {@link onGetPrintersRequested} event.
* @since Chrome 45
*/
export var onGetUsbPrinterInfoRequested: PrinterInfoRequestedEvent;
export const onGetUsbPrinterInfoRequested: events.Event<
(device: Device, resultCallback: (printerInfo?: PrinterInfo) => void) => void
>;

/** Event fired when print manager requests printer capabilities. */
export var onGetCapabilityRequested: CapabilityRequestedEvent;
export const onGetCapabilityRequested: events.Event<
(printerId: string, resultCallback: (capabilities: PrinterCapabilities) => void) => void
>;

/** Event fired when print manager requests printing. */
export var onPrintRequested: PrintRequestedEvent;
export const onPrintRequested: events.Event<
(printJob: PrintJob, resultCallback: (result: `${PrintError}`) => void) => void
>;
}

////////////////////
Expand Down Expand Up @@ -9296,7 +9332,18 @@ declare namespace chrome {
optional_permissions?: ManifestOptionalPermissions[] | undefined;
optional_host_permissions?: string[] | undefined;
permissions?: ManifestPermissions[] | undefined;
web_accessible_resources?: Array<{ resources: string[]; matches: string[] }> | undefined;
web_accessible_resources?:
| Array<
& {
resources: string[];
use_dynamic_url?: boolean | undefined;
}
& (
| { extension_ids: string[]; matches?: string[] | undefined }
| { matches: string[]; extension_ids?: string[] | undefined }
)
>
| undefined;
}

export type Manifest = ManifestV2 | ManifestV3;
Expand Down
64 changes: 63 additions & 1 deletion types/chrome/test/index.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -922,7 +922,24 @@ function testGetManifest() {
manifest.optional_host_permissions; // $ExpectType string[] | undefined
manifest.permissions; // $ExpectType ManifestPermissions[] | undefined

manifest.web_accessible_resources = [{ matches: ["https://*/*"], resources: ["resource.js"] }];
manifest.web_accessible_resources = [{
resources: ["resource.js"],
use_dynamic_url: true,
matches: ["https://*/*"],
extension_ids: ["*"],
}];
manifest.web_accessible_resources = [{
resources: ["resource.js"],
matches: ["https://*/*"],
}];
manifest.web_accessible_resources = [{
resources: ["resource.js"],
extension_ids: ["*"],
}];
// @ts-expect-error
manifest.web_accessible_resources = [{
resources: ["resource.js"],
}];
// @ts-expect-error
manifest.web_accessible_resources = ["script.js"];

Expand Down Expand Up @@ -991,6 +1008,8 @@ function testGetManifest() {
{
matches: ["https://*/*"],
resources: ["some-script.js"],
extension_ids: ["*"],
use_dynamic_url: true,
},
],
};
Expand Down Expand Up @@ -6282,6 +6301,49 @@ function testPower() {
chrome.power.reportActivity(() => {}).then(() => {});
}

// https://developer.chrome.com/docs/extensions/reference/api/printerProvider
function testPrinterProvider() {
chrome.printerProvider.PrintError.FAILED === "FAILED";
chrome.printerProvider.PrintError.INVALID_DATA === "INVALID_DATA";
chrome.printerProvider.PrintError.INVALID_TICKET === "INVALID_TICKET";
chrome.printerProvider.PrintError.OK === "OK";

const printInfo: chrome.printerProvider.PrinterInfo = {
description: "description",
id: "id",
name: "name",
};

checkChromeEvent(chrome.printerProvider.onGetCapabilityRequested, (printerId, resultCallback) => {
printerId; // $ExpectType string
resultCallback({ capabilities: {} }); // $ExpectType void
});

checkChromeEvent(chrome.printerProvider.onGetPrintersRequested, (resultCallback) => {
resultCallback([printInfo]); // $ExpectType void
});

checkChromeEvent(chrome.printerProvider.onGetUsbPrinterInfoRequested, (device, resultCallback) => {
device.device; // $ExpectType number
device.manufacturerName; // $ExpectType string
device.productId; // $ExpectType number
device.productName; // $ExpectType string
device.serialNumber; // $ExpectType string
device.vendorId; // $ExpectType number
device.version; // $ExpectType number
resultCallback(printInfo); // $ExpectType void
});

checkChromeEvent(chrome.printerProvider.onPrintRequested, (printJob, resultCallback) => {
printJob.contentType; // $ExpectType string
printJob.document; // $ExpectType Blob
printJob.printerId; // $ExpectType string
printJob.ticket; // $ExpectType { [key: string]: unknown; }
printJob.title; // $ExpectType string
resultCallback("OK"); // $ExpectType void
});
}

// https://developer.chrome.com/docs/extensions/reference/api/platformKeys
function testPlatformKeys() {
chrome.platformKeys.ClientCertificateType.ECDSA_SIGN === "ecdsaSign";
Expand Down