Конвертировать HTML в JPG в Node.JS

Преобразование веб‑страниц в изображения высокого разрешения является распространённой задачей для создания отчётов, миниатюр и рендеринга электронных писем. Aspose.CAD Cloud SDK for Node.js предлагает надёжное решение, упрощающее конвертацию HTML в JPG непосредственно на вашем сервере. В этом руководстве вы узнаете, как установить SDK, настроить учётные данные, написать код конвертации и использовать REST API с cURL, чтобы встроить преобразование HTML‑в‑JPG в любое приложение Node.JS.

Шаги по конвертации HTML в JPG в Node.JS

Настройте учетные данные Aspose.CAD Cloud: Создайте объект конфигурации и задайте ваш client ID и secret.

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 API. Ниже приведены необходимые команды 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 for 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 Reference.

Заключение

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

Часто задаваемые вопросы

Как я могу конвертировать 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 Reference для полного списка.

Нужна ли мне покупка лицензии для использования в продакшн?
Временная лицензия доступна для оценки на странице страница временной лицензии. Для продакшн вам необходимо приобрести коммерческую лицензию у Aspose.

Шаги по конвертации HTML в JPG в Node.JS#

Полный рабочий пример конвертации HTML в JPG#

Создать JPG из HTML с помощью cURL#

Установка и настройка Aspose.CAD Cloud SDK for Node.JS#

Возможности Aspose.CAD Cloud SDK для генерации изображений#

Заключение#

Часто задаваемые вопросы#

Читать дальше#