https://github.com/tommertom/node_xls2json
Small node script that takes an excel sheet with headers and transforms all rows into a JSON array
https://github.com/tommertom/node_xls2json
Last synced: 9 months ago
JSON representation
Small node script that takes an excel sheet with headers and transforms all rows into a JSON array
- Host: GitHub
- URL: https://github.com/tommertom/node_xls2json
- Owner: Tommertom
- Created: 2023-12-07T20:55:07.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-07T21:09:38.000Z (about 2 years ago)
- Last Synced: 2025-02-06T10:16:49.021Z (11 months ago)
- Language: JavaScript
- Size: 10.7 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Excel to JSON Converter
This Node.js script converts Excel files into JSON format. It utilizes the `xlsx` library for reading Excel files and `fs` for file system operations. The purpose of this script is to facilitate the conversion of Excel data into a more accessible JSON format.(README text 99% generated by ChatGPT)
## Usage
### Prerequisites
Make sure you have Node.js installed on your system. If not, you can download it [here](https://nodejs.org/).
### Installation
You need xlsx package.
```bash
npm install xlsx
```
### Command
```bash
node excelToJson.js
```
- _inputFile_: The path to the Excel file you want to convert.
- _outputFile_: The path to the JSON file where the converted data will be saved.
### Example
```bash
node excelToJson.js map1.xlsx output.json
```
## Minimal Excel Sheet Specifications
For successful conversion, the Excel sheet should adhere to the following specifications:
- The first row is considered as the header containing field names.
- Data starts from the second row.
- Each column should have a header (field name) in the first row.
- Data types are not preserved in the conversion but made into strings.
- Ensure that the Excel sheet is well-formed and does not contain merged cells or complex structures.
## Script Overview
- Read the Excel file using the xlsx library.
- Convert the specified sheet to JSON format.
- Extract field names from the first row and trim spaces.
- Create an array of objects with field names and corresponding values.
- Write the JSON data to the specified output file.
## Notes
- Ensure that the required command line parameters are provided.
- If the sheet name is not provided, it defaults to the first sheet.
- The resulting JSON file will be formatted with two-space indentation.
Feel free to use this script to streamline the process of converting Excel data to JSON in your Node.js projects.