Ladda ned en blob med JavaScript eller TypeScript

2025-04-03

Den här artikeln visar hur du laddar ned en blob med hjälp av Azure Storage-klientbiblioteket för JavaScript. Du kan ladda ned blobdata till olika mål, inklusive en lokal filsökväg, dataström eller textsträng.

Förutsättningar

Exemplen i den här artikeln förutsätter att du redan har ett projekt konfigurerat för att fungera med Azure Blob Storage-klientbiblioteket för JavaScript. Mer information om hur du konfigurerar projektet, inklusive paketinstallation, import av moduler och skapande av ett auktoriserat klientobjekt för att arbeta med dataresurser finns i Kom igång med Azure Blob Storage och JavaScript.
Auktoriseringsmekanismen måste ha behörighet att utföra en nedladdningsåtgärd. Mer information finns i auktoriseringsvägledningen för följande REST API-åtgärd:
- Hämta blob

Ladda ned en blob

Du kan använda någon av följande metoder för att ladda ned en blob:

BlobClient.download
BlobClient.downloadToBuffer (endast tillgängligt i Node.js runtime)
BlobClient.downloadToFile (endast tillgängligt i Node.js körmiljö)

Ladda ned till en filsökväg

I följande exempel laddas en blob ned genom en filsökväg med BlobClient.downloadToFile-metoden. Den här metoden är endast tillgänglig i Node.js-körningen:

JavaScript
TypeScript

async function downloadBlobToFile(containerClient, blobName, localFilePath) {

    const blobClient = containerClient.getBlobClient(blobName);
    
    await blobClient.downloadToFile(localFilePath);
}

async function downloadBlobToFile(
  containerClient: ContainerClient,
  blobName: string,
  filePath: string
): Promise<void> {

  const blobClient = containerClient.getBlobClient(blobName);

  await blobClient.downloadToFile(filePath);
}

Ladda ned som en ström

I följande exempel laddas en blob ned genom att skapa ett skrivbart Node.js-strömobjekt och sedan koppla till denna ström med metoden BlobClient.download.

JavaScript
TypeScript

async function downloadBlobAsStream(containerClient, blobName, writableStream) {

    const blobClient = containerClient.getBlobClient(blobName);

    const downloadResponse = await blobClient.download();

    downloadResponse.readableStreamBody.pipe(writableStream);
}

async function downloadBlobAsStream(
  containerClient: ContainerClient,
  blobName: string,
  writableStream: fs.WriteStream
) {
  
  const blobClient: BlobClient = containerClient.getBlobClient(blobName);

  const downloadResponse = await blobClient.download();

  if (!downloadResponse.errorCode && downloadResponse?.readableStreamBody) {
    downloadResponse.readableStreamBody.pipe(writableStream);
  }
}

Ladda ned till en sträng

Följande Node.js exempel laddar ned en blob till en sträng med metoden BlobClient.download . I Node.js så returneras blobdata i en readableStreamBody.

JavaScript
TypeScript

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

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

async function downloadBlobToString(
  containerClient: ContainerClient,
  blobName: string
): Promise<void> {

  const blobClient: BlobClient = containerClient.getBlobClient(blobName);

  const downloadResponse: BlobDownloadResponseParsed =
    await blobClient.download();

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

function streamToBuffer(readableStream) {
  return new Promise((resolve, reject) => {
    const chunks: Buffer[] = [];

    readableStream.on('data', (data) => {
      const content: Buffer = data instanceof Buffer ? data : Buffer.from(data);
      chunks.push(content);
    });
    readableStream.on('end', () => {
      resolve(Buffer.concat(chunks));
    });
    readableStream.on('error', reject);
  });
}

Om du arbetar med JavaScript i webbläsaren, returnerar ett löfte blobdata i blobBody. Mer information finns i exempelanvändningen för webbläsare på BlobClient.download.

Resurser

Mer information om hur du laddar ned blobar med hjälp av Azure Blob Storage-klientbiblioteket för JavaScript finns i följande resurser.

Kodexempel

Visa kodexempel från den här artikeln (GitHub):

Ladda ned till fil för JavaScript eller TypeScript
Ladda ned för att strömma för JavaScript eller TypeScript
Ladda ned som sträng för JavaScript eller TypeScript

REST API-åtgärder

Azure SDK för JavaScript innehåller bibliotek som bygger på Azure REST API, så att du kan interagera med REST API-åtgärder via välbekanta JavaScript-paradigm. Klientbiblioteksmetoderna för att ladda ned blobar använder följande REST API-åtgärd:

Hämta blob (REST API)

Klientbiblioteksresurser

Den här artikeln är en del av utvecklarguiden för Blob Storage för JavaScript/TypeScript. Mer information finns i den fullständiga listan över utvecklarguideartiklar i Skapa din JavaScript/TypeScript-app.

Feedback

Var den här sidan till hjälp?