Bluetooth-print-js NPM

PrintPlugin

PrintPlugin adalah plugin JavaScript untuk mencetak teks menggunakan printer thermal Bluetooth. Plugin ini mendukung dua ukuran kertas: "58mm" dan "80mm".

Fitur

Mencetak teks dengan berbagai opsi seperti huruf tebal, garis bawah, perataan, dan ukuran teks.
Mencetak teks dengan dua kolom.
Mencetak garis putus-putus.
Mencetak baris baru.
Mendukung dua ukuran kertas: "58mm" dan "80mm".
Mendukung koneksi ke printer thermal Bluetooth.
Mendukung browser modern seperti Chrome, Firefox, dan Edge.
Mendukung Node.js.
Mendukung penggunaan CDN.
Mendukung penggunaan NPM.
Mendukung penggunaan ES6.

Instalasi

Menggunakan NPM

npm install bluetooth-print-js

import atau require PrintPlugin ke dalam proyek Anda.

import PrintPlugin from "bluetooth-print-js";

const PrintPlugin = require("bluetooth-print-js");

Menggunakan CDN

<script src="https://cdn.jsdelivr.net/npm/bluetooth-print-js@1.0/index.min.js"></script>

Penggunaan

Membuat Instance dari PrintPlugin

Anda dapat membuat instance dari PrintPlugin dengan atau tanpa menentukan ukuran kertas yang diinginkan. Ukuran kertas yang didukung adalah "58mm" dan "80mm". Jika ukuran kertas tidak ditentukan, ukuran kertas default adalah "58mm".

// Create instance with paper size "80mm"
let printer = new PrintPlugin("80mm");

// Create instance with default paper size "58mm"
let printer = new PrintPlugin();

Menghubungkan ke Printer dan Mencetak Teks

Gunakan metode connectToPrint untuk menghubungkan ke printer Bluetooth dan mencetak teks. Anda perlu menyediakan dua fungsi callback: onReady dan onFailed.

onReady: Dipanggil ketika koneksi ke printer berhasil. Anda dapat menggunakan objek print yang diteruskan ke callback ini untuk mencetak teks.
onFailed: Dipanggil ketika koneksi ke printer gagal. Anda dapat menggunakan parameter message untuk mendapatkan pesan error.

Cara Menggunakan PrintPlugin

Hubungkan ke printer dan cetak teks.

printer.connectToPrint({
  onReady: async (print) => {
    await print.writeText("Hello, World!");
  },
  onFailed: (message) => {
    console.log(message);
  },
});

Contoh penggunaan lengkap (HTML):

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Bluetooth Print</title>
  </head>
  <body>
    <h1>Bluetooth Print</h1>
    <button id="connect">Connect and Print</button>
    <p id="status"></p>

    <script src="https://cdn.jsdelivr.net/npm/bluetooth-print-js@1.0/index.min.js"></script>
    <script>
      document.getElementById("connect").addEventListener("click", () => {
        let printer = new PrintPlugin("80mm");
        printer.connectToPrint({
          onReady: async (print) => {
            // Print Header
            await print.writeText("SADIGIT", {
              align: "center",
              bold: true,
              size: "double",
            });
            await print.writeText(
              "Jl. Kutamaya No.Ruko A, Kotakulon, Kec. Sumedang Sel., Kabupaten Sumedang, Jawa Barat 45311",
              { align: "center" }
            );
            await print.writeText("0852-2299-9699", { align: "center" });
            await print.writeLineBreak();
            await print.writeText("No.Transaksi: SDGT-ONL-0001", {
              align: "center",
            });
            await print.writeText("Kasir: Otongsuke", { align: "center" });
            await print.writeText("2024-10-23 10:20:18", { align: "center" });

            // Print Items
            await print.writeDashLine();
            for (let i = 0; i < 5; i++) {
              await print.writeText("Item Sample-" + i, { align: "left" });
              await print.writeTextWith2Column("1 pcs x 10.000", "10.000");
            }
            await print.writeDashLine();

            // Print Total
            await print.writeTextWith2Column("Total :", "50.000");
            await print.writeTextWith2Column("Bayar :", "100.000");
            await print.writeTextWith2Column("Kembali :", "50.000");
            await print.writeTextWith2Column("Metode :", "Tunai");

            // Print Footer
            await print.writeLineBreak();
            await print.writeText(
              "Terimakasih sudah mencoba Follow IG @sadigit.id",
              { align: "center" }
            );
            await print.writeLineBreak(3);
          },
          onFailed: (message) => {
            console.log(message);
          },
        });
      });
    </script>
  </body>
</html>

Metode yang Tersedia

writeLineBreak({ count = 1 }): Menulis baris baru.
writeDashLine(): Menulis garis putus-putus.
writeTextWith2Column(text1, text2, options): Menulis teks dengan dua kolom.
writeText(text, options): Menulis teks.
connectToPrint({ onReady, onFailed }): Menghubungkan ke printer dan memanggil callback onReady atau onFailed.

Opsi untuk Metode `writeText` dan `writeTextWith2Column`

bold: Menentukan apakah teks dicetak dengan huruf tebal. (default: false)
underline: Menentukan apakah teks dicetak dengan garis bawah. (default: false)
align: Menentukan perataan teks. Nilai yang didukung: "left", "center", "right". (default: "left")
size: Menentukan ukuran teks. Nilai yang didukung: "normal", "double". (default: "normal")