Print options guide
pdfOptions vs printOptions field comparison, pitfalls, and recipes for thermal labels, A4, and duplex.
Read guideWeb Print Expert Documentation
Official Web Print Expert documentation hub: comparison guides (Lodop, window.print), framework integration (Vue/React), business scenarios (receipts, WMS, domestic OS), client deployment, and advanced configuration—plus 25 live demos and the web-print-pdf API reference below for silent HTML printing.
Live demos
25 runnable demos: demo receipts, demo thermal slips, demo package labels, watermarks, batch print. Pick a sample, view code, run with the local client.
Run now
Open demos
Open live demo center
Run printHtml, batch print, watermark, and more in the browser—no local project setup.
Topic guides
Guides grouped by advanced config first, then comparison, integration, scenarios, and deployment.
Advanced configuration
Must-readRemote print, print options, error handling, and authenticated URL print.
Error handling guide
Client won’t connect or errors look like [object Object]? Preflight with getConnectStatus, formatPrintError for users, and a symptom checklist.
Read guideHow to print login-protected pages
Use printHtmlByUrl with extraOptions—cookies, httpHeaders, localStorage—to print session-protected business URLs.
Read guideRemote print setup
Print job message JSON is fixed; build your server to receive, store, and expose WebSocket/HTTP—desk clients enter that URL (not browser printHtml).
Read guideLocal print OK—fails after deploy?
Dev OK but production Console shows WebSocket to ws://127.0.0.1:16794 failed—Chrome LNA, HTTPS or flags fixes.
Read guideComparison & alternatives
Choosing or migrating from window.print, Lodop, hiprint, and similar stacks.
Lodop vs web-print-pdf
Neutral comparison & decision matrix—parallel PoC; keep Lodop for precision overlays.
Read guidewindow.print alternative & silent print
Why browsers cannot silent-print, common alternatives, and how web-print-pdf with a local client avoids the dialog.
Read guidehiprint vs web-print-pdf comparison
Compare hiprint vs web-print-pdf—with emphasis on web-print-pdf strengths across Windows, macOS, Linux/Kylin/UOS, npm, and HTML reports.
Read guideC-Lodop & Chrome compatibility
Environment checklist after browser upgrades; optional parallel HTML print evaluation.
Read guideParallel Lodop + web-print-pdf
Inventory, PoC, parallel run—coexist with Lodop, not a forced cutover.
Read guidePrint.js vs web-print-pdf
Browser dialog print vs local client silent print for ERP/WMS.
Read guidejsPDF vs web-print-pdf
PDF file generation vs silent local printer output.
Read guidePuppeteer / Playwright vs printing
Server PDF/archive vs silent labels on business PCs—with decision matrix and related guides.
Read guideFramework integration
Vue, React, Next.js, and other front-end stacks with printHtml.
Vue silent printing
Call printHtml in Vue 3 admin apps for silent print without the browser dialog.
Read guideReact silent printing
Use web-print-pdf printHtml in React 18 admin apps—no browser dialog—with a custom Hook example.
Read guideNext.js silent printing
Use printHtml in App Router / Pages Router client components—no browser print dialog.
Read guideAngular silent printing
Angular 15+ Injectable service wrapping printHtml for admin HTML reports.
Read guideUniApp H5 silent print
UniApp H5 with desktop client; mini program limits and remote desk print.
Read guideUI library guides (optional)
Element Plus and Ant Design follow the same pattern as the Vue/React guides above—read only if you use those UI kits.
Business scenarios
Receipts, shipping labels, WMS, and anonymized deployment summaries.
WMS remote label printing
Server-pushed shipping labels, silent warehouse output.
Read guideThermal receipts & shipping labels
80mm receipts, WMS labels, and batch print with HTML + printHtml/batchPrint—one API on Win/Mac/Linux/domestic OS.
Read guideMedical prescription & label print
A4 scripts and Rx labels with printHtml—prescription-a4 & rx-labels demos.
Read guideERP invoice & statement print
Silent finance reports—invoice & order-table demos.
Read guideE-commerce shipping labels
100×150 labels, batchPrint, and WMS remote push.
Read guideRetail POS thermal receipts
80mm silent receipts—receipt-80mm demo.
Read guideGovernment domestic OS case
Anonymized Kylin/UOS HTML print rollout summary.
Read guideLogistics WMS label case
Anonymized server-push warehouse label story.
Read guideManufacturing ERP case
Anonymized shop-floor & office ERP print summary.
Read guideDeployment snapshots
Anonymized summaries for reference; actual setups vary by environment.
Vue admin on Kylin desktops
A provincial agency needed silent fiscal receipts on domestic OS terminals instead of browser print dialogs.
- Linux deb client on UOS / Kylin terminals
- Vue 3 +
web-print-pdffor one-click silent print - Same HTML templates as Windows—less dual maintenance
Remote label printing
A logistics WMS pushes shipping labels to warehouse PCs; printers run without manual clicks.
- WMS runs receive/store service; exposes WebSocket/HTTP with fixed JSON
- Desk PCs configure that URL in the client
- Peak output without browsers or printHtml
UOS shop-floor reports
A manufacturer prints dynamic ERP HTML reports from UnionTech UOS workstations on the shop floor.
- Linux client on intranet-only PCs
printHtmlfor work orders and QC reports- HTML to PDF stays on-device
Client deployment
Install and troubleshoot the desktop client on Windows, macOS, and Linux/domestic OS.
Kylin silent printing
Kylin desktop deb client and web-print-pdf integration.
Read guideUnionTech UOS silent print
UOS desktop deployment for intranet printing.
Read guideWindows deployment guide
Install the Windows exe client, firewall/WebSocket tips, and web-print-pdf silent print integration.
Read guidemacOS deployment
Install the dmg client on Apple Silicon / Intel Mac; Gatekeeper tips and web-print-pdf integration.
Read guideLinux deployment
Install the deb client on Kylin, UOS, and other Linux distros; use web-print-pdf.
Read guideWindows firewall troubleshooting
Allow the desktop client through Windows firewall.
Read guideAPI overview
printHtml
Print HTML strings. PDF layout is fully controlled by HTML/CSS—ideal for dynamic reports, receipts, and order pages.
printHtmlByUrl
Print online HTML page URLs with cookies, headers, timeout, and other options.
printHtmlByBase64
Print Base64-encoded HTML content.
batchPrint
Submit multiple print jobs—labels, invoices, and high-volume scenarios.
Remote printing (WebSocket / HTTP)
Fixed job message JSON; build receive/store + expose WebSocket/HTTP; desk client enters that URL. webPrintPdf.printHtml etc. are format reference only—not called on the remote path.
printPdfByUrl / printImageByUrl
Print online PDF or image files with printer and copy count options.
See the GitHub README for more APIs.
See Vue silent printing, React silent printing, and Next.js silent printing guides.
API & troubleshooting reference (optional)
Open when you need parameter signatures or WebSocket debugging; start with the Advanced guides above.
FAQ
What do I need before using web-print-pdf?
You must install the Web Print Expert client first. The npm package only provides JavaScript APIs; printing runs on the local client.
How do I use it in a Vue project?
Run npm install web-print-pdf, import it in your component, and call the APIs like any npm library.
How do I configure remote printing?
Fixed message format. Build receive/store + expose a WebSocket/HTTP consumer API; desk clients enter that URL under Remote Print. Do not call webPrintPdf.printHtml on the remote path (npm is format reference only). See the remote print guide.