This is a **fork** of [NielsLeenheer/WebUSBReceiptPrinter](https://github.com/NielsLeenheer/WebUSBReceiptPrinter). It allows you to print to a USB connected receipt printer using WebUSB.
npm install @medibase/webusb-receipt-printerThis is a fork of NielsLeenheer/WebUSBReceiptPrinter.
It allows you to print to a USB connected receipt printer using WebUSB.
!GitHub License
> This fork is maintained for internal usage and published under a different npm scope.
> Original library is part of @point-of-sale, a collection of libraries for interfacing browsers and Node with Point of Sale devices such as receipt printers, barcode scanners and customer facing displays.
---
| Feature | Original (@point-of-sale) | Fork (@medibase) |
|---------------------|----------------------------------------------------------|-----------------------------------------------|
| NPM package | @point-of-sale/webusb-receipt-printer | @medibase/webusb-receipt-printer |
| Maintainer | Niels Leenheer | Internal fork (maintained by our team) |
| Purpose | General open-source usage | Internal usage (bugfixes, improvements, etc.) |
| License | MIT | MIT (same as original) |
---
Install from npm:
``bash`
npm install @medibase/webusb-receipt-printer
or with Yarn:bash`
yarn add @medibase/webusb-receipt-printerWhat does this library do?
In order to print a receipt on a receipt printer you need to build the receipt and encode it as in the ESC/POS or StarPRNT language. You can use the ReceiptPrinterEncoder library for this. You end up with an array of raw bytes that needs to be send to the printer. One way to do that is using a direct USB connection using WebUSB.
On most platforms you can directly talk to USB connected receipt printers using WebUSB. The main exception to this is on Windows where the printer driver exclusively claims the printer. On that platform the alternative way to print on receipt printers would be to use allow to driver to create a virtual serial port for the printer. Usually this is used for compatibility with old applications, but it also means you can use the WebSerialReceiptPrinter library instead.
Unfortunately...
There seems to be an incompatibility between the WebSerial implementation and the virtual serial port that the Star printer driver creates. That means this workaround does not work for Star printers.
Load the webusb-receipt-printer.umd.js file from the dist directory in the browser and instantiate a WebUSBReceiptPrinter object.
`html
`
Or import the webusb-receipt-printer.esm.js module:
`js
import WebUSBReceiptPrinter from 'webusb-receipt-printer.esm.js';
const receiptPrinter = new WebUSBReceiptPrinter();
`
The first time you have to manually connect to the receipt printer by calling the connect() function. This function must be called as the result of an user action, for example clicking a button. You cannot call this function on page load.
`js`
function handleConnectButtonClick() {
receiptPrinter.connect();
}
Subsequent times you can simply call the reconnect() function. You have to provide an object with the serial number, vendor id and product id of the previously connected receipt printer in order to find the correct printer and connect to it again. You can get this data by listening to the connected event and store it for later use. It is recommended to call this button on page load to prevent having to manually connect to a previously connected device.
`js`
receiptPrinter.reconnect(lastUsedDevice);
If there are no receipt printers connected that have been previously connected, or the serial number does not match up, this function will do nothing.
To find out when a receipt printer is connected you can listen for the connected event using the addEventListener() function.
`jsConnected to ${device.manufacturerName} ${device.productName} (#${device.serialNumber})
receiptPrinter.addEventListener('connected', device => {
console.log();
printerLanguage = device.language;
printerCodepageMapping = device.codepageMapping;
/ Store device for reconnecting /
lastUsedDevice = device;
});
`
The callback of the connected event is passed an object with the following properties:
- type
Type of the connection that is used, in this case it is always .vendorId
-
The USB vendor ID.
-
The USB product ID.
-
The name of the manufacturer of the printer.
-
The name of the receipt printer.
-
The serial number of the receipt printer. To be used to reconnect to the printer at a later time.
-
Language of the printer, which can be either or star-prnt. This can be used as an option for ReceiptPrinterEncoder to encode in the correct language for the printer.codepageMapping
-
Code page mapping of the printer, which can be used as an option for to map non-ascii characters to the correct codepage supported by the printer.
Once connected you can use the following command to print receipts.
When you want to print a receipt, you can call the print() function with an array, or a typed array with bytes. The data must be properly encoded for the printer.
For example:
`js
/ Encode the receipt /
let encoder = new ReceiptPrinterEncoder({
language: printerLanguage,
codepageMapping: printerCodepageMapping
});
let data = encoder
.initialize()
.text('The quick brown fox jumps over the lazy dog')
.newline()
.qrcode('https://nielsleenheer.com')
.encode();
/ Print the receipt /
receiptPrinter.print(data);
``
-----
This library has been created by Niels Leenheer under the MIT license. Feel free to use it in your products.