Convertir páginas web en imágenes de alta resolución es una necesidad común para la generación de informes, la creación de miniaturas y la renderización de correos electrónicos. El Aspose.CAD Cloud SDK for Node.js ofrece una solución robusta que simplifica la conversión de HTML a JPG directamente en su servidor. Esta guía le muestra cómo instalar el SDK, configurar credenciales, escribir el código de conversión y usar la API REST con cURL, para que pueda incrustar la conversión de HTML a JPG en cualquier aplicación Node.JS.

Pasos para convertir HTML a JPG en Node.JS

  1. Configure Aspose.CAD Cloud credentials: Cree un objeto de configuración y establezca su ID de cliente y secreto.
const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. Crear la instancia de la API CAD: Utilice la configuración para instanciar el cliente API.
const cadApi = new CadApi.CadApi(config);
  1. Definir rutas de entrada HTML y salida JPG: Resuelve rutas absolutas para el archivo HTML de origen y el archivo JPG de destino.
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. Prepare la solicitud de conversión: Adjunte un flujo legible del archivo HTML y especifique el formato de salida como jpg.
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. Ejecute la conversión y guarde el JPG: Llame a convert, reciba un Buffer y escríbalo en disco. Esto completa el proceso para convertir HTML a JPG en 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 obtener información detallada de la clase, consulte la Referencia de API.

Ejemplo completo de trabajo para la conversión de HTML a JPG

El siguiente ejemplo muestra el flujo de trabajo completo de principio a fin.

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 ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Generar JPG a partir de HTML usando cURL

Puede lograr la misma conversión a través de la API REST. A continuación se muestran los comandos cURL requeridos.

  1. Obtener un token de acceso
    Reemplace YOUR_CLIENT_ID y YOUR_CLIENT_SECRET con sus credenciales.
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. Cargar el archivo HTML de origen
    Utilice el token de acceso del paso 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 conversión a JPG
    El parámetro de consulta format especifica el 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. Descargar el JPG resultante (si utilizó un endpoint diferente para la conversión).
curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg

Para más detalles, consulte la documentación oficial de la API.

Instalación y configuración Aspose.CAD Cloud SDK for Node.JS

Instale el SDK mediante npm:

npm install @asposecloud/aspose-cad-cloud

El paquete está disponible para descargar en la página de lanzamientos.
Asegúrese de tener Node.js 12 o superior instalado y de haber creado una cuenta de Aspose Cloud para obtener su clientId y clientSecret.

Capacidades del SDK Aspose.CAD Cloud para la generación de imágenes

  • Conversión de HTML a JPG - Renderiza directamente páginas HTML como imágenes JPG de alta calidad sin pasos intermedios.
  • Procesamiento basado en streams - Acepta la entrada como un stream legible, lo que es ideal para archivos grandes o cuando se lee desde la memoria.
  • Múltiples formatos de salida - Además de JPG, el SDK admite PNG, BMP, GIF, y TIFF, lo que permite una generación de imágenes flexible.
  • Motor de renderizado alojado en la nube - Aprovecha la infraestructura en la nube de Aspose para conversiones rápidas y fiables.
  • Referencia completa de la API - La referencia de API en línea proporciona firmas completas de los métodos, parámetros requeridos y opcionales, flujo de autenticación, esquemas de solicitud/respuesta y códigos de error, además de docenas de fragmentos de código específicos por lenguaje (C#, Java, Python, Node.js) que ilustran tareas comunes como la conversión de CAD a JPG, ajuste de calidad de imagen y manejo de entrada por streaming. Consulte la API Reference.

Conclusión

Ahora sabes cómo convertir HTML a JPG en Node.JS usando el potente Aspose.CAD Cloud SDK for Node.js. El SDK gestiona la administración de credenciales, el procesamiento de flujos y la selección de formato, brindándote una solución lista para ejecutar en la generación de imágenes del lado del servidor. Recuerda obtener una licencia temporal desde la página de licencia temporal para pruebas y adquirir una licencia completa para implementaciones en producción. ¡Feliz codificación!

FAQs

¿Cómo puedo convertir HTML a JPG en Node.JS usando Aspose.CAD?
Utilice el SDK de Aspose.CAD Cloud para Node.js para crear un ConvertRequest, establezca format en 'jpg' y llame al método convert. El ejemplo de código completo en este artículo muestra los pasos exactos.

¿La conversión se realiza localmente o en la nube?
El SDK envía la solicitud a los servicios de Aspose.CAD Cloud, por lo que el procesamiento se realiza en la nube mientras su código Node.JS orquesta el flujo de trabajo.

¿Qué formatos de archivo son compatibles para entrada y salida?
El SDK admite una amplia gama de formatos CAD e imágenes. Para la conversión de HTML a imagen, puede generar JPG, PNG, BMP, GIF o TIFF. Consulte la Referencia de API para la lista completa.

¿Necesito comprar una licencia para uso en producción?
Una licencia temporal está disponible para evaluación en la página de licencia temporal. Para producción, debe adquirir una licencia comercial de Aspose.

Leer más