تحويل HTML إلى JPG في Node.JS

تحويل صفحات الويب إلى صور عالية الدقة هو طلب شائع للتقارير وإنشاء الصور المصغرة وعرض البريد الإلكتروني. توفر Aspose.CAD Cloud SDK for Node.js حلاً قوياً يبسط عملية تحويل HTML إلى JPG مباشرةً على الخادم الخاص بك. يُرشدك هذا الدليل خلال تثبيت SDK، وتكوين بيانات الاعتماد، وكتابة كود التحويل، واستخدام REST API مع cURL، حتى تتمكن من دمج تحويل HTML‑to‑JPG في أي تطبيق Node.JS.

خطوات تحويل HTML إلى JPG في Node.JS

تكوين بيانات اعتماد Aspose.CAD Cloud: إنشاء كائن تكوين وتعيين معرف العميل والسر الخاص بك.

const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';

إنشاء مثيل CAD API: استخدم التكوين لإنشاء عميل API.

const cadApi = new CadApi.CadApi(config);

تحديد مسارات HTML الإدخال و JPG الإخراج: حل المسارات المطلقة لملف HTML المصدر وملف JPG الهدف.

const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');

تحضير طلب التحويل: إرفاق تدفق قابل للقراءة لملف HTML وتحديد تنسيق الإخراج كـ jpg.

const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';

تنفيذ التحويل وحفظ ملف JPG: استدعِ convert، استقبل Buffer، واكتبها إلى القرص. هذا يكمل عملية تحويل HTML إلى JPG في Node.JS.

try {
    const resultBuffer = await cadApi.convert(request);
    fs.writeFileSync(outputPath, resultBuffer);
    console.log('Conversion completed. JPG saved to:', outputPath);
} catch (err) {
    console.error('Error during conversion:', err);
}

لمزيد من المعلومات التفصيلية حول الفئات، يرجى الرجوع إلى مرجع API.

مثال كامل عملي لتحويل HTML إلى JPG

يوضح المثال التالي سير العمل الكامل من البداية إلى النهاية.

const fs = require('fs');
const path = require('path');
const CadApi = require('asposecadcloud');

async function convertHtmlToJpg() {
    // Configure Aspose.CAD Cloud credentials
    const config = new CadApi.Configuration();
    config.clientId = 'YOUR_CLIENT_ID';
    config.clientSecret = 'YOUR_CLIENT_SECRET';

// Create API instance
    const cadApi = new CadApi.CadApi(config);

// Define input HTML and output JPG paths
    const inputPath = path.resolve(__dirname, 'sample.html');
    const outputPath = path.resolve(__dirname, 'sample.jpg');

// Prepare request with a readable stream and target format
    const request = new CadApi.ConvertRequest();
    request.inputFile = fs.createReadStream(inputPath);
    request.format = 'jpg';

try {
        // Perform conversion; result is a Buffer containing JPG data
        const resultBuffer = await cadApi.convert(request);
        // Write the JPG buffer to the output file
        fs.writeFileSync(outputPath, resultBuffer);
        console.log('Conversion completed. JPG saved to:', outputPath);
    } catch (err) {
        console.error('Error during conversion:', err);
    }
}

// Execute the conversion
convertHtmlToJpg();

ملاحظة: هذا المثال البرمجي يوضح الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث أي مسارات ملفات وقيم التكوين لتطابق بيئتك الفعلية، وتحقق من أن جميع الاعتمادات المطلوبة مثبتة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشاكل، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

إنشاء JPG من HTML باستخدام cURL

يمكنك تحقيق نفس التحويل عبر واجهة برمجة التطبيقات REST. أدناه أوامر cURL المطلوبة.

الحصول على رمز وصول
استبدل YOUR_CLIENT_ID و YOUR_CLIENT_SECRET ببيانات الاعتماد الخاصة بك.

curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

تحميل ملف HTML المصدر
استخدم رمز الوصول من الخطوة السابقة.

curl -X PUT "https://api.aspose.cloud/v3.0/cad/storage/file/sample.html" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/html" \
--data-binary "@sample.html"

طلب التحويل إلى JPG
معلمة الاستعلام format تحدد الصيغة المستهدفة.

