Esempio completo funzionante per la conversione da SVG a PNG in Node.JS

Questo esempio dimostra come convertire un file SVG memorizzato nello storage di GroupDocs Cloud in un’immagine PNG utilizzando il GroupDocs.Conversion Cloud SDK per Node.JS.

const { Configuration, ConvertApi, ConvertDocumentRequest, ConvertSettings, PngOptions, StorageApi, DownloadFileRequest } = require("@groupdocs/conversion-cloud");
const fs = require('fs');
const path = require('path');

// -----------------------------------------------------------------------------
// Configuration – replace with your own credentials
// -----------------------------------------------------------------------------
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

const convertApi = new ConvertApi(config);
const storageApi = new StorageApi(config);

// -----------------------------------------------------------------------------
// Define source SVG and target PNG locations inside GroupDocs Cloud storage
// -----------------------------------------------------------------------------
const inputSvgPath = "input/sample.svg";          // SVG stored in cloud storage
const outputPngPath = "output/sample.png";       // Desired PNG location

// -----------------------------------------------------------------------------
// PNG conversion options – set dimensions to control memory/CPU usage
// -----------------------------------------------------------------------------
const pngOptions = new PngOptions({
    width: 1024,               // Resize width (optional)
    height: 768,               // Resize height (optional)
    backgroundColor: "#FFFFFF" // Ensure opaque background
});

// -----------------------------------------------------------------------------
// Build conversion settings object
// -----------------------------------------------------------------------------
const convertSettings = new ConvertSettings({
    filePath: inputSvgPath,
    format: "png",
    outputPath: outputPngPath,
    options: pngOptions
});

const convertRequest = new ConvertDocumentRequest(convertSettings);

// -----------------------------------------------------------------------------
// Execute conversion, then download the PNG locally
// -----------------------------------------------------------------------------
convertApi.convertDocument(convertRequest)
    .then(convResult => {
        console.log("Conversion succeeded. Cloud file:", convResult.path);
        const downloadReq = new DownloadFileRequest({ path: convResult.path });
        return storageApi.downloadFile(downloadReq);
    })
    .then(fileBuffer => {
        const localFile = path.resolve(__dirname, "sample.png");
        fs.writeFileSync(localFile, fileBuffer);
        console.log("PNG downloaded to:", localFile);
    })
    .catch(err => {
        console.error("Error during SVG → PNG conversion:", err);
    })
    .finally(() => {
        // Clean up HTTP client resources if the SDK exposes a close method
        if (config && config.httpClient && typeof config.httpClient.close === "function") {
            config.httpClient.close();
        }
    });

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input/sample.svg, output/sample.png, ecc.) in modo che corrispondano alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se riscontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Conversione da SVG a PNG tramite API REST usando cURL

Se preferisci un approccio REST puro, la stessa conversione può essere eseguita con comandi cURL. I passaggi seguenti mostrano come ottenere un token di accesso, caricare l’SVG, avviare la conversione e scaricare il PNG.

Autenticare e Ottenere il Token di Accesso

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

La risposta contiene un access_token che utilizzerai nelle chiamate successive.

Carica il file SVG di origine

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input/sample.svg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/local/sample.svg"

Esegui la conversione da SVG a PNG

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "input/sample.svg",
           "format": "png",
           "outputPath": "output/sample.png",
           "options": {
               "width": 1024,
               "height": 768,
               "backgroundColor": "#FFFFFF"
           }
         }'

L’API restituisce il percorso del nuovo file PNG creato nello storage cloud.

Scarica il file PNG risultante

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

Questi comandi cURL ti danno il pieno controllo sul processo di conversione senza scrivere alcun codice. Per ulteriori dettagli, consulta la documentazione ufficiale dell’API.

Come funziona la conversione da SVG a PNG in Node.JS

1. Importa le classi SDK - L’istruzione require("@groupdocs/conversion-cloud") carica le classi essenziali come ConvertApi, ConvertSettings e PngOptions (riferimento API).

   const { ConvertApi, ConvertSettings, PngOptions } = require("@groupdocs/conversion-cloud");
   

