ExcelJS JavaScript (Node.js) के लिए: Excel फ़ाइलें बनाने और पार्स करने की पूरी गाइड

1. ExcelJS क्या है और इसकी ज़रूरत क्यों है?

ExcelJS JavaScript भाषा के लिए एक शक्तिशाली और लचीली लाइब्रेरी है, जो Excel (XLSX, XLSM, CSV और अन्य) फ़ॉर्मेट में स्प्रेडशीट के साथ काम करने के लिए डिज़ाइन की गई है। यह Node.js वातावरण और ब्राउज़र (Webpack या Browserify जैसे मॉड्यूल बंडलर्स के माध्यम से) दोनों में काम करती है। ExcelJS डेवलपर्स को Microsoft Excel एप्लिकेशन का उपयोग किए बिना प्रोग्रामेटिक रूप से Excel फ़ाइलें बनाने, पढ़ने, बदलने और पार्स करने की अनुमति देती है।

ExcelJS की ज़रूरत क्यों है? आधुनिक वेब डेवलपमेंट और बिज़नेस प्रोसेस ऑटोमेशन में, Excel डेटा एक्सचेंज के लिए सबसे लोकप्रिय फ़ॉर्मेट में से एक बना हुआ है। रिपोर्ट, डेटाबेस से एक्सपोर्ट, वित्तीय दस्तावेज़, प्राइस लिस्ट, स्टैटिस्टिक्स — इन सभी को अक्सर Excel में एक्सपोर्ट करने की आवश्यकता होती है। ExcelJS लाइब्रेरी इन कार्यों को हल करने के लिए टूल का एक पूरा सेट प्रदान करती है: एक साधारण डेटा टेबल बनाने से लेकर मर्ज किए गए सेल, स्टाइल, फ़ॉर्मूले, चार्ट और कंडीशनल फ़ॉर्मेटिंग वाली जटिल रिपोर्ट तक। इसके अलावा, यह मौजूदा Excel फ़ाइलों को पार्स (पढ़) सकती है, जिससे टेबल से डेटा आयात को स्वचालित किया जा सकता है।

ExcelJS के अन्य विकल्पों (जैसे SheetJS का xlsx) पर मुख्य लाभ:

• स्टाइल सपोर्ट: रंग, फ़ॉन्ट, बॉर्डर, अलाइनमेंट, फ़िल।
• फ़ॉर्मूले के साथ काम: फ़ॉर्मूले पढ़ना और लिखना।
• कंडीशनल फ़ॉर्मेटिंग: सेल के मानों के आधार पर उनका स्वरूप बदलना।
• चार्ट: ग्राफ़ और चार्ट बनाना।
• इमेज: शीट में इमेज डालना।
• स्ट्रीम प्रोसेसिंग: पूरी फ़ाइल को मेमोरी में लोड किए बिना बड़ी फ़ाइलों के साथ काम करना।
• सक्रिय सपोर्ट: लाइब्रेरी नियमित रूप से अपडेट होती है और इसका एक बड़ा समुदाय है।

2. इंस्टॉलेशन

Node.js प्रोजेक्ट में ExcelJS इंस्टॉल करना npm पैकेज मैनेजर के माध्यम से किया जाता है। अपने प्रोजेक्ट की रूट फ़ोल्डर में टर्मिनल खोलें और यह कमांड चलाएँ:

npm install exceljs

इंस्टॉलेशन पूरा होने के बाद, आप अपने कोड में लाइब्रेरी को इम्पोर्ट कर सकते हैं:

const ExcelJS = require('exceljs');

यदि आप ES-मॉड्यूल (आधुनिक import/export सिंटैक्स) का उपयोग कर रहे हैं, तो सुनिश्चित करें कि आपके package.json में "type": "module" फ़्लैग सेट है, या फ़ाइल एक्सटेंशन .mjs का उपयोग करें:

import ExcelJS from 'exceljs';

3. त्वरित शुरुआत — न्यूनतम कार्यशील उदाहरण

चलिए एक सरल Excel फ़ाइल बनाते हैं जिसमें एक टेबल हो और उसे डिस्क पर सेव करते हैं। यह उदाहरण मुख्य चरणों को दर्शाता है: वर्कबुक बनाना, शीट जोड़ना, डेटा लिखना और सेव करना।

const ExcelJS = require('exceljs');

async function createSimpleExcel() {
    // 1. एक नई वर्कबुक बनाएँ
    const workbook = new ExcelJS.Workbook();
    
    // 2. "मेरा डेटा" नाम से एक शीट जोड़ें
    const worksheet = workbook.addWorksheet('मेरा डेटा');
    
    // 3. कॉलम (हेडर) परिभाषित करें
    worksheet.columns = [
        { header: 'ID', key: 'id', width: 10 },
        { header: 'नाम', key: 'name', width: 30 },
        { header: 'उम्र', key: 'age', width: 10 },
        { header: 'शहर', key: 'city', width: 20 }
    ];
    
    // 4. डेटा के साथ पंक्तियाँ जोड़ें
    worksheet.addRow({ id: 1, name: 'अन्ना इवानोवा', age: 28, city: 'मॉस्को' });
    worksheet.addRow({ id: 2, name: 'पीटर पेट्रोव', age: 35, city: 'सेंट पीटर्सबर्ग' });
    worksheet.addRow({ id: 3, name: 'ऐलेना सिदोरोवा', age: 22, city: 'नोवोसिबिर्स्क' });
    
    // 5. वर्कबुक को फ़ाइल में सेव करें
    await workbook.xlsx.writeFile('output.xlsx');
    console.log('फ़ाइल output.xlsx सफलतापूर्वक बनाई गई!')