WebPrintingMediaSizeRequested

Fixed dimensions supplied inside a requested media collection.

Syntax

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

Inputs

Use this WebPrintingMediaSizeRequested 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 WebPrintingMediaSizeRequested 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

Constructing a WebPrintingMediaSizeRequested dictionary for job submission:

// Construct WebPrintingMediaSizeRequested inside job template attributes.
const mediaSize = { xDimension: 21000, yDimension: 29700 };
console.log(mediaSize);

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.