curl -X POST "https://api.aspose.cloud/v3.0/cad/convert?format=jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@sample.html" \
-o sample.jpg

تنزيل ملف JPG الناتج (إذا استخدمت نقطة نهاية مختلفة للتحويل).

curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg

لمزيد من التفاصيل، راجع وثائق API الرسمية.

تثبيت وتكوين Aspose.CAD Cloud SDK لـ Node.JS

قم بتثبيت SDK عبر npm:

npm install @asposecloud/aspose-cad-cloud

الحزمة متاحة للتنزيل على صفحة الإصدار.
تأكد من تثبيت Node.js 12 أو أعلى وأنك قد أنشأت حساب Aspose Cloud للحصول على clientId و clientSecret.

إمكانات Aspose.CAD Cloud SDK لإنشاء الصور

تحويل HTML إلى JPG - عرض صفحات HTML مباشرةً كصور JPG عالية الجودة دون خطوات وسيطة.
معالجة قائمة على التدفق - يقبل الإدخال كتيار قابل للقراءة، وهو مثالي للملفات الكبيرة أو عند القراءة من الذاكرة.
تنسيقات إخراج متعددة - بالإضافة إلى JPG، يدعم SDK تنسيقات PNG، BMP، GIF، وTIFF، مما يتيح إنشاء صور مرن.
محرك عرض مستضاف على السحابة - يستفيد من بنية سحابة Aspose لتوفير تحويلات سريعة وموثوقة.
مرجع API شامل - يوفر مرجع API على الإنترنت توقيعات الطرق الكاملة، المعلمات المطلوبة والاختيارية، تدفق المصادقة، مخططات الطلب/الاستجابة، وأكواد الأخطاء، بالإضافة إلى العشرات من مقتطفات الشيفرة الخاصة باللغات (C#, Java, Python, Node.js) التي توضح مهام شائعة مثل تحويل CAD إلى JPG، ضبط جودة الصورة، ومعالجة إدخال التدفق. راجع مرجع API.

الخاتمة

أنت الآن تعرف كيفية تحويل HTML إلى JPG في Node.JS باستخدام مجموعة أدوات Aspose.CAD Cloud SDK for Node.js القوية. تتولى مجموعة الأدوات إدارة الاعتمادات ومعالجة التدفقات واختيار الصيغة، مما يمنحك حلاً جاهزًا للتنفيذ لتوليد الصور على جانب الخادم. تذكر الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت للاختبار، وشراء ترخيص كامل للنشر في بيئات الإنتاج. برمجة سعيدة!

الأسئلة المتكررة

كيف يمكنني تحويل HTML إلى JPG في Node.JS باستخدام Aspose.CAD?
استخدم Aspose.CAD Cloud SDK for Node.js لإنشاء ConvertRequest، واضبط format إلى 'jpg'، واستدعِ طريقة convert. يوضح مثال الشيفرة الكامل في هذه المقالة الخطوات الدقيقة.

هل يتم التحويل محليًا أم في السحابة؟
SDK يرسل الطلب إلى خدمات Aspose.CAD Cloud، لذا تتم المعالجة في السحابة بينما يقوم كود Node.JS الخاص بك بتنظيم سير العمل.

ما هي صيغ الملفات المدعومة للإدخال والإخراج؟
يدعم SDK مجموعة واسعة من صيغ CAD والصور. لتحويل HTML إلى صورة، يمكنك إخراج JPG أو PNG أو BMP أو GIF أو TIFF. راجع دليل API للحصول على القائمة الكاملة.

هل أحتاج إلى شراء ترخيص للاستخدام في الإنتاج؟
ترخيص مؤقت متاح للتقييم في صفحة الترخيص المؤقت. للاستخدام في الإنتاج، يجب عليك الحصول على ترخيص تجاري من Aspose.

خطوات تحويل HTML إلى JPG في Node.JS#

مثال كامل عملي لتحويل HTML إلى JPG#

إنشاء JPG من HTML باستخدام cURL#

تثبيت وتكوين Aspose.CAD Cloud SDK لـ Node.JS#

إمكانات Aspose.CAD Cloud SDK لإنشاء الصور#

الخاتمة#

الأسئلة المتكررة#

اقرأ المزيد#