Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

barcode-tool

Package Overview
Dependencies
Maintainers
1
Versions
7
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

barcode-tool

lightweight npm package that facilitates barcode generation and detection. It leverages the Barcode Detection API for barcode scanning directly in web browsers and provides an intuitive interface for generating various barcode formats. Seamlessly integrat

  • 1.1.1
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

barcode-tool

barcode-tool is a lightweight npm package that facilitates barcode generation and detection. It leverages the Barcode Detection API for barcode scanning directly in web browsers and provides an intuitive interface for generating various barcode formats. Seamlessly integrate barcode functionality into your web applications for tasks such as inventory management, product identification, and more.

Supported Barcode Detector Formats

  • aztec
  • code_128
  • code_39
  • code_93
  • codabar
  • data_matrix
  • ean_13
  • ean_8
  • itf
  • pdf417
  • qr_code
  • upc_a
  • upc_e
  • unknown

Supported Barcode Generator Formats

  • CODE39
  • CODE128
  • CODE128A
  • CODE128B
  • CODE128C
  • EAN13
  • EAN8
  • EAN5
  • EAN2
  • UPC
  • UPCE
  • ITF
  • ITF14
  • MSI10
  • MSI11
  • MSI1010
  • MSI1110
  • pharmacode
  • codabar
  • GenericBarcode

Installation

You can install the barcode-tool via npm:

npm install barcode-tool

or via yarn:

yarn add barcode-tool

or importing the package with script tag via JSDelivr CDN:

<head>
    <script src="https://cdn.jsdelivr.net/npm/barcode-tool@1.1.1/dist/cjs/index.js"></script>
</head>

Alternatively, you can import the package with a script tag using Unpkg CDN:

<head>
    <script src="https://unpkg.com/barcode-tool@1.1.1/dist/cjs/index.js"></script>
</head>

Methods

detectBarcode
  • Method for getting the value in the provided barcode image.
detectBarcode Parameters
NameTypeDescription
payloadObjectAn object containing the following properties:
imageHTMLElement
Blob
HTMLCanvasElement
HTMLImageElement
HTMLVideoElement
ImageBitmap
ImageData
SVGImageElement
The image containing the barcode.
formatsstring[] (optional)Optional array of barcode formats to detect.

generateBarcode
  • Method for generating barcode
generateBarcode Parameters
NameTypeDescription
payloadObjectAn object containing the following properties:
elementIdstringThe image containing the barcode.
valuestringThe value to encode in the barcode.
optionsBarcodeOptions (optional)Optional settings for customizing the appearance of the barcode.

BarcodeOptions Parameter
NameTypeDescription
options.formatstring (optional)The format of the barcode. Default is auto.
options.widthnumber (optional)The width of the barcode bars. Default is 2.
options.heightnumber (optional)The height of the barcode bars. Default is 100.
options.displayValueboolean (optional)Whether to display the value below the barcode. Default is true.
options.textstring (optional)Additional text to display below the barcode.
options.fontOptionsstring (optional)Additional font options for the text below the barcode.
options.fontstring (optional)The font family for the text below the barcode. Default is monospace.
options.textAlignstring (optional)The alignment of the text below the barcode. Default is center.
options.textPositionstring (optional)The position of the text below the barcode. Default is bottom.
options.textMarginnumber (optional)The margin between the barcode and the text below it. Default is 2.
options.fontSizenumber (optional)The font size for the text below the barcode. Default is 20.
options.backgroundstring (optional)The background color of the barcode. Default is #ffffff.
options.lineColorstring (optional)The color of the barcode bars. Default is #000000.
options.marginnumber (optional)The margin around the barcode. Default is 10.
options.marginTopnumber (optional)The top margin around the barcode.
options.marginBottomnumber (optional)The bottom margin around the barcode.
options.marginLeftnumber (optional)The left margin around the barcode.
options.marginRightnumber (optional)The right margin around the barcode.
options.validfunction (optional)A callback function to validate the generated barcode.

getSupportedFormats
  • Method that specify all of the barcode formats that are available for detection, and generation of barcodes.

Sample usage with package manager/bundler

Sample Usage
import { detectBarcode } from 'barcode-tool';

const handleDetectBarcode = async () => {
    try {
        const elementWithBarcode = document.getElementById('element-with-barcode');

         // Specify optional formats to detect
        const formats = ['ean_13', 'qr_code'];
        const barcodes = await detectBarcode({ image: elementWithBarcode, formats });
        console.log("handleDetectBarcode ~ barcodes:", barcodes)
    } catch (error) {
        console.error('Error on detecting barcodes:', error.message);
    }
}
import { getSupportedFormats } from 'barcode-tool';

const handleGetSupportedFormats = async () => {
    try {
        const supportedFormats = await getSupportedFormats();
        console.log("handleGetSupportedFormats ~ supportedFormats:", supportedFormats)
    } catch (error) {
        console.log("handleGetSupportedFormats ~ error:", error)
    }
}

import { generateBarcode } from 'barcode-tool';

const handleGenerateBarcode = () => {
    try {
        const payload = { elementId: 'barcode-container', value: 'your-barcode-value' };
        const options = { /* your BarcodeOptions here */ };
        generateBarcode({ ...payload, options });
    } catch (error) {
        console.error('Error generating barcode:', error.message);
    }
}

Sample usage with script tag

<head>
    <script src="https://cdn.jsdelivr.net/npm/barcode-tool@1.1.1/dist/cjs/index.js"></script>
</head>


<img id="element-with-barcode" src="your-barcode.jpg" />
<img id="barcode-container" src="" />

<script>
    const handleDetectBarcode = async () => {
        try {
            const elementWithBarcode = document.getElementById('element-with-barcode');

            // Specify optional formats to detect
            const formats = ['ean_13', 'qr_code'];
            const barcodes = await detectBarcode({ image: imageElement, formats });
            console.log("handleDetectBarcode ~ barcodes:", barcodes)
        } catch (error) {
            console.log("handleDetectBarcode ~ error:", error)
        }
    }

    const handleGetSupportedFormats = async () => {
        try {
            const supportedFormats = await getSupportedFormats();
            console.log("handleGetSupportedFormats ~ supportedFormats:", supportedFormats)
        } catch (error) {
            console.log("handleGetSupportedFormats ~ error:", error)
        }
    }

    const handleGenerateBarcode = () => {
        try {
            const payload = { elementId: 'barcode-container', value: 'your-barcode-value' };
            const options = { /* your BarcodeOptions here */ };
            generateBarcode({ ...payload, options });
        } catch (error) {
            console.error('Error generating barcode:', error.message);
        }
    }

    window.onload = function () {
        // Document is ready
        console.log('Document is ready');
        getBarcodes();
        handleGetSupportedFormats();
        handleGenerateBarcode();
    };
</script>

Third-Party Softwares

barcode-tool is only made possible with the use and help of amazing open-source third-party softwares:

Barcode Detection API

JsBarcode, MIT

  • JsBarcode Barcode generation library written in JavaScript that works in both the browser and on Node.js

License

See the LICENSE file

Keywords

FAQs

Package last updated on 07 Apr 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc