JSPM

browser-thermal-printer

0.0.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 14
  • Score
    100M100P100Q58790F
  • License ISC

Print on Epson and Star thermal printers in a browser

Package Exports

  • browser-thermal-printer

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (browser-thermal-printer) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Browser Thermal Printer

Browser module for EPSON and STAR thermal printers command line printing.

Installation

npm install browser-thermal-printer --save

Features

import ThermalPrinter, { PrinterTypes } from "../browser-thermal-printer";

const printer = new ThermalPrinter(PrinterTypes.STAR);
printer.print("Hello World"); // Append text
printer.println("Hello World"); // Append text with new line
printer.openCashDrawer(); // Kick the cash drawer
printer.cut(); // Cuts the paper (if printer only supports one mode use this)
printer.partialCut(); // Cuts the paper leaving a small bridge in middle (if printer supports multiple cut modes)
printer.beep(); // Sound internal beeper/buzzer (if available)
printer.upsideDown(true); // Content is printed upside down (rotated 180 degrees)
printer.setCharacterSet("SLOVENIA"); // Set character set - default set on init
printer.setPrinterDriver(Object); // Set printer drive - default set on init

printer.bold(true); // Set text bold
printer.invert(true); // Background/text color inversion
printer.underline(true); // Underline text (1 dot thickness)
printer.underlineThick(true); // Underline text with thick line (2 dot thickness)
printer.drawLine(); // Draws a line
printer.newLine(); // Insers break line

printer.alignCenter(); // Align text to center
printer.alignLeft(); // Align text to left
printer.alignRight(); // Align text to right

printer.setTypeFontA(); // Set font type to A (default)
printer.setTypeFontB(); // Set font type to B

printer.setTextNormal(); // Set text to normal
printer.setTextDoubleHeight(); // Set text to double height
printer.setTextDoubleWidth(); // Set text to double width
printer.setTextQuadArea(); // Set text to quad area
printer.setTextSize(7, 7); // Set text height (0-7) and width (0-7)

printer.leftRight("Left", "Right"); // Prints text left and right
printer.table(["One", "Two", "Three"]); // Prints table equaly
printer.tableCustom([
  // Prints table with custom settings (text, align, width, cols, bold)
  { text: "Left", align: "LEFT", width: 0.5 },
  { text: "Center", align: "CENTER", width: 0.25, bold: true },
  { text: "Right", align: "RIGHT", cols: 8 },
]);

printer.code128("Code128"); // Print code128 bar code
printer.printQR("QR CODE"); // Print QR code
await printer.printImage("./assets/olaii-logo-black.png"); // Print PNG image

print.clear(); // Clears printText value
print.getText(); // Returns printer buffer string value
print.getBuffer(); // Returns printer buffer - Pass this buffer to printer
print.setBuffer(newBuffer); // Set the printer buffer to a copy of newBuffer
print.getWidth(); // Get number of characters in one line

How to run examples (Set to EPSON)

node examples/example.ts

2D Barcode Examples

Example settings are the default when not specified.

printer.code128("Code128", {
  width: "LARGE", // "SMALL", "MEDIUM", "LARGE",
  height: 80, // 50 < x < 80
  text: 2, // 1 - No text
  // 2 - Text on bottom
  // 3 - No text inline
  // 4 - Text on bottom inline
});

printer.printQR("QR Code", {
  cellSize: 3, // 1 - 8
  correction: "M", // L(7%), M(15%), Q(25%), H(30%)
  model: 2, // 1 - Model 1
  // 2 - Model 2 (standard)
  // 3 - Micro QR
});

printer.pdf417("PDF417", {
  rowHeight: 3, // 2 - 8
  width: 3, // 2 - 8
  correction: 1, // Ratio: 1 - 40
  truncated: false, // boolean
  columns: 0, // 1 - 30, 0 auto
});

printer.maxiCode("MaxiCode", {
  mode: 4, // 2 - Formatted/structured Carrier Message (US)
  // 3 - Formatted/structured Carrier Message (International)
  // 4 - Unformatted data with Standard Error Correction.
  // 5 - Unformatted data with Enhanced Error Correction.
  // 6 - For programming hardware devices.
});

1D Barcode Example

var data = "GS1-128"; // Barcode data (string or buffer)
var type = 74; // Barcode type (See Reference)
var settings = {
  // Optional Settings
  hriPos: 0, // Human readable character 0 - 3 (none, top, bottom, both)
  hriFont: 0, // Human readable character font
  width: 3, // Barcode width
  height: 168, // Barcode height
};

