WebPrintingMediaCollectionRequested

The mediaCol request shape accepted by print-job attributes.

Syntax

dictionary WebPrintingMediaCollectionRequested { required WebPrintingMediaSizeRequested mediaSize; };

Inputs

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

Outputs

The mediaCol request shape accepted by print-job attributes. It appears in the containing API dictionary; it does not return a promise by itself.

Errors

Invalid WebPrintingMediaCollectionRequested 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 WebPrintingMediaCollectionRequested dictionary for job submission:

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

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.