WebPrintingMediaCollection

Returned named media capability collection.

Syntax

dictionary WebPrintingMediaCollection { USVString mediaSizeName; WebPrintingMediaSize mediaSize; };

Inputs

This is output-only capability data; it is not an independent method parameter.

Outputs

Returned named media capability collection. It appears in the containing API dictionary; it does not return a promise by itself.

Errors

Invalid values fail normal Web IDL conversion or the containing print-job validation; no separate exception algorithm is specified for this standalone type.

Context and permission

Available only through the proposed Web Printing API in its required secure isolated Window context; this type creates no additional permission.

Lifecycle

Capability and state values are snapshots returned by printer/job operations. Refresh the containing attributes before relying on current hardware support.

Examples

// Read this typed value from fresh printer attributes.
const attributes = await printer.fetchAttributes();
console.log(attributes);

Compatibility

Public status
Chrome	Proposed, not released; current service is ChromeOS+CUPS only.
Android	ChromeStatus is null; no public mobile release.

Security and privacy

Capabilities and state can fingerprint a printer and reveal printing activity; avoid exposing them to untrusted code.