使用 JavaScript 下載 Blob

發行項
03/11/2024

本文說明如何使用適用於 JavaScript 的 Azure 儲存體用戶端程式庫來下載 Blob。您可以將 Blob 資料下載到各種目的地，包括本機檔案路徑、資料流或文字字串。

必要條件

本文中的範例假設您已設定專案以使用適用於 JavaScript 的 Azure Blob 儲存體用戶端程式庫。若要了解如何設定專案，包括套件安裝、匯入模組，以及建立授權的用戶端物件來處理資料資源，請參閱開始使用 Azure Blob 儲存體和 JavaScript。
授權機制必須具有執行下載作業的權限。若要深入了解，請參閱下列 REST API 作業的授權指導：
- 取得 Blob

下載 Blob

您可以使用下列任一方法來下載 Blob：

BlobClient.download
BlobClient.downloadToBuffer (只能在 Node.js 執行階段中使用)
BlobClient.downloadToFile (只能在 Node.js 執行階段中使用)

下載至檔案路徑

下列範例會搭配使用檔案路徑與 BlobClient.downloadToFile 方法來下載 Blob。這個方法只能在 Node.js 執行階段中使用：

async function downloadBlobToFile(containerClient, blobName, fileNameWithPath) {

    const blobClient = containerClient.getBlobClient(blobName);
    
    await blobClient.downloadToFile(fileNameWithPath);
    console.log(`download of ${blobName} success`);
}

以串流的形式下載

下列範例會透過建立 Node.js 可寫入串流物件，然後使用 BlobClient.download 方法透過管道傳送至該串流，以下載 Blob。

async function downloadBlobAsStream(containerClient, blobName, writableStream) {

    const blobClient = containerClient.getBlobClient(blobName);

    const downloadResponse = await blobClient.download();

    downloadResponse.readableStreamBody.pipe(writableStream);
    console.log(`download of ${blobName} succeeded`);
}

下載至字串

下列 Node.js 範例使用 BlobClient.download 方法將 Blob 下載成字串。在 Node.js 中，Blob 資料會在 readableStreamBody 中傳回。


async function downloadBlobToString(containerClient, blobName) {

    const blobClient = containerClient.getBlobClient(blobName);

    const downloadResponse = await blobClient.download();

    const downloaded = await streamToBuffer(downloadResponse.readableStreamBody);
    console.log('Downloaded blob content:', downloaded.toString());
}

async function streamToBuffer(readableStream) {
    return new Promise((resolve, reject) => {
        const chunks = [];
        readableStream.on('data', (data) => {
            chunks.push(data instanceof Buffer ? data : Buffer.from(data));
        });
        readableStream.on('end', () => {
            resolve(Buffer.concat(chunks));
        });
        readableStream.on('error', reject);
    });
}

如果您在瀏覽器中使用 JavaScript，Blob 資料會在 promise blobBody 中傳回。若要深入了解，請參閱 BlobClient.download 中瀏覽器的範例使用方式。

資源

若要深入了解如何使用適用於 JavaScript 的 Azure Blob 儲存體用戶端程式庫下載 Blob，請參閱下列資源。

REST API 操作

適用於 JavaScript 的 Azure SDK 包含建置在 Azure REST API 之上的程式庫，可讓您透過熟悉的 JavaScript 範例與 REST API 作業進行互動。用來下載 Blob 的用戶端程式庫方法會使用下列 REST API 作業：

取得 Blob (REST API)

程式碼範例

檢視本文 (GitHub) 中的程式碼範例：

Share via