Vollständiges funktionierendes Beispiel für die SVG-zu-PNG-Konvertierung in Node.JS

Dieses Beispiel demonstriert, wie man eine in GroupDocs Cloud storage gespeicherte SVG-Datei mit dem GroupDocs.Conversion Cloud SDK for Node.JS in ein PNG-Bild konvertiert.

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

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input/sample.svg, output/sample.png usw.) an Ihre tatsächlichen Dateistandorte anpassen, dass alle erforderlichen Abhängigkeiten korrekt installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

SVG zu PNG-Konvertierung über REST-API mit cURL

Wenn Sie einen reinen REST‑Ansatz bevorzugen, kann dieselbe Konvertierung mit cURL‑Befehlen durchgeführt werden. Die nachstehenden Schritte zeigen, wie Sie ein Zugriffstoken erhalten, die SVG hochladen, die Konvertierung starten und das PNG herunterladen.

Authentifizieren und Zugriffstoken erhalten

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"
         }'

Die Antwort enthält ein access_token, das Sie in nachfolgenden Aufrufen verwenden.

Laden Sie die Quell‑SVG‑Datei hoch

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"

Führen Sie die SVG-zu-PNG-Konvertierung aus

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"
           }
         }'

Die API gibt den Pfad der neu erstellten PNG‑Datei im Cloud‑Speicher zurück.

Download der resultierenden PNG-Datei

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

Diese cURL-Befehle geben Ihnen die vollständige Kontrolle über den Konvertierungsprozess, ohne Code schreiben zu müssen. Weitere Details finden Sie in der offiziellen API-Dokumentation.

Wie die SVG-zu-PNG-Konvertierung in Node.JS funktioniert

1. SDK-Klassen importieren – Die require("@groupdocs/conversion-cloud")‑Anweisung lädt wesentliche Klassen wie ConvertApi, ConvertSettings und PngOptions (API‑Referenz).

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

2. Authentifizierung konfigurieren - Ein Configuration-Objekt enthält Ihre clientId und clientSecret. Dieses Objekt wird sowohl an ConvertApi als auch an StorageApi übergeben, um alle nachfolgenden Aufrufe zu autorisieren.

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

3. Eingabe- und Ausgabepfade definieren - inputSvgPath verweist auf die SVG im Cloud‑Speicher, während outputPngPath angibt, wo die PNG gespeichert werden soll.

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

4. PNG-Optionen festlegen - PngOptions ermöglicht die Steuerung von Abmessungen und Hintergrundfarbe, was bei großen oder transparenten SVGs nützlich ist.

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

5. Erstelle Konvertierungseinstellungen und führe sie aus – ConvertSettings bündelt den Dateipfad, das Zielformat, den Ausgabepfad und Optionen. Die convertDocument‑Methode führt die Konvertierung aus, und das Ergebnis enthält den Cloud‑Pfad der PNG.

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

6. PNG herunterladen - Nach der Konvertierung ruft StorageApi.downloadFile die Binärdaten ab, die Sie in das lokale Dateisystem schreiben können.

Das Verständnis jedes Schrittes hilft Ihnen, den Prozess anzupassen, Fehler zu behandeln und die Konvertierung in größere Workflows zu integrieren.

Installation und Konfiguration GroupDocs.Conversion Cloud SDK für Node.JS

npm install groupdocs-conversion-cloud

Das SDK erfordert Node.js 12 oder höher. Nach der Installation erstellen Sie ein Konfigurationsobjekt mit Ihrem clientId und clientSecret (verfügbar in Ihrem GroupDocs Cloud‑Konto). Siehe die Download‑Seite für die neueste Paketversion.

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

Stellen Sie sicher, dass die Anmeldeinformationen die Berechtigung zum Zugriff auf Speicher‑ und Konvertierungsdienste haben. Sobald sie konfiguriert sind, können Sie ConvertApi und StorageApi wie im Codebeispiel instanziieren.

Feinabstimmung der PNG-Konvertierungseinstellungen

Die PngOptions-Klasse bietet mehrere Eigenschaften, die Sie anpassen können:

• width / height – Definieren Sie die Ausgaberesolution. Größere Werte erhöhen die Qualität, verbrauchen jedoch mehr Speicher.

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

• backgroundColor – Legen Sie einen einfarbigen Hintergrund für SVGs fest, die Transparenz enthalten.

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

• compressionLevel – (Falls unterstützt) Wählen Sie einen Komprimierungsgrad zwischen 0 (keine Kompression) und 9 (maximale Kompression), um die Dateigröße zu reduzieren.

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

Diese Optionen werden über die options‑Eigenschaft von ConvertSettings übergeben. Weitere Informationen finden Sie in der API‑Referenz für die vollständige Liste der verfügbaren Einstellungen.

Bewährte Methoden für eine effiziente SVG-zu-PNG-Konvertierung

• SVG-Inhalt validieren – Stellen Sie sicher, dass das SVG vor dem Hochladen keine externen Skripte oder bösartigen Payloads enthält. GroupDocs.Conversion bereinigt die Eingabe, aber eine Vorvalidierung fügt eine zusätzliche Sicherheitsebene hinzu.
• Konfigurationsobjekt wiederverwenden – Erstellen Sie eine einzelne Configuration‑Instanz und teilen Sie sie über mehrere ConvertApi‑Aufrufe, um den Aufwand zu reduzieren.
• Angemessene Abmessungen festlegen – Begrenzen Sie Breite und Höhe auf die tatsächlich benötigte Größe. Zu große Bilder erhöhen die Verarbeitungszeit und den Speicherverbrauch.
• Große Dateien streamen – Bei sehr großen SVGs sollten Sie das Herunterladen streamen, anstatt den gesamten Puffer in den Speicher zu laden.
• API‑Nutzung überwachen – Behalten Sie Ihr Konversionskontingent im Auge und gehen Sie rate‑limit‑Antworten elegant um.

Fazit

GroupDocs.Conversion Cloud SDK for Node.JS macht die serverseitige SVG‑zu‑PNG-Konvertierung einfach, skalierbar und sicher. Wenn Sie dem vollständigen Codebeispiel, dem entsprechenden cURL‑Workflow und den oben genannten Konfigurationstipps folgen, können Sie eine Hochleistungs‑Bildkonvertierung in jeden Backend‑Dienst integrieren. Denken Sie daran, die Lizenzierungsoptionen zu prüfen – Produktionsbereitstellungen erfordern ein kostenpflichtiges Abonnement, und Sie können eine temporäre Lizenz für Tests von der temporäre Lizenzseite erhalten. Beginnen Sie noch heute mit der Konvertierung und liefern Sie Ihren Benutzern gestochen scharfe PNG‑Assets mit Vertrauen.

FAQs

Wie führe ich eine SVG-zu-PNG-Konvertierung in Node.JS mit GroupDocs durch?
Verwenden Sie das GroupDocs.Conversion Cloud SDK für Node.JS. Laden Sie die SVG in den Cloud‑Speicher hoch, konfigurieren Sie PngOptions, rufen Sie convertDocument auf und laden Sie das PNG herunter. Das vollständige Codebeispiel in diesem Artikel zeigt jeden Schritt.

Kann ich viele SVG-Dateien gleichzeitig stapelweise konvertieren?
Ja. Durchlaufen Sie eine Liste von SVG-Pfaden und rufen Sie für jede Datei dieselbe Konvertierungsanforderung auf. Das SDK verarbeitet jede Anforderung unabhängig, sodass Sie alle PNG-Ergebnisse in einem einzigen Ausgabeverzeichnis speichern können.

Was soll ich tun, wenn die Konvertierung mit einem Fehler fehlschlägt?
Überprüfen Sie die im Catch-Block zurückgegebene Fehlermeldung. Häufige Probleme sind ungültige Anmeldeinformationen, fehlende Dateipfade oder nicht unterstützte SVG‑Funktionen. Konsultieren Sie die offizielle Dokumentation für detaillierte Fehlercodes und Schritte zur Fehlerbehebung.

Wo finde ich weitere Informationen zu PNG-Optionen?
Alle konfigurierbaren Eigenschaften sind in der API-Referenz für PngOptions aufgeführt. Besuchen Sie die API-Referenz, um weitere Einstellungen wie Komprimierungsgrad und Farbtiefe zu erkunden.

Mehr lesen

• Schritt-für-Schritt HTML-zu-DOCX-Konvertierungstutorial in Node.JS
• Schritt-für-Schritt CSV-zu-PDF-Konvertierungsbeispiel in Node.JS
• PDF-zu-DOCX-Konvertierung in Node.JS