Contoh Kerja Lengkap untuk Konversi SVG ke PNG di Node.JS

Contoh ini menunjukkan cara mengonversi file SVG yang disimpan di GroupDocs Cloud storage menjadi gambar PNG menggunakan GroupDocs.Conversion Cloud SDK for 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();
        }
    });

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input/sample.svg, output/sample.png, dll.) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan lakukan pengujian menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Konversi SVG ke PNG via REST API Menggunakan cURL

Jika Anda lebih memilih pendekatan REST murni, konversi yang sama dapat dilakukan dengan perintah cURL. Langkah‑langkah di bawah ini menunjukkan cara mendapatkan token akses, mengunggah SVG, memulai konversi, dan mengunduh PNG.

Autentikasi dan Dapatkan Token Akses

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

Respons berisi access_token yang akan Anda gunakan dalam panggilan berikutnya.

Unggah File SVG Sumber

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"

Jalankan Konversi SVG ke 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"
           }
         }'

API mengembalikan path file PNG yang baru dibuat di penyimpanan cloud.

Unduh File PNG yang Dihasilkan

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

Perintah cURL ini memberi Anda kontrol penuh atas proses konversi tanpa menulis kode apa pun. Untuk detail lebih lanjut, lihat dokumentasi API resmi.

Cara Kerja Konversi SVG ke PNG di Node.JS

1. Import SDK Classes - Pernyataan require("@groupdocs/conversion-cloud") memuat kelas penting seperti ConvertApi, ConvertSettings, dan PngOptions (referensi API).

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

2. Konfigurasi Autentikasi - Sebuah objek Configuration menyimpan clientId dan clientSecret Anda. Objek ini diteruskan ke ConvertApi dan StorageApi untuk mengotorisasi semua panggilan berikutnya.

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

3. Tentukan Jalur Input dan Output - inputSvgPath mengacu pada SVG di penyimpanan cloud, sementara outputPngPath menentukan di mana PNG harus disimpan.

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

4. Set PNG Options - PngOptions memungkinkan Anda mengontrol dimensi dan warna latar belakang, yang berguna untuk SVG besar atau transparan.

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

5. Buat Pengaturan Konversi dan Jalankan - ConvertSettings menggabungkan jalur file, format target, lokasi output, dan opsi. Metode convertDocument melakukan konversi, dan hasilnya berisi jalur cloud dari PNG.

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

6. Unduh PNG - Setelah konversi, StorageApi.downloadFile mengambil data biner, yang dapat Anda tulis ke sistem file lokal.

Memahami setiap langkah membantu Anda menyesuaikan proses, menangani kesalahan, dan mengintegrasikan konversi ke dalam alur kerja yang lebih besar.

Menginstal dan Mengonfigurasi GroupDocs.Conversion Cloud SDK for Node.JS

npm install groupdocs-conversion-cloud

SDK memerlukan Node.js 12 atau yang lebih baru. Setelah menginstal, buat objek konfigurasi dengan clientId dan clientSecret Anda (tersedia dari akun GroupDocs Cloud Anda). Lihat halaman unduhan untuk versi paket terbaru.

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

Pastikan kredensial memiliki izin untuk mengakses layanan penyimpanan dan konversi. Setelah dikonfigurasi, Anda dapat membuat instance ConvertApi dan StorageApi seperti yang ditunjukkan dalam contoh kode.

Penyetingan Halus Pengaturan Konversi PNG

Kelas PngOptions menawarkan beberapa properti yang dapat Anda sesuaikan:

• width / height - Definisikan resolusi output. Nilai yang lebih besar meningkatkan kualitas tetapi mengonsumsi lebih banyak memori.

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

• backgroundColor - Tetapkan latar belakang solid untuk SVG yang mengandung transparansi.

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

• compressionLevel - (Jika didukung) Pilih tingkat kompresi antara 0 (tanpa kompresi) dan 9 (kompresi maksimum) untuk mengurangi ukuran file.

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

Opsi-opsi ini diteruskan melalui properti options dari ConvertSettings. Lihat referensi API untuk daftar lengkap pengaturan yang tersedia.

Praktik Terbaik untuk Konversi SVG ke PNG yang Efisien

• Validasi Konten SVG - Pastikan SVG tidak mengandung skrip eksternal atau payload berbahaya sebelum diunggah. GroupDocs.Conversion membersihkan input, tetapi pra‑validasi menambahkan lapisan keamanan ekstra.
• Gunakan Kembali Objek Konfigurasi - Buat satu instance Configuration dan bagikan ke beberapa panggilan ConvertApi untuk mengurangi beban.
• Tetapkan Dimensi yang Masuk Akal - Batasi lebar dan tinggi ke ukuran yang memang Anda butuhkan. Gambar yang terlalu besar meningkatkan waktu pemrosesan dan penggunaan memori.
• Streaming File Besar - Untuk SVG yang sangat besar, pertimbangkan streaming unduhan alih‑alih memuat seluruh buffer ke memori.
• Pantau Penggunaan API - Awasi kuota konversi Anda dan tangani respons pembatasan laju (rate‑limit) dengan baik.

