Convertir des pages Web en images haute résolution est une exigence courante pour les rapports, la création de vignettes et le rendu d’e‑mails. Le Aspose.CAD Cloud SDK for Node.js propose une solution robuste qui simplifie la conversion de HTML en JPG directement sur votre serveur. Ce guide vous accompagne dans l’installation du SDK, la configuration des identifiants, l’écriture du code de conversion et l’utilisation de l’API REST avec cURL, afin que vous puissiez intégrer la conversion HTML‑vers‑JPG dans n’importe quelle application Node.JS.

Étapes pour convertir HTML en JPG avec Node.JS

Configurer les informations d’identification Aspose.CAD Cloud : Créez un objet de configuration et définissez votre ID client ainsi que votre secret.

const config = new CadApi.Configuration();
config.clientId = 'YOUR_CLIENT_ID';
config.clientSecret = 'YOUR_CLIENT_SECRET';
  1. Créer l’instance de l’API CAD : Utilisez la configuration pour instancier le client API.
const cadApi = new CadApi.CadApi(config);
  1. Définir les chemins d’entrée HTML et de sortie JPG : Résoudre les chemins absolus pour le fichier HTML source et le fichier JPG cible.
const inputPath = path.resolve(__dirname, 'sample.html');
const outputPath = path.resolve(__dirname, 'sample.jpg');
  1. Préparer la requête de conversion : Joignez un flux lisible du fichier HTML et spécifiez le format de sortie comme jpg.
const request = new CadApi.ConvertRequest();
request.inputFile = fs.createReadStream(inputPath);
request.format = 'jpg';
  1. Exécuter la conversion et enregistrer le JPG : Appelez convert, recevez un Buffer et écrivez‑le sur le disque. Cela complète le processus de conversion de HTML en JPG dans 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);
}

Pour des informations détaillées sur les classes, consultez la Référence de l’API.

Exemple complet de conversion HTML en JPG

L’exemple suivant démontre le flux de travail complet du début à la 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();

Remarque : Cet exemple de code démontre la fonctionnalité de base. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées, et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Générer JPG à partir de HTML avec cURL

Vous pouvez obtenir la même conversion via l’API REST. Ci‑dessous les commandes cURL requises.

  1. Obtenir un jeton d’accès
    Remplacez YOUR_CLIENT_ID et YOUR_CLIENT_SECRET par vos identifiants.
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. Téléverser le fichier HTML source
    Utilisez le jeton d’accès de l’étape précédente.
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. Demande de conversion en JPG
    Le paramètre de requête format spécifie le format cible.
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. Téléchargez le JPG résultant (si vous avez utilisé un autre point de terminaison pour la conversion).
curl -X GET "https://api.aspose.cloud/v3.0/cad/storage/file/sample.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample.jpg

Pour plus de détails, consultez la documentation officielle de l’API.

Installation et configuration Aspose.CAD Cloud SDK for Node.JS

Installez le SDK via npm :

npm install @asposecloud/aspose-cad-cloud

Le package est disponible en téléchargement sur la page de publication.
Assurez-vous d’avoir Node.js 12 ou une version supérieure installé et d’avoir créé un compte Aspose Cloud pour obtenir votre clientId et clientSecret.

Aspose.CAD Cloud SDK Capacités pour la génération d’images

  • Conversion HTML en JPG - Rendre directement les pages HTML en images JPG de haute qualité sans étapes intermédiaires.
  • Traitement basé sur le flux - Accepte l’entrée sous forme de flux lisible, ce qui est idéal pour les gros fichiers ou lors de la lecture depuis la mémoire.
  • Formats de sortie multiples - En plus du JPG, le SDK prend en charge PNG, BMP, GIF, et TIFF, permettant une génération d’images flexible.
  • Moteur de rendu hébergé dans le cloud - Exploite l’infrastructure cloud d’Aspose pour des conversions rapides et fiables.
  • Référence API complète - La Référence API en ligne fournit les signatures complètes des méthodes, les paramètres requis et optionnels, le flux d’authentification, les schémas de requête/réponse et les codes d’erreur, ainsi que des dizaines d’extraits de code spécifiques à chaque langage (C#, Java, Python, Node.js) illustrant des tâches courantes telles que la conversion CAD‑en‑JPG, le réglage de la qualité d’image et la gestion d’entrées en flux. Voir la Référence API.

Conclusion

Vous savez maintenant comment convertir du HTML en JPG dans Node.JS en utilisant le puissant Aspose.CAD Cloud SDK for Node.js. Le SDK gère la gestion des identifiants, le traitement des flux et la sélection du format, vous offrant une solution prête à l’emploi pour la génération d’images côté serveur. N’oubliez pas d’obtenir une licence temporaire depuis la page de licence temporaire pour les tests, et d’acheter une licence complète pour les déploiements en production. Bon codage!

FAQs

Comment puis‑je convertir du HTML en JPG dans Node.JS en utilisant Aspose.CAD ?
Utilisez le SDK Cloud Aspose.CAD pour Node.js pour créer un ConvertRequest, définir format sur 'jpg', et appeler la méthode convert. L’exemple de code complet dans cet article montre les étapes exactes.

La conversion est-elle effectuée localement ou dans le cloud ?
Le SDK envoie la requête aux services Aspose.CAD Cloud, de sorte que le traitement se déroule dans le cloud tandis que votre code Node.JS orchestre le flux de travail.

Quels formats de fichiers sont pris en charge pour l’entrée et la sortie ?
Le SDK prend en charge un large éventail de formats CAD et d’images. Pour la conversion HTML vers image, vous pouvez générer des fichiers JPG, PNG, BMP, GIF ou TIFF. Voir la Référence API pour la liste complète.

Dois-je acheter une licence pour une utilisation en production ?
Une licence temporaire est disponible pour l’évaluation sur la page de licence temporaire. Pour la production, vous devez acquérir une licence commerciale auprès d’Aspose.

En savoir plus