spdf-to-printer
TypeScript icon, indicating that this package has built-in type declarations

1.5.6 • Public • Published

Node.js PDF printing

Build Status codecov Buy Me A Coffee

A utility to print PDF files from Node.js and Electron.

  • Works on Windows and Unix-like and Mac operating systems.
  • Supports label printers such as Rollo and Zebra.

Installation

Install using yarn:

yarn add spdf-to-printer

Or npm:

npm install --save spdf-to-printer

Basic Usage

Print a PDF file to the default printer:

import ptp from "spdf-to-printer";

ptp
  .print("assets/pdf-sample.pdf")
  .then(console.log)
  .catch(console.error);

API

.print(pdf[, options]) => Promise<void>

Arguments

  1. pdf (string): PDF file to print. Will throw an error if no PDF specified. Note: It must be a path to a PDF existing in the file system. You may take a look at this example if you need to download your PDF file first.
  2. options (Object [optional]):
    • options.printer: (string [optional]): Print to the specified printer. Will print to the default printer if name not specified. If the printer name mistyped or specified printer does not exist, nothing will print.
    • options.unix: (array [optional]): Since we use lp to print documents on Unix-like operating systems you can pass any available in this list option.
    • options.win32: (array [optional]): And since we use SumatraPDF to print documents on Windows you can pass any available in this list option.

Returns

Promise<void>.

Examples

To print a PDF file to the default printer:

ptp
  .print("assets/pdf-sample.pdf")
  .then(console.log)
  .catch(console.error);

To print to a specific printer, add the name of the printer to options:

const options = {
  printer: "Zebra"
};

ptp
  .print("assets/pdf-sample.pdf", options)
  .then(console.log)
  .catch(console.error);

To scale the PDF to fit into the printable area of the paper on both Windows and Unix operating systems:

const options = {
  printer: "Zebra",
  unix: ["-o fit-to-page"],
  win32: ['-print-settings "fit"']
};

ptp
  .print("assets/pdf-sample.pdf", options)
  .then(console.log)
  .catch(console.error);

.getPrinters() => Promise<string[]>

Returns

Promise<string[]>: List of available printers.

Examples

ptp
  .getPrinters()
  .then(console.log)
  .catch(console.error);

.getDefaultPrinter() => Promise<string>

Returns

Promise<string>: Default printer.

Examples

ptp
  .getDefaultPrinter()
  .then(console.log)
  .catch(console.error);

More examples

We have a few examples in the source code.

Contact

Please do not hesitate to report a bug or suggest an idea. You can do it here.

License

MIT

Package Sidebar

Install

npm i spdf-to-printer

Weekly Downloads

3

Version

1.5.6

License

MIT

Unpacked Size

14.4 MB

Total Files

6

Last publish

Collaborators

  • tdjdyq