Detect and Extract Barcodes - React JS

This tutorial shows how to perform barcode detection and recognition in a React JS application using the LEADTOOLS SDK.

Summary This tutorial covers how to detect and extract barcodes from an image in a React JS application.
Completion Time 30 minutes
Visual Studio Project Download tutorial project (474 KB)
Platform React JS Web Application
IDE Visual Studio : Service & Visual Studio Code : Client
Development License Download LEADTOOLS
Try it in another language

Required Knowledge

Get familiar with the basic steps of creating a project and loading an image in an ImageViewer by reviewing the Add References and Set a License and Display Images in an Image Viewer tutorials, before working on the Detect and Extract Barcodes - React JS tutorial.

Make sure that Yarn is installed so that creating a React application can be done quickly via the command line. If yarn is not installed, it can be found on:

Create the Project and Add LEADTOOLS References

Start with a copy of the project created in the Display Images in an Image Viewer tutorial. If you do not have a copy of that tutorial project, follow the steps inside that tutorial to create it.

The references needed depend upon the purpose of the project. For this project, the following JS files are needed and located here: <INSTALL_DIR>\LEADTOOLS22\Bin\JS

Make sure to copy these files to the public\common folder and import them in the public\index.html file.

For more information on which files to include for your JavaScript application, see Files to be Included with your Application.

Set the License File

The License unlocks the features needed for the project. It must be set before any toolkit function is called. For details, including tutorials for different platforms, refer to Setting a Runtime License.

There are two types of runtime licenses:


Adding LEADTOOLS local references and setting a license are covered in more detail in the Add References and Set a License tutorial.

Import LEADTOOLS Dependencies

Open the index.html file in the public folder. Add the below necessary script tags inside the head to import LEADTOOLS dependencies.

  <meta charset="utf-8" /> 
  <link rel="icon" href="%PUBLIC_URL%/favicon.ico" /> 
  <meta name="viewport" content="width=device-width, initial-scale=1" /> 
  <meta name="theme-color" content="#000000" /> 
  <meta name="description" content="Web site created using create-react-app" /> 
<script src="" 
  integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script> 
  <!--Import LEADTOOLS dependencies--> 
  <script type="text/javascript" src="/common/Leadtools.js"></script> 
  <script type="text/javascript" src="/common/Leadtools.Controls.js"></script> 
  <script type="text/javascript" src="/common/Leadtools.Annotations.Engine.js"></script> 
  <script type="text/javascript" src="/common/Leadtools.Document.js"></script> 
  <!--Import our script with our Leadtools Logic--> 
  <script src="/common/DocumentHelper.js"></script> 
  <script src="/common/ltlogic.js"></script> 
  <link rel="manifest" href="%PUBLIC_URL%/manifest.json" /> 
  <title>React App</title> 

Create the DocumentHelper Class and Connect to Document Service

With the project created, the references added, the license set, and the ImageViewer initialized coding can begin.

Inside the common folder in the public folder, create a new JS file named DocumentHelper.js. Add a new class to the new JS file named DocumentHelper. Add the following code inside the DocumentHelper class.

class DocumentHelper { 
    // Startup function 
    static connectToDocumentService = () => { 
        let serviceStatus; 
        document.addEventListener("DOMContentLoaded", function () { 
        serviceStatus = document.getElementById("serviceStatus"); 
        let output = document.getElementById("output"); 
        // To communicate with the DocumentsService, it must be running! 
        // Change these parameters to match the path to the service. 
        lt.Document.DocumentFactory.serviceHost = "http://localhost:40000"; 
        lt.Document.DocumentFactory.servicePath = ""; 
        lt.Document.DocumentFactory.serviceApiPath = "api"; 
        serviceStatus.innerHTML = "Connecting to service " + lt.Document.DocumentFactory.serviceUri; 
            .done(function (serviceData) { 
                let setStatus = function(){ 
                    serviceStatus.innerHTML = ("\n" + "\u2022" + " Service connection verified!"); 
            setTimeout(setStatus, 1500); 
            .fail(function () { 
                serviceStatus.innerHTML = "Service not properly connected."; 
    static showServiceError = (jqXHR, statusText, errorThrown) => { 
      alert("Error returned from service. See the console for details."); 
      const serviceError = lt.Document.ServiceError.parseError(jqXHR, statusText, errorThrown); 
    static log = (message, data) => { 
      const outputElement = document.getElementById("output"); 
      if (outputElement) { 
        const time = (new Date()).toLocaleTimeString(); 
        const textElement = document.createElement("p"); 
        textElement.innerHTML = "\u2022" + " [" + time + "]: " + message; = "text-align: left;"; 
        outputElement.appendChild(textElement, outputElement.firstChild); 
      if (!data) 
        console.log(message, data); 

Open the App.js file in the src folder and replace the HTML with the following code:

import React from 'react'; 
import './App.css'; 
function App() { 
  return ( 
    <div className="App"> 
      <header className="App-header"> 
        <p id="serviceStatus"></p> 
        <h3>React Barcode Example </h3> 
        <div id="btnMenu"> 
        <input type="file" id="file-input" accept=".jpg,.jpeg,.png"></input> 
        <button id="addToViewer">Add Image To Viewer</button> 
        <button id="barcodeButton">Read Barcodes</button> 
        <div id="imageViewerDiv"></div> 
        <h6 id="output"></h6> 
export default App; 

Improve the Visuals of the Project

Navigate to App.css, in the src folder which creates our HTML elements. Replace its contents with the following code to improve the visuals of the application.

.App { 
  text-align: center; 
@media (prefers-reduced-motion: no-preference) { 
  .App-logo { 
    animation: App-logo-spin infinite 20s linear; 
.App-header { 
  background-color: #282c34; 
  min-height: 100vh; 
  display: flex; 
  flex-direction: column; 
  align-items: center; 
  justify-content: center; 
  font-size: calc(10px + 2vmin); 
  color: white; 
.App-link { 
  color: #61dafb; 
@keyframes App-logo-spin { 
  from { 
    transform: rotate(0deg); 
  to { 
    transform: rotate(360deg); 
 background-color: #555555; 
 display: flex; 
 flex-direction: column; 
 width: 350px; 
 padding: 10px; 
  background-color: #888888; 
   width: 70%; 
   padding-left: 15px; 
   padding-right: 15px; 
  background-color: rgba(170, 170, 170, 1); 
  border-radius: 1%; 
  margin-top: 5px; 
  height: 400px; 
  width: 400px; 

Add the Barcode Read Code

Open ltlogic.js, and add the following code prior to the end of the window.onload() function.

//Create an Image Viewer 
let imageViewerDiv = document.getElementById("imageViewerDiv"); 
const createOptions = new lt.Controls.ImageViewerCreateOptions(imageViewerDiv); 
this.imageViewer = new lt.Controls.ImageViewer(createOptions); 
this.imageViewer.zoom(, 1, imageViewer.defaultZoomOrigin); 
this.imageViewer.viewVerticalAlignment =; 
this.imageViewer.viewHorizontalAlignment =; 
this.imageViewer.autoCreateCanvas = true; 
this.imageViewer.imageUrl = ""; 
//Create variables Grabbing the HTML elements 
let fileList = document.getElementById("file-input"); 
let btn = document.getElementById("addToViewer"); 
btn.onclick = (function () { 
  //create our iterator 
  // let i = 0; 
  //initially set our target to the first child of the uploaded files, then iterate it so 
  //subsequent images can be loaded in. 
  let files = fileList.files[0]; 
  let newUrl = window.URL.createObjectURL(files); 
  imageViewer.imageUrl = newUrl; 
  // i++; 
//Create the Barcode Button 
var barcodeBtn = document.getElementById("barcodeButton"); 
//Create the Click Event 
barcodeBtn.onclick = function () { 
//Before running Barcode Recognition, we check if an image has been uploaded 
// let i = 0; 
if (!fileList.files[0]) { 
  alert("No Image Chosen for Barcode Recognition. Select an Image via Choose File, before getting the Barcode"); 
else { 
  lt.Document.DocumentFactory.loadFromFile(fileList.files[0], new lt.Document.LoadDocumentOptions()) 
    .done((leadDoc) => { 
      console.log("Document loaded and has cache id: " + leadDoc.documentId); 
      let leadRectD = lt.LeadRectD.empty; 
      DocumentHelper.log("Barcode Recognition Starting..."); 
      let output = document.getElementById('output'); 
      let scrollOptions = { 
        left: output.offsetParent.offsetWidth, 
        top: output.offsetParent.offsetHeight, 
        behavior: 'smooth' 
        .done((CharacterData) => { 
          DocumentHelper.log("Barcode's value: " + CharacterData[0]._data); 

Run the Document Service

In order to run this application successfully, the LEADTOOLS .NET Framework Document Service is required. The LEADTOOLS .NET Framework Document Service project is located at <INSTALL_DIR>\LEADTOOLS22\Examples\Document\JS\DocumentServiceDotNet\fx.


Only the .NET FrameWork Document Service is able to uploadDocumentBlob, so this will not function with the .NET Core Document Service.

Open the DocumentService.csproj and run the project using IIS Express. After running the Document Service project in Visual Studio, the webpage will show that the service is listening. The Client Side will be able to communicate with the Document Service, allowing the Image Data processing, and returning the Barcodes from the image.

Run Document service

Run the Project

To run the barcode project, open a new terminal window and cd into the root of the project. From there run the command, yarn start. If you do not have the node modules included with the project, be sure to also run the command, npm install before running the project.

To test the project, follow the step below:


This tutorial showed how to detect and extract barcode values.

See Also

Help Version 22.0.2024.3.20
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.