Konversi PDF ke DOCX di Node.JS

Mon, 03 Aug 2026 10:51:03 +0000

Mengonversi file PDF ke format DOCX adalah kebutuhan yang sering muncul saat membangun aplikasi yang berfokus pada dokumen, terutama ketika Anda memerlukan output Word yang dapat diedit. GroupDocs.Conversion Cloud SDK for Node.js menyediakan API yang kuat yang membuat tugas ini menjadi sederhana dan dapat diskalakan. Dalam panduan ini Anda akan melihat contoh kode asinkron lengkap, mempelajari cara mencapai hasil yang sama dengan panggilan REST cURL, menyiapkan SDK, dan menerapkan rekomendasi praktik terbaik untuk konversi yang handal.

Contoh Kode Lengkap: Konversi PDF ke DOCX Asinkron di Node.JS

Contoh ini menunjukkan cara melakukan konversi PDF ke DOCX secara asynchronous menggunakan GroupDocs.Conversion Cloud SDK for Node.js.

// PDF to DOCX conversion using GroupDocs.Conversion Cloud SDK for Node.js

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const path = require('path');

// -------------------- Configuration --------------------
const CLIENT_ID = process.env.GROUPDOCS_CLIENT_ID || 'YOUR_CLIENT_ID';
const CLIENT_SECRET = process.env.GROUPDOCS_CLIENT_SECRET || 'YOUR_CLIENT_SECRET';

// Initialize API client
const apiInstance = new GroupDocsConversionCloud.ConversionApi();
apiInstance.apiClient = new GroupDocsConversionCloud.ApiClient();
apiInstance.apiClient.basePath = 'https://api.groupdocs.cloud';
apiInstance.apiClient.authentications['JWT'].clientId = CLIENT_ID;
apiInstance.apiClient.authentications['JWT'].clientSecret = CLIENT_SECRET;

// -------------------- Conversion Logic --------------------
async function convertPdfToDocx() {
    try {
        // Input file information (must already be uploaded to GroupDocs Cloud storage)
        const inputFileInfo = new GroupDocsConversionCloud.FileInfo();
        inputFileInfo.filePath = path.normalize('input.pdf'); // generic path in cloud storage

// DOCX specific conversion options (optional, shown for demonstration)
        const docxOptions = new GroupDocsConversionCloud.DocxConvertOptions();
        docxOptions.preserveOriginalFormatting = true; // keep original PDF layout as much as possible
        docxOptions.password = null; // if PDF is password protected, set it here

// Build conversion request
        const convertRequest = new GroupDocsConversionCloud.ConvertDocumentRequest();
        convertRequest.format = 'docx';
        convertRequest.fileInfo = inputFileInfo;
        convertRequest.outputPath = path.normalize('output.docx'); // result will be stored in cloud storage
        convertRequest.options = docxOptions; // attach format‑specific options

// Perform conversion (async)
        const conversionResult = await apiInstance.convertDocument(convertRequest);

// conversionResult contains the path of the generated file and other metadata
        console.log('Conversion succeeded.');
        console.log('Output file path:', conversionResult.path);
        console.log('File size (bytes):', conversionResult.size);
    } catch (error) {
        // Detailed error handling
        if (error.response && error.response.body) {
            console.error('API error:', error.response.body);
        } else {
            console.error('Unexpected error:', error.message);
        }
    }
}

// -------------------- Execution --------------------
(async () => {
    // Optional: set a timeout to avoid hanging indefinitely
    const timeoutMs = 300000; // 5 minutes
    const timeout = setTimeout(() => {
        console.error('Conversion timed out after', timeoutMs / 1000, 'seconds');
        process.exit(1);
    }, timeoutMs);

await convertPdfToDocx();

clearTimeout(timeout);
    // Graceful shutdown
    process.exit(0);
})();

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

Konversi Dokumen Menggunakan cURL dan REST API

Anda dapat melakukan konversi PDF ke DOCX yang sama tanpa menulis kode dengan memanggil endpoint REST GroupDocs.Conversion Cloud secara langsung. Langkah-langkah di bawah ini menunjukkan cara mendapatkan token akses, mengunggah PDF, memulai konversi, dan mengunduh file DOCX yang dihasilkan.

Otentikasi dan dapatkan token akses
Ganti YOUR_CLIENT_ID dan YOUR_CLIENT_SECRET dengan kredensial Anda.

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

Respons berisi access_token yang akan Anda gunakan dalam panggilan berikutnya.

Unggah PDF sumber

curl -X PUT "https://api.groupdocs.cloud/v1.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @./local/input.pdf

Jalankan konversi

curl -X POST "https://api.groupdocs.cloud/v1.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "format":"docx",
           "fileInfo":{"filePath":"input.pdf"},
           "outputPath":"output.docx",
           "options":{"preserveOriginalFormatting":true}
         }'

Respons mengembalikan jalur file DOCX yang dihasilkan.

Unduh DOCX yang telah dikonversi

curl -X GET "https://api.groupdocs.cloud/v1.0/storage/file/output.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o ./local/output.docx

Untuk detail lebih lanjut tentang payload permintaan dan opsi tambahan, lihat dokumentasi API resmi.