2. Configura l’autenticazione - Un oggetto Configuration contiene il tuo clientId e clientSecret. Questo oggetto viene passato sia a ConvertApi sia a StorageApi per autorizzare tutte le chiamate successive.

   const config = new Configuration({ clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET" });
   

3. Definisci i percorsi di input e output - inputSvgPath indica l’SVG nello storage cloud, mentre outputPngPath specifica dove deve essere salvato il PNG.

const inputSvgPath = "input/sample.svg";
const outputPngPath = "output/sample.png";

4. Imposta le opzioni PNG - PngOptions ti consente di controllare le dimensioni e il colore di sfondo, utile per SVG di grandi dimensioni o trasparenti.

   const pngOptions = new PngOptions({ width: 1024, height: 768, backgroundColor: "#FFFFFF" });
   

5. Crea le impostazioni di conversione ed esegui - ConvertSettings raggruppa il percorso del file, il formato di destinazione, la posizione di output e le opzioni. Il metodo convertDocument esegue la conversione e il risultato contiene il percorso cloud del PNG.

   const convertSettings = new ConvertSettings({ filePath: inputSvgPath, format: "png", outputPath: outputPngPath, options: pngOptions });
   const convertRequest = new ConvertDocumentRequest(convertSettings);
   convertApi.convertDocument(convertRequest);
   

6. Scarica il PNG - Dopo la conversione, StorageApi.downloadFile recupera i dati binari, che è possibile scrivere sul file system locale.

Comprendere ogni passaggio ti aiuta a personalizzare il processo, gestire gli errori e integrare la conversione in flussi di lavoro più ampi.

Installazione e configurazione GroupDocs.Conversion Cloud SDK for Node.JS

npm install groupdocs-conversion-cloud

Il SDK richiede Node.js 12 o versioni successive. Dopo l’installazione, crea un oggetto di configurazione con il tuo clientId e clientSecret (disponibili dal tuo account GroupDocs Cloud). Consulta la pagina di download per la versione più recente del pacchetto.

const { Configuration } = require("@groupdocs/conversion-cloud");
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

Assicurati che le credenziali abbiano l’autorizzazione per accedere ai servizi di archiviazione e conversione. Una volta configurato, puoi istanziare ConvertApi e StorageApi come mostrato nell’esempio di codice.

Regolazione fine delle impostazioni di conversione PNG

La classe PngOptions offre diverse proprietà che è possibile regolare:

• width / height - Definisci la risoluzione di output. Valori più grandi aumentano la qualità ma consumano più memoria.

  const pngOptions = new PngOptions({ width: 1920, height: 1080 });
  

• backgroundColor - Imposta uno sfondo solido per gli SVG che contengono trasparenza.

  const pngOptions = new PngOptions({ backgroundColor: "#000000" });
  

• compressionLevel - (Se supportato) Scegli un livello di compressione compreso tra 0 (nessuna compressione) e 9 (compressione massima) per ridurre le dimensioni del file.

  const pngOptions = new PngOptions({ compressionLevel: 6 });
  

Queste opzioni vengono passate tramite la proprietà options di ConvertSettings. Consulta il riferimento API per l’elenco completo delle impostazioni disponibili.

Best Practices per una conversione efficiente da SVG a PNG

• Convalida il contenuto SVG - Assicurati che l’SVG non contenga script esterni o payload dannosi prima del caricamento. GroupDocs.Conversion sanitizza l’input, ma la pre‑validazione aggiunge un ulteriore livello di sicurezza.
• Riutilizza l’oggetto Configuration - Crea un’unica istanza di Configuration e condividila tra più chiamate ConvertApi per ridurre l’overhead.
• Imposta dimensioni ragionevoli - Limita larghezza e altezza alle dimensioni realmente necessarie. Le immagini sovradimensionate aumentano i tempi di elaborazione e l’uso della memoria.
• Esegui lo streaming di file di grandi dimensioni - Per SVG molto grandi, considera lo streaming del download invece di caricare l’intero buffer in memoria.
• Monitora l’uso dell’API - Tieni sotto controllo la tua quota di conversione e gestisci le risposte di limitazione della velocità in modo appropriato.

Conclusione

GroupDocs.Conversion Cloud SDK for Node.JS rende la conversione server‑side da SVG a PNG semplice, scalabile e sicura. Seguendo l’esempio di codice completo, il flusso di lavoro cURL equivalente e i suggerimenti di configurazione sopra indicati, è possibile integrare la conversione di immagini ad alte prestazioni in qualsiasi servizio backend. Ricorda di esaminare le opzioni di licenza; le distribuzioni in produzione richiedono un abbonamento a pagamento, e puoi ottenere una licenza temporanea per i test dalla pagina della licenza temporanea. Inizia a convertire oggi stesso e fornisci asset PNG nitidi ai tuoi utenti con fiducia.

FAQs

Come eseguire la conversione da SVG a PNG in Node.JS utilizzando GroupDocs?
Utilizza il GroupDocs.Conversion Cloud SDK per Node.JS. Carica l’SVG nell’archiviazione cloud, configura PngOptions, chiama convertDocument e scarica il PNG. L’esempio di codice completo in questo articolo mostra ogni passaggio.

Posso convertire in batch molti file SVG contemporaneamente?
Sì. Itera su un elenco di percorsi SVG e invoca la stessa richiesta di conversione per ogni file. L’SDK elabora ogni richiesta in modo indipendente, consentendoti di salvare tutti i risultati PNG in una singola cartella di output.

Cosa devo fare se la conversione fallisce con un errore?
Controlla il messaggio di errore restituito nel blocco catch. I problemi comuni includono credenziali non valide, percorsi file mancanti o funzionalità SVG non supportate. Consulta la documentazione ufficiale per i codici di errore dettagliati e le procedure di risoluzione.

Dove posso trovare ulteriori informazioni sulle opzioni PNG?
Tutte le proprietà configurabili sono elencate nella documentazione API per PngOptions. Visita la documentazione API per esplorare impostazioni aggiuntive come il livello di compressione e la profondità di colore.

Leggi di più

• Tutorial passo-passo per la conversione da HTML a DOCX in Node.JS
• Esempio passo-passo di conversione da CSV a PDF in Node.JS
• Conversione da PDF a DOCX in Node.JS