All Products
Search
Document Center

Object Storage Service:Streaming download (Node.js SDK)

Last Updated:Nov 30, 2025

Streaming download memungkinkan Anda mengunduh objek secara bertahap dalam bentuk aliran. Jika Anda perlu mengunduh objek besar atau proses unduhan memerlukan waktu lama, Anda dapat menggunakan streaming download untuk mengunduh objek tersebut secara bertahap.

Kode contoh

Berikut adalah contoh kode yang menunjukkan cara melakukan unduhan streaming untuk mengunduh objek bernama exampleobject.txt dari bucket examplebucket ke jalur D:\localpath di disk lokal.

Catatan

Saat Anda mengunduh file menggunakan getStream, Readable Stream yang dikembalikan memungkinkan Anda memproses konten file sebagai aliran.

const OSS = require('ali-oss');
const fs = require('fs');

const client = new OSS({
  // Setel region ke wilayah tempat bucket Anda berada. Misalnya, jika bucket Anda berada di wilayah China (Hangzhou), setel region ke oss-cn-hangzhou.
  region: 'yourRegion',
  // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Tentukan nama bucket.
  bucket: 'examplebucket',
});

async function getStream () {
  try {
    // Tentukan path lengkap objek. Path lengkap tidak boleh mencakup nama bucket.
    const result = await client.getStream('exampleobject.txt');
    console.log(result);
    // Tentukan path lengkap file lokal. Jika file sudah ada, file tersebut akan ditimpa. Jika file belum ada, file tersebut akan dibuat.
    // Jika path lokal tidak ditentukan, file akan disimpan ke direktori lokal proyek secara default.
    const writeStream = fs.createWriteStream('D:\\localpath\\examplefile.txt'); 
    result.stream.pipe(writeStream);
  } catch (e) {
    console.log(e);
  }
}

getStream()

Referensi

  • Untuk kode contoh lengkap terkait unduhan streaming, kunjungi halaman GitHub.

  • Untuk informasi lebih lanjut tentang operasi API yang dapat dipanggil untuk melakukan unduhan streaming, lihat dokumentasi GetObject.