مكتبة Node.js مجانية لفتح وقراءة ملفات إكسل

بدء الاستخدام مع read-excel-file

لتثبيت read-excel-file، يمكنك استخدام npm، مدير الحزم للـ JavaScript. يرجى استخدام الأوامر التالية لإكمال عملية التثبيت بنجاح.

npm install read-excel-file --save

قراءة ملفات إكسل الكبيرة في تطبيقات Node.js

غالبًا ما يحتاج مطورو البرمجيات إلى دمج قدرات قراءة ملفات Excel في تطبيقاتهم. تجعل مكتبة read-excel-file المفتوحة المصدر من السهل على المطورين تحميل وقراءة ملفات Excel الصغيرة والكبيرة داخل تطبيقات Node.js ببضع أسطر من الشيفرة فقط. تدعم المكتبة صيغ ملفات متعددة، بما في ذلك .xls و .xlsx، مما يجعلها متوافقة مع مجموعة واسعة من إصدارات Excel. بالإضافة إلى ذلك، تتعامل مع تحليل وتنسيق البيانات، مما يضمن أن المطورين يمكنهم الوصول بسهولة إلى المعلومات المستخرجة ومعالجتها. يوضح المثال الأساسي التالي كيفية قراءة ملف Excel في بيئة Node.js باستخدام أوامر JavaScript.

const readXlsxFile = require('read-excel-file/node');

// Path to your Excel file
const filePath = 'path/to/your/excel-file.xlsx';

readXlsxFile(filePath).then((rows) => {
  // rows is an array of arrays representing the rows and columns of the Excel file
  console.log(rows);
}).catch((error) => {
  console.error('Error reading Excel file:', error);
});

تحليل بيانات مرن في Node.js

تتضمن مكتبة read-excel-file المفتوحة المصدر دعمًا كاملاً لتحليل البيانات المرن، مما يتيح لمطوري البرمجيات تعريف مخططات مخصصة لتفسير البيانات. هذه الميزة مفيدة بشكل خاص عند التعامل مع ملفات Excel المعقدة التي تحتوي على أنواع وهياكل بيانات مختلفة. من خلال تعريف مخطط، يمكنك ضمان تحليل البيانات بشكل صحيح ومتسق. للسيناريوهات المتقدمة، يمكنك تعريف مخطط لربط أعمدة Excel بأنواع وهياكل بيانات محددة. يوضح المثال التالي كيف يمكن لمطوري البرمجيات تعريف مخطط مخصص للتحقق من بنية ومحتوى ملفات Excel داخل تطبيقات Node.js.

const schema = {
  'Column 1': {
    prop: 'column1',
    type: String,
    required: true
  },
  'Column 2': {
    prop: 'column2',
    type: Number
  }
};

readXlsxFile(filePath, { schema }).then(({ rows, errors }) => {
  if (errors.length > 0) {
    console.error('Validation errors:', errors);
  } else {
    console.log(rows);
  }
});

أنواع مخصصة وتحليل التواريخ في Node.js

توفر مكتبة read-excel-file دعمًا قويًا للأنواع المخصصة وتحليل التواريخ، وهو مفيد بشكل خاص عند التعامل مع هياكل بيانات معقدة في ملفات Excel. هذه الميزة مفيدة للغاية وتسمح لمطوري البرمجيات بتحديد كيفية تحليل الأنواع المختلفة من البيانات، بما في ذلك التواريخ، لضمان سلامة البيانات وتناسقها. لتعريف مخطط مخصص، تقوم بإنشاء كائن حيث تكون المفاتيح هي أسماء الأعمدة من ملف Excel، والقيم تصف الخصائص والأنواع وقواعد التحقق لتلك الأعمدة. في المثال أدناه يتم تحليل قيم عمود "Event Date" إلى كائنات Date، ويتم استخدام طريقة toISOString لتنسيق التواريخ كسلاسل ISO.

const readXlsxFile = require('read-excel-file/node');

// Schema with date parsing
const schema = {
  'Event Date': {
    prop: 'eventDate',
    type: Date,
    required: true
  }
};

// Read and parse the Excel file with date parsing
readXlsxFile('path/to/file.xlsx', { schema }).then(({ rows, errors }) => {
  if (errors.length > 0) {
    console.error('Validation errors:', errors);
  } else {
    rows.forEach(row => {
      console.log(`Event Date: ${row.eventDate.toISOString()}`);
    });
  }
}).catch((error) => {
  console.error('Error reading Excel file:', error);
});

دعم تحسين معالجة الأخطاء

تُدمَج ميزات معالجة الأخطاء القوية في حزمة read-excel-file المفتوحة المصدر. تُسجَّل مشكلات التحقق التي تنشأ أثناء التحليل ويمكن التعامل معها أو تسجيلها بشكل مناسب. لضمان سلامة البيانات المقروءة، تشمل المكتبة قواعد التحقق وتقدم إشارات خطأ واضحة. هذا يسهل على المطورين العثور على المشكلات وإصلاحها في البيانات أو ملف Excel نفسه بسرعة أكبر.