82label
My templates한국어Get started

Docs › Printing

Printing (browser, agent, silent)

The three modes of print(), the result, picking a printer, and browser dialog settings.

One call prints: print(template, rows, options). template is a template object or a template id ('lbl_…').

const r = await Label82.print(template, rows, {
  mode: 'auto',        // 'auto' | 'agent' | 'browser'
  printer: 'TSC TE210', // agent printer name (default printer if left out)
  copies: 1,           // labels per row
  startAt: 1,          // sheets: first slot
  frames: true,        // false: skip layer 'frame' elements
});

Three modes

modeBehaviour
auto (default)If the print agent runs on the PC and is linked to a subscribed account, print through it with no dialog (silent). Otherwise the browser print dialog.
agentAgent only. Throws AgentError when it is missing or not linked (never falls back).
browserAlways the browser dialog; the agent is not looked for.

Silent printing

Through the agent there is no dialog. The library renders the labels as PNGs at the printer's dpi, sends them to the agent on the PC (http://127.0.0.1:18282), and the agent prints them through the Windows driver at the paper size (no margins, 100%).

  • The first request from a site makes the agent ask "Allow this site to print?". Meanwhile print() prints nothing and returns status: 'pending_permission'; after allowing, the next click prints at once.
  • If the agent runs but is not linked to a subscription, the browser prints and the result carries notice: 'agent_license_required'.
  • Without an agent the library decides within 0.4 seconds and falls back to the browser.

The result

{
  via: 'agent' | 'browser',
  printed: 2,                 // labels sent (copies included)
  status: 'done' | 'pending_permission' | 'cancelled',
  errors: [],                 // bad barcode values, overflowing text… (printing goes on)
  notice: 'agent_license_required', // only when set
}
const r = await Label82.print(template, rows);
if (r.status === 'pending_permission') showToast('Allow this site in the print agent window.');
else if (r.notice === 'agent_license_required') showToast('Link the print agent to your account to print directly.');
if (r.errors.length) console.warn(r.errors);

Printers

const list = await Label82.printers(); // null without the agent
// [{ name: 'TSC TE210', isDefault: true, dpi: 203 }, { name: 'Canon G3010', isDefault: false }]
const status = await Label82.agentStatus(); // { version, allowed, licensed } or null

Browser dialog settings

  • Scale: 100% (actual size). Turn off "fit to page".
  • Margins: none. 82label sets @page { size: Wmm Hmm; margin: 0 }.
  • Turn off headers and footers (date, URL). Chrome drops them when there are no margins.
  • On a roll label printer, pick the label size as the printer's paper size.