Перетворення веб‑сторінок у зображення високої роздільної здатності є поширеною вимогою для звітності, створення мініатюр та рендерингу електронної пошти. Aspose.CAD Cloud SDK for Node.js пропонує надійне рішення, яке спрощує конвертацію HTML у JPG безпосередньо на вашому сервері. У цьому посібнику ви дізнаєтеся, як встановити SDK, налаштувати облікові дані, написати код конвертації та використовувати REST API за допомогою cURL, щоб ви могли вбудувати конвертацію HTML‑to‑JPG у будь‑який застосунок Node.JS.

Кроки для конвертації HTML у JPG у Node.JS

  1. Налаштуйте облікові дані Aspose.CAD Cloud: Створіть об’єкт конфігурації та встановіть ваш client ID і secret.
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. Створіть екземпляр CAD API: Використайте конфігурацію для створення клієнта API.
const cadApi = new CadApi.CadApi(config);
  1. Визначте вхідний HTML та вихідний JPG шляхи: Отримайте абсолютні шляхи до вихідного HTML‑файлу та цільового JPG‑файлу.
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. Підготуйте запит на конвертацію: Прикріпіть потік читання HTML‑файлу та вкажіть вихідний формат як jpg.
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. Виконайте конвертацію та збережіть 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 API. Нижче наведено необхідні команди cURL.

  1. Отримайте токен доступу
    Замініть 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"
  1. Завантажте вихідний 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"
  1. Запит на конвертацію у 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
  1. Завантажте отриманий 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 for Node.JS

Встановіть SDK за допомогою npm:

npm install @asposecloud/aspose-cad-cloud

Пакет доступний для завантаження на сторінці Release page.
Переконайтеся, що у вас встановлено Node.js 12 або новішу версію, і що ви створили обліковий запис Aspose Cloud, щоб отримати ваш clientId та clientSecret.

Aspose.CAD Cloud SDK Можливості для генерації зображень

  • HTML to JPG conversion – Безпосередньо рендерить HTML‑сторінки у високоякісні JPG‑зображення без проміжних кроків.
  • Stream‑based processing – Приймає вхідні дані у вигляді читабельного потоку, що ідеально підходить для великих файлів або читання з пам’яті.
  • Multiple output formats – Окрім JPG, SDK підтримує PNG, BMP, GIF, і TIFF, що забезпечує гнучке створення зображень.
  • Cloud‑hosted rendering engine – Використовує хмарну інфраструктуру Aspose для швидких і надійних конвертацій.
  • Comprehensive API reference – Онлайн‑довідник API надає повні сигнатури методів, обов’язкові та необов’язкові параметри, процес автентифікації, схеми запитів/відповідей та коди помилок, а також десятки прикладів коду для різних мов (C#, Java, Python, Node.js), що ілюструють типові завдання, такі як конвертація CAD у JPG, налаштування якості зображення та обробка потокового вводу. Дивіться API Reference.

Висновок

Тепер ви знаєте, як конвертувати HTML у JPG у Node.JS, використовуючи потужний Aspose.CAD Cloud SDK for Node.js. SDK керує управлінням обліковими даними, обробкою потоків і вибором формату, надаючи готове до запуску рішення для серверної генерації зображень. Не забудьте отримати тимчасову ліцензію зі сторінки тимчасової ліцензії для тестування та придбати повну ліцензію для виробничих розгортань. Щасливого кодування!

Питання та відповіді

Як я можу конвертувати HTML у JPG у Node.JS за допомогою Aspose.CAD?
Використовуйте Aspose.CAD Cloud SDK для Node.js, щоб створити ConvertRequest, встановити format у 'jpg' і викликати метод convert. Повний приклад коду в цій статті показує точні кроки.

Чи виконується конвертація локально чи в хмарі?
The SDK sends the request to Aspose.CAD Cloud services, so the processing happens in the cloud while your Node.JS code orchestrates the workflow.

Які формати файлів підтримуються для вводу та виводу?
SDK підтримує широкий спектр CAD та графічних форматів. Для конвертації HTML у зображення ви можете отримати JPG, PNG, BMP, GIF або TIFF. Дивіться API Reference для повного списку.

Чи потрібно купувати ліцензію для використання у продакшн?
Тимчасова ліцензія доступна для оцінки на сторінка тимчасової ліцензії. Для продакшн використання ви повинні придбати комерційну ліцензію від Aspose.

Read More