Membongkar Konversi PDF ke DOCX di Node.JS

Berikut adalah penjelasan singkat tentang bagian-bagian utama dari contoh kode asynchronous.

Impor dan konfigurasikan klien

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const apiInstance = new GroupDocsConversionCloud.ConversionApi();

Kelas ConversionApi (referensi API) adalah titik masuk untuk semua operasi konversi.

Atur kredensial otentikasi

apiInstance.apiClient.authentications['JWT'].clientId = CLIENT_ID;
apiInstance.apiClient.authentications['JWT'].clientSecret = CLIENT_SECRET;

Otentikasi JWT mengamankan setiap permintaan ke layanan cloud.

Siapkan informasi file input

const inputFileInfo = new GroupDocsConversionCloud.FileInfo();
inputFileInfo.filePath = path.normalize('input.pdf');

FileInfo memberi tahu API di mana PDF sumber berada di penyimpanan GroupDocs Cloud.

Konfigurasikan opsi khusus DOCX

const docxOptions = new GroupDocsConversionCloud.DocxConvertOptions();
docxOptions.preserveOriginalFormatting = true;

DocxConvertOptions memungkinkan Anda mempertahankan tata letak asli dan menangani kata sandi jika diperlukan.

Buat dan kirim permintaan konversi

const convertRequest = new GroupDocsConversionCloud.ConvertDocumentRequest();
convertRequest.format = 'docx';
convertRequest.fileInfo = inputFileInfo;
convertRequest.outputPath = path.normalize('output.docx');
convertRequest.options = docxOptions;
const conversionResult = await apiInstance.convertDocument(convertRequest);

Metode convertDocument melakukan konversi sebenarnya dan mengembalikan metadata seperti jalur output dan ukuran file.

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

Instal paket

npm install groupdocs-conversion-cloud

Paket tersedia dari registri npm publik. Lihat halaman unduhan untuk detail versi.

Prasyarat
- Node.js 12 atau lebih tinggi.
- Akun GroupDocs Cloud dengan client ID dan client secret.
Inisialisasi SDK di proyek Anda (kutipan dari contoh lengkap)

const GroupDocsConversionCloud = require('groupdocs-conversion-cloud');
const apiInstance = new GroupDocsConversionCloud.ConversionApi();
apiInstance.apiClient.basePath = 'https://api.groupdocs.cloud';

Sesuaikan basePath jika Anda menggunakan endpoint regional.

Praktik Terbaik untuk Konversi Dokumen Berkinerja Tinggi

Gunakan kembali klien API alih-alih membuat instance baru untuk setiap konversi; ini mengurangi beban otentikasi.
Aktifkan unggahan streaming untuk PDF besar agar tidak harus memuat seluruh file ke memori.
Tetapkan batas waktu yang wajar (mis., 5 menit) untuk mencegah pekerjaan menggantung sekaligus tetap memungkinkan dokumen kompleks selesai diproses.
Pertahankan format asli hanya bila diperlukan; menonaktifkannya dapat mempercepat konversi untuk PDF yang hanya berisi teks.
Pantau batas penggunaan API di dasbor akun GroupDocs Anda untuk menghindari throttling selama operasi batch.

Kesimpulan

GroupDocs.Conversion Cloud SDK for Node.js memudahkan konversi PDF ke DOCX, baik Anda lebih suka perpustakaan lengkap atau panggilan REST langsung dengan cURL. Dengan mengikuti contoh kode async, mengonfigurasi klien dengan benar, dan menerapkan tips kinerja di atas, Anda dapat mengintegrasikan konversi dokumen yang andal ke dalam layanan Node.JS apa pun. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; detail harga tersedia di halaman produk, dan lisensi sementara dapat diperoleh dari halaman lisensi sementara untuk evaluasi.

FAQs

Bagaimana konversi PDF ke DOCX di Node.JS menangani tata letak yang kompleks?
SDK berusaha mempertahankan format asli secara default. Anda dapat mengaktifkan/mematikan preserveOriginalFormatting dalam DocxConvertOptions untuk menukar ketelitian dengan kecepatan. Lihat referensi API untuk semua opsi.
Apa batas ukuran file untuk konversi PDF ke DOCX?
Layanan cloud menerima file hingga 200 MB untuk akun gratis; file yang lebih besar memerlukan paket yang ditingkatkan. Pengunggahan dilakukan secara streaming, sehingga penggunaan memori pada server Anda tetap rendah.
Bisakah saya mengonversi beberapa PDF ke DOCX dalam satu permintaan?
API memproses satu dokumen per permintaan, tetapi Anda dapat melakukan loop pada daftar file di Node.JS dan menjalankan konversi secara paralel, dengan memperhatikan batasan konkurensi akun Anda.
Apakah ada cara untuk menguji konversi secara lokal tanpa lisensi berbayar?
Ya, Anda dapat meminta lisensi evaluasi sementara dari halaman lisensi sementara. Ini menyediakan fungsionalitas penuh untuk pengembangan dan pengujian.

nodejs conversion on Document Processing REST APIs | GroupDocs Cloud