Converter páginas da web em imagens de alta resolução é uma necessidade comum para relatórios, criação de miniaturas e renderização de e‑mail. O Aspose.CAD Cloud SDK for Node.js oferece uma solução robusta que simplifica a conversão de HTML para JPG diretamente no seu servidor. Este guia orienta você na instalação do SDK, configuração de credenciais, escrita do código de conversão e uso da API REST com cURL, para que possa incorporar a conversão de HTML‑para‑JPG em qualquer aplicação Node.JS.

Etapas para Converter HTML em JPG no Node.JS

  1. Configure Aspose.CAD Cloud credentials: Crie um objeto de configuração e defina seu ID de cliente e segredo.
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. Criar a instância da API CAD: Use a configuração para instanciar o cliente da API.
const cadApi = new CadApi.CadApi(config);
  1. Definir caminhos de entrada HTML e saída JPG: Resolva caminhos absolutos para o arquivo HTML de origem e o arquivo JPG de destino.
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. Prepare a solicitação de conversão: Anexe um fluxo legível do arquivo HTML e especifique o formato de saída como jpg.
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. Execute a conversão e salve o JPG: Chame convert, receba um Buffer e escreva‑o no disco. Isso completa o processo de conversão de HTML para JPG em 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);
}

Para informações detalhadas sobre a classe, consulte a Referência da API.

Exemplo completo de conversão de HTML para JPG

O exemplo a seguir demonstra o fluxo de trabalho completo do início ao fim.

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();

Nota: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Gerar JPG a partir de HTML usando cURL

Você pode realizar a mesma conversão via a API REST. Abaixo estão os comandos cURL necessários.

  1. Obter um token de acesso
    Substitua YOUR_CLIENT_ID e YOUR_CLIENT_SECRET pelas suas credenciais.
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. Carregue o arquivo HTML de origem
    Use o token de acesso da etapa anterior.
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. Solicitar conversão para JPG
    O parâmetro de consulta format especifica o formato de destino.
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. Baixe o JPG resultante (se você usou um endpoint diferente para conversão).
curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg

Para mais detalhes, veja a documentação oficial da API.

Instalando e Configurando Aspose.CAD Cloud SDK for Node.JS

Instale o SDK via npm:

npm install @asposecloud/aspose-cad-cloud

O pacote está disponível para download na página de lançamento.
Certifique‑se de que você tem o Node.js 12 ou superior instalado e de que criou uma conta Aspose Cloud para obter seu clientId e clientSecret.

Aspose.CAD Cloud SDK Recursos para Geração de Imagens

  • Conversão de HTML para JPG - Renderiza diretamente páginas HTML como imagens JPG de alta qualidade sem etapas intermediárias.
  • Processamento baseado em stream - Aceita a entrada como um stream legível, ideal para arquivos grandes ou ao ler da memória.
  • Vários formatos de saída - Além de JPG, o SDK suporta PNG, BMP, GIF, e TIFF, permitindo geração flexível de imagens.
  • Motor de renderização hospedado na nuvem - Aproveita a infraestrutura de nuvem da Aspose para conversões rápidas e confiáveis.
  • Referência de API abrangente - A Referência de API online fornece assinaturas completas de métodos, parâmetros obrigatórios e opcionais, fluxo de autenticação, esquemas de requisição/resposta e códigos de erro, além de dezenas de trechos de código específicos por linguagem (C#, Java, Python, Node.js) que ilustram tarefas comuns como conversão de CAD‑para‑JPG, ajuste de qualidade de imagem e manipulação de entrada em stream. Veja a Referência de API.

Conclusão

Agora você sabe como converter HTML em JPG no Node.JS usando o poderoso Aspose.CAD Cloud SDK for Node.js. O SDK lida com o gerenciamento de credenciais, processamento de streams e seleção de formato, oferecendo uma solução pronta‑para‑executar para geração de imagens no lado do servidor. Lembre‑se de obter uma licença temporária na página de licença temporária para testes e adquirir uma licença completa para implantações em produção. Feliz codificação!

FAQs

Como posso converter HTML para JPG em Node.JS usando Aspose.CAD?
Use o SDK Aspose.CAD Cloud para Node.js para criar um ConvertRequest, definir format como 'jpg' e chamar o método convert. O exemplo completo de código neste artigo mostra as etapas exatas.

A conversão é realizada localmente ou na nuvem?
O SDK envia a solicitação para os serviços Aspose.CAD Cloud, portanto o processamento ocorre na nuvem enquanto seu código Node.JS orquestra o fluxo de trabalho.

Quais formatos de arquivo são suportados para entrada e saída?
O SDK oferece suporte a uma ampla variedade de formatos CAD e de imagem. Para conversão de HTML para imagem, você pode gerar JPG, PNG, BMP, GIF ou TIFF. Consulte a Referência da API para a lista completa.

Preciso comprar uma licença para uso em produção?
Uma licença temporária está disponível para avaliação na página de licença temporária. Para produção, você deve adquirir uma licença comercial da Aspose.

Leia Mais