printer.printBarcode(data, type, settings);

Epson Barcode Reference

# Type Possible Characters Length of Data
65 UPC-A 0 - 9 11, 12
66 UPC-E 0 - 9 6 – 8, 11, 12
67 JAN13 0 - 9 12, 13
68 JAN8 0 - 9 7, 8
69 Code39 0 – 9, A – Z, SP, $, %, *, +, -, ., / 1 – 255
70 ITF (Interleaved 2 of 5) 0 – 9 2 – 254 (even number)
71 CODABAR (NW-7) 0 – 9, A – D, a – d, $, +, −, ., /, : 2 – 255
72 CODE93 00h – 7Fh 1 – 255
73 CODE128 00h – 7Fh 2 - 255
74 GS1-128 NUL – SP(7Fh) 2 – 255
75 GS1 DataBar Omnidirectional 0 – 9 13
76 GS1 DataBar Truncated 0 – 9 13
77 GS1 DataBar Limited 0 – 9 13
78 GS1 DataBar Expanded 0 – 9, A – D, a – d, SP, !, ", %, $, ', (, ), *, +, ,, -, ., /, :, ;, <, =, >, ?, _, { 2 - 255

STAR Barcode Reference

var data = "TEST"; // Barcode data (string or buffer)
var type = 7; // Barcode type (See Reference)
var settings = {
  // Optional Settings
  characters: 1, // Add characters (See Reference)
  mode: 3, // Barcode mode (See Reference)
  height: 150, // Barcode height (0≤ height ≤255)
};

printer.printBarcode(data, type, settings);

Type

# Type
0 UPC-E
1 UPC-A
2 JAN/EAN8
3 JAN/EAN13
4 Code39
5 ITF
6 CODE128
7 CODE93
8 NW-7

Settings characters

# Description
1 No added under-bar characters. Executes line feed after printing a bar code
2 Adds under-bar characters. Executes line feed after printing a bar code
3 No added under-bar characters. Does not execute line feed after printing a bar code
4 Adds under-bar characters. Does not execute line feed after printing a bar code

Settings mode

# UPC-E, UPC-A, JAN/EAN8, JAN/EAN13, Code128, Code93 Code39, NW-7 ITF
1 Minimum module 2 dots Narrow: Wide = 2:6 dots Narrow: Wide = 2:5 dots
2 Minimum module 3 dots Narrow: Wide = 3:9 dots Narrow: Wide = 4:10 dots
3 Minimum module 4 dots Narrow: Wide = 4:12 dots Narrow: Wide = 6:15 dots
4 Narrow: Wide = 2:5 dots Narrow: Wide = 2:4 dots
5 Narrow: Wide = 3:8 dots Narrow: Wide = 4:8 dots
6 Narrow: Wide = 4:10 dots Narrow: Wide = 6:12 dots
7 Narrow: Wide = 2:4 dots Narrow: Wide = 2:6 dots
8 Narrow: Wide = 3:6 dots Narrow: Wide = 3:9 dots
9 Narrow: Wide = 4:8 dots Narrow: Wide = 4:12 dots

Docs

Tested printers

  • Star TSP700
  • Rongta RP80US
  • Rongta RP326-USE
  • EPSON TM-T88V
  • Posman BTP-R880NP (Type "epson")

Character sets

  • PC437_USA
  • PC850_MULTILINGUAL
  • PC860_PORTUGUESE
  • PC863_CANADIAN_FRENCH
  • PC865_NORDIC
  • PC851_GREEK
  • PC857_TURKISH
  • PC737_GREEK
  • ISO8859_7_GREEK
  • WPC1252
  • PC866_CYRILLIC2
  • PC852_LATIN2
  • SLOVENIA
  • PC858_EURO
  • WPC775_BALTIC_RIM
  • PC855_CYRILLIC
  • PC861_ICELANDIC
  • PC862_HEBREW
  • PC864_ARABIC
  • PC869_GREEK
  • ISO8859_2_LATIN2
  • ISO8859_15_LATIN9
  • PC1125_UKRANIAN
  • WPC1250_LATIN2
  • WPC1251_CYRILLIC
  • WPC1253_GREEK
  • WPC1254_TURKISH
  • WPC1255_HEBREW
  • WPC1256_ARABIC
  • WPC1257_BALTIC_RIM
  • WPC1258_VIETNAMESE
  • KZ1048_KAZAKHSTAN

CHANGELOG

See CHANGELOG.md