WebPrintingMediaSizeRequested

Fixed dimensions supplied inside a requested media collection.

Syntax

dictionary WebPrintingMediaSizeRequested { required unsigned long yDimension; required unsigned long xDimension; };

Inputs

Use this value only in the containing typed dictionary; unsupported values are rejected at job submission.

Outputs

Fixed dimensions supplied inside a requested media 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.