Interface: PrintOptions

Options for a single PrinterAdapter.print() call.

Drivers may extend this with family-specific fields; structural typing accepts any superset wherever PrintOptions is consumed.

Properties

Property	Type	Description
confirm?	boolean	Confirm the job out-of-band after sending, on transports that give no feedback themselves (e.g. a write-only port 9100 checked via the SNMP page counter). Default true. Pass false when the confirmation channel is known to be unavailable; the driver then sends blind and resolves once the bytes are out. Drivers whose transport reports completion ignore it.
copies?	number	Number of copies to print. Default 1.
density?	string	Driver-specific density setting. Common values: 'light', 'normal', 'dark'. Some drivers support additional values such as 'medium' or 'high'. Drivers throw UnsupportedOperationError for unrecognised values. 'normal' is universally supported across all drivers.
engine?	string	Engine to route to on multi-engine devices. Role name from printer.engines (e.g. 'left', 'right', 'label', 'tape') or 'auto' to defer to firmware (where the protocol supports it). Default behaviour: - Single-engine device — ignored. - Multi-engine, protocol supports auto — defaults to 'auto'. - Multi-engine, protocol does not (e.g. LabelWriter Duo) — required; the driver throws EngineRequiredError when omitted. 'auto' is a routing mode the protocol module interprets — the registry does not store it. Whether a protocol supports auto is implicit in whether its implementation exposes an auto-address sentinel.