{"name":"Excel-NodeJs-Read-Write-Logic","generatedAt":"2026-10-04T08:25:35.841Z","languages":{"JavaScript":3192},"commitTotal":1,"commits":[{"sha":"c1705605abf7fe8ed7a7d79d9deb694e3154c5f8","message":"Initial commit: Add Excel utilities with read/write/search examples and comprehensive README","date":"2026-02-17T12:35:11Z","author":"Aayush Mishra","login":"Aayush-Mishraa","avatar":"https://avatars.githubusercontent.com/u/89012492?v=4","verified":false,"url":"https://github.com/Aayush-Mishraa/Excel-NodeJs-Read-Write-Logic/commit/c1705605abf7fe8ed7a7d79d9deb694e3154c5f8"}],"readmeHtml":"

ExcelUtils

\n

Excel read and write operations using ExcelJS: includes examples for reading data, finding cells by value, updating cells with column offsets, and dynamic search-and-replace functionality.

\n

Overview

\n

This project demonstrates how to work with Excel files using the ExcelJS library in Node.js. It includes multiple examples for common operations:

\n\n

Dependencies

\n\n

Setup

\n

Install dependencies:

\n
npm install
\n

Running Examples

\n

Update the file paths in each script to match your Excel file location, then run:

\n
# Read Excel file\nnode ExcelReadWriteLogic/excelDemo.js\n\n# Write/Search with offset\nnode ExcelReadWriteLogic/ReadWriteDynamicSearch.js\n\n# Search and replace (hardcoded value)\nnode ExcelReadWriteLogic/WriteDataExcelSenario2.js\n\n# Search and replace (with offset)\nnode ExcelReadWriteLogic/demo.js
\n

Line-by-Line Explanations

\n

ReadWriteDynamicSearch.js

\n

The main flow: load workbook -> find a value -> offset the cell -> update -> save.

\n
    \n
  1. const ExcelJS = require('exceljs'); - Import ExcelJS library
    2. \n
  2. async function writeExcelFile(searchText, replaceText, chnage, filePath) - Function to find and update a cell with optional offset
    3. \n
  3. const workbook = new ExcelJS.Workbook(); - Create a new workbook instance
    4. \n
  4. await workbook.xlsx.readFile(filePath) - Load Excel file asynchronously
    5. \n
  5. const worksheet = workbook.getWorksheet('Sheet1'); - Get the worksheet named 'Sheet1'
    6. \n
  6. const output = await readExcel(worksheet, searchText) - Call helper function to locate the search text
    7. \n
  7. const cell = worksheet.getCell(output.row, output.col+chnage.colChange) - Get cell at found coordinates, plus column offset
    8. \n
  8. cell.value = replaceText - Set new value to the cell
    9. \n
  9. await workbook.xlsx.writeFile(filePath) - Save workbook back to file
    10. \n
  10. async function readExcel(worksheet, searchText) - Helper function to scan and find a value
    11. \n
  11. worksheet.eachRow((row, rowNumber) => { ... }) - Iterate through each row
    12. \n
  12. row.eachCell((cell, colNumber) => { ... }) - Iterate through each cell in row
    13. \n
  13. if (cell.value === searchText) - Check if cell matches search text
    14. \n
  14. output.row = rowNumber; output.col = colNumber; - Store the coordinates when found
    15. \n
  15. return output; - Return the found coordinates
    16. \n
\n

excelDemo.js

\n

Basic read example that prints all cell values.

\n
    \n
  1. const ExcelJS = require('exceljs'); - Import ExcelJS
    2. \n
  2. async function readExcelFile() - Async function to read sheet
    3. \n
  3. const workbook = new ExcelJS.Workbook(); - Create workbook
    4. \n
  4. await workbook.xlsx.readFile(filePath) - Read file into memory (I/O is async)
    5. \n
  5. const worksheet = workbook.getWorksheet('Sheet1'); - Get worksheet
    6. \n
  6. worksheet.eachRow((row, rowNumber) => { ... }) - Iterate rows
    7. \n
  7. row.eachCell((cell, colNumber) => { ... }) - Iterate cells
    8. \n
  8. console.log(cell.value); - Print each cell value
    9. \n
  9. readExcelFile(); - Execute the function
    10. \n
\n

WriteDataExcelSenario2.js

\n

Find a specific hardcoded value and update it with a new value.

\n
    \n
  1. let output = {row:-1, col:-1}; - Initialize output object to track found cell
    2. \n
  2. async function writeExcelFile() - Function to search and replace
    3. \n
  3. const workbook = new ExcelJS.Workbook(); - Create workbook
    4. \n
  4. await workbook.xlsx.readFile(filePath) - Load file
    5. \n
  5. const worksheet = workbook.getWorksheet('Sheet1'); - Get worksheet
    6. \n
  6. worksheet.eachRow(...) - Loop through rows
    7. \n
  7. if (cell.value === \"Apple\") - Check for hardcoded value \"Apple\"
    8. \n
  8. output.row = rowNumber; output.col = colNumber; - Store coordinates
    9. \n
  9. const cell = worksheet.getCell(output.row, output.col) - Get the found cell
    10. \n
  10. cell.value = (\"Aayush Mishra\") - Update with new value
    11. \n
  11. await workbook.xlsx.writeFile(filePath) - Save file
    12. \n
  12. writeExcelFile(); - Execute
    13. \n
\n

demo.js

\n

Similar to ReadWriteDynamicSearch.js but without comments. Demonstrates search with offset capability.

\n

Ideas and Improvements

\n
    \n
  1. Add error handling: Check if the searched value is found before updating (avoid updating -1,-1 coordinates)
    2. \n
  2. Support multiple sheets: Allow specifying sheet name as parameter instead of hardcoding 'Sheet1'
    3. \n
  3. Batch operations: Add ability to find and replace multiple values in one operation
    4. \n
  4. CSV/JSON support: ExcelJS also supports CSV and JSON, could add examples
    5. \n
  5. Fix typo in variable names: Rename chnage to change and rowchage to rowChange for clarity
    6. \n
  6. Create a utility module: Extract common functions into a reusable module
    7. \n
  7. Add logging: Implement better logging for debugging and monitoring
    8. \n
  8. Support formulas: Add examples of reading/writing formulas, not just values
    9. \n
  9. Styling: Add examples of formatting cells (color, font, borders)
    10. \n
  10. Validation: Add input validation for file paths and sheet names
    11. \n
\n

Notes

\n\n
","tree":{"fileCount":8,"dirCount":1,"truncated":false,"extensions":[{"ext":"js","count":3},{"ext":"json","count":2},{"ext":"gitignore","count":1},{"ext":"other","count":1},{"ext":"md","count":1}],"topLevel":[{"name":"ExcelReadWriteLogic","type":"dir"},{"name":".gitignore","type":"file"},{"name":"package-lock.json","type":"file"},{"name":"package.json","type":"file"},{"name":"README.md","type":"file"}]}}