Kesimpulan

GroupDocs.Conversion Cloud SDK for Node.JS membuat konversi SVG ke PNG di sisi server menjadi sederhana, skalabel, dan aman. Dengan mengikuti contoh kode lengkap, alur kerja cURL yang setara, dan tip konfigurasi di atas, Anda dapat mengintegrasikan konversi gambar berkinerja tinggi ke dalam layanan backend apa pun. Ingatlah untuk meninjau opsi lisensi; penyebaran produksi memerlukan langganan berbayar, dan Anda dapat memperoleh lisensi sementara untuk pengujian dari halaman lisensi sementara. Mulailah mengonversi hari ini dan berikan aset PNG yang tajam kepada pengguna Anda dengan keyakinan.

FAQs

Bagaimana cara melakukan konversi SVG ke PNG di Node.JS menggunakan GroupDocs?
Gunakan GroupDocs.Conversion Cloud SDK for Node.JS. Unggah SVG ke penyimpanan cloud, konfigurasikan PngOptions, panggil convertDocument, dan unduh PNG. Contoh kode lengkap dalam artikel ini menunjukkan setiap langkah.

Bisakah saya mengonversi banyak file SVG sekaligus?
Ya. Iterasikan daftar jalur SVG dan panggil permintaan konversi yang sama untuk setiap file. SDK memproses setiap permintaan secara independen, memungkinkan Anda menyimpan semua hasil PNG dalam satu folder output.

Apa yang harus saya lakukan jika konversi gagal dengan error?
Periksa pesan error yang dikembalikan di dalam blok catch. Masalah umum meliputi kredensial tidak valid, jalur file yang hilang, atau fitur SVG yang tidak didukung. Konsultasikan dokumentasi resmi untuk kode error terperinci dan langkah-langkah pemecahan masalah.

Di mana saya dapat menemukan informasi lebih lanjut tentang opsi PNG?
Semua properti yang dapat dikonfigurasi tercantum dalam referensi API untuk PngOptions. Kunjungi referensi API untuk menjelajahi pengaturan tambahan seperti tingkat kompresi dan kedalaman warna.

Baca Selengkapnya

• Tutorial Konversi HTML ke DOCX Langkah-demi-Langkah di Node.JS
• Contoh Konversi CSV ke PDF Langkah-demi-Langkah di Node.JS
• Konversi PDF ke DOCX di Node.JS

Mengonversi CSV ke JPG di Node.JS - Contoh Kode Lengkap

Contoh ini menunjukkan cara mengonversi file CSV yang disimpan di penyimpanan GroupDocs Cloud menjadi gambar JPG menggunakan API async perpustakaan.

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

// Replace with your actual GroupDocs Cloud credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

async function convertCsvToJpg() {
    // Initialize the Conversion API
    const convertApi = new ConvertApi(clientId, clientSecret);

// Source CSV file stored in GroupDocs Cloud storage
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.csv";

// Conversion options: CSV -> JPG
    const convertOptions = new ConvertOptions();
    convertOptions.fileInfo = fileInfo;
    convertOptions.format = "jpg";

// Conversion settings (output folder in storage)
    const convertSettings = new ConvertSettings();
    convertSettings.outputPath = "output_images";
    convertSettings.convertOptions = [convertOptions];

try {
        const result = await convertApi.convertDocument(convertSettings);
        console.log("Conversion completed. Generated files:");
        result.forEach(file => console.log(file.path));
    } catch (err) {
        console.error("Conversion failed:", err);
    }
}

convertCsvToJpg();

Catatan: Contoh kode ini menunjukkan fungsionalitas inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.csv, output_images, dll.) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Konversi CSV ke JPG Menggunakan cURL dan REST API

Jika Anda lebih suka pendekatan REST murni, konversi yang sama dapat dilakukan dengan serangkaian perintah cURL.

1. Dapatkan token akses - otentikasi dengan kredensial klien Anda.

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

2. Unggah CSV sumber - letakkan file di penyimpanan GroupDocs Cloud Anda.

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

3. Minta konversi - tentukan format target sebagai JPG.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo":{"filePath":"input.csv"}}'

4. Unduh gambar yang dihasilkan - ambil file dari folder output.

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

Perintah‑perintah ini menggambarkan alur kerja CSV‑to‑JPG lengkap tanpa menulis kode apa pun. Untuk detail lebih lanjut, lihat dokumentasi API resmi.

Memahami Proses CSV ke JPG di Node.JS

Berikut adalah penjelasan langkah demi langkah dari kode yang ditampilkan sebelumnya:

1. Inisialisasi klien API - new ConvertApi(clientId, clientSecret) membuat sesi terautentikasi.

const convertApi = new ConvertApi(clientId, clientSecret);

2. Tentukan file sumber - sebuah objek FileInfo menunjuk ke input.csv yang disimpan di GroupDocs Cloud.

const fileInfo = new FileInfo();
fileInfo.filePath = "input.csv";

3. Atur opsi konversi - ConvertOptions.format = "jpg" memberi tahu layanan untuk menghasilkan output JPG.

   const convertOptions = new ConvertOptions();
   convertOptions.fileInfo = fileInfo;
   convertOptions.format = "jpg";
   

4. Konfigurasikan pengaturan output - ConvertSettings.outputPath menentukan di mana gambar akan disimpan.

   const convertSettings = new ConvertSettings();
   convertSettings.outputPath = "output_images";
   convertSettings.convertOptions = [convertOptions];
   

5. Jalankan konversi - convertApi.convertDocument(convertSettings) mengirim permintaan dan mengembalikan array jalur file yang dihasilkan.

const result = await convertApi.convertDocument(convertSettings);

Untuk daftar lengkap kelas dan properti, lihat referensi API.

Prasyarat dan Penyiapan

1. Node.js runtime - versi 12 atau lebih tinggi diperlukan.
2. GroupDocs Cloud account - dapatkan clientId dan clientSecret dari portal GroupDocs.
3. Install the SDK - jalankan perintah berikut (unduh paket dari halaman rilis resmi):

npm install groupdocs-conversion-cloud

4. Impor SDK dalam proyek Anda:

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

Untuk detail lebih lanjut tentang instalasi, lihat halaman unduhan.

Pengaturan Konversi: Opsi dan Parameter

SDK menyediakan beberapa properti yang dapat Anda sesuaikan:

• Jalur Output - mengontrol folder tempat file JPG disimpan.

convertSettings.outputPath = "output_images";

• Format Target - ubah "jpg" menjadi "jpeg" jika Anda memerlukan varian JPEG.

convertOptions.format = "jpeg";

• Dimensi Kustom - Anda dapat menentukan lebar dan tinggi (jika didukung) untuk menghasilkan gambar dengan ukuran tepat.

  convertOptions.width = 800;   // example width in pixels
  convertOptions.height = 600;  // example height in pixels

• Eksekusi Asinkron - metode SDK mengembalikan promise, memungkinkan Anda mengintegrasikan konversi ke dalam alur kerja async tanpa memblokir event loop.

await convertApi.convertDocument(convertSettings);

Opsi-opsi ini memungkinkan Anda menyesuaikan alur kerja CSV‑to‑JPG agar sesuai dengan kebutuhan otomatisasi atau integrasi spesifik Anda.

Kesimpulan

Mengonversi CSV ke JPG di Node.JS sangat mudah dengan GroupDocs.Conversion Cloud SDK for Node.js. Perpustakaan menangani beban kerja berat di cloud, memungkinkan Anda fokus pada logika bisnis dan integrasi. Ingatlah untuk mengamankan kredensial Cloud Anda, pilih format output yang sesuai (JPG atau JPEG), dan sesuaikan pengaturan seperti dimensi atau jalur output agar cocok dengan alur kerja Anda. Untuk penyebaran produksi Anda memerlukan lisensi berbayar; Anda dapat menjelajahi detail harga dan memperoleh lisensi sementara dari halaman lisensi sementara. Dengan kode dan contoh cURL yang disediakan, Anda siap menambahkan otomatisasi CSV‑to‑JPG ke layanan backend mana pun.

FAQs

• Bagaimana cara mengonversi CSV ke JPG di Node.JS tanpa menulis logika parsing khusus?
  SDK membaca CSV langsung dari penyimpanan GroupDocs Cloud dan merender setiap baris sebagai gambar, jadi Anda tidak memerlukan alat eksternal apa pun. Cukup ikuti contoh kode atau alur kerja cURL.

• Apakah memungkinkan mengonversi CSV ke JPEG alih-alih JPG di backend?
  Ya. Setel convertOptions.format = "jpeg" dalam kode atau gunakan format=jpeg dalam permintaan REST. Kedua format didukung untuk konversi backend di Node.JS.

• Apakah saya dapat menjalankan konversi secara asynchronous untuk menghindari pemblokiran server saya?
  Tentu saja. Semua metode SDK mengembalikan promises, sehingga Anda dapat await mereka atau melampirkan handler .then(). Ini memungkinkan otomatisasi CSV‑to‑JPG yang tidak memblokir, skalabel.

• Di mana saya dapat menemukan contoh lebih banyak tentang konversi CSV ke gambar?
  Dokumentasi resmi documentation berisi contoh tambahan, dan forum komunitas di GroupDocs Conversion Forum adalah tempat yang baik untuk mengajukan pertanyaan.

Baca Selengkapnya

• Konversi PDF ke JPG menggunakan Node.js | Ekstrak Gambar dari PDF
• Konversi CSV ke JSON di Node.js | CSV ke JSON Online menggunakan REST API
• Konversi JSON ke CSV Menggunakan Node.js REST API | Transformasi JSON ke Format CSV Online