Een blob downloaden met JavaScript of TypeScript

• .NET
• Java
• JavaScript
• Python
• Go

In dit artikel wordt beschreven hoe u een blob downloadt met behulp van de Azure Storage-clientbibliotheek voor JavaScript. U kunt blobgegevens downloaden naar verschillende bestemmingen, waaronder een lokaal bestandspad, een stroom of een tekenreeks.

Vereisten

• In de voorbeelden in dit artikel wordt ervan uitgegaan dat u al een project hebt ingesteld voor gebruik met de Azure Blob Storage-clientbibliotheek voor JavaScript. Zie Aan de slag met Azure Blob Storage en JavaScript voor meer informatie over het instellen van uw project, inclusief pakketinstallatie, het importeren van modules en het maken van een geautoriseerd clientobject voor gebruik met gegevensbronnen.
• Het autorisatiemechanisme moet machtigingen hebben om een downloadbewerking uit te voeren. Zie de autorisatierichtlijnen voor de volgende REST API-bewerking voor meer informatie:
  • Blob ophalen

Blob downloaden

U kunt een van de volgende methoden gebruiken om een blob te downloaden:

• BlobClient.download
• BlobClient.downloadToBuffer (alleen beschikbaar in Node.js runtime)
• BlobClient.downloadToFile (alleen beschikbaar in Node.js runtime)

Downloaden naar een bestandspad

In het volgende voorbeeld wordt een blob gedownload met behulp van een bestandspad met de methode BlobClient.downloadToFile . Deze methode is alleen beschikbaar in de Node.js runtime:

JavaScript

async function downloadBlobToFile(containerClient, blobName, localFilePath) {

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

TypeScript

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

  const blobClient = containerClient.getBlobClient(blobName);

  await blobClient.downloadToFile(filePath);
}

Downloaden als een stream

In het volgende voorbeeld wordt een blob gedownload door een Node.js beschrijfbaar streamobject te maken en vervolgens met de methode BlobClient.download naar die stream te gaan.

JavaScript

async function downloadBlobAsStream(containerClient, blobName, writableStream) {

    const blobClient = containerClient.getBlobClient(blobName);

    const downloadResponse = await blobClient.download();

    downloadResponse.readableStreamBody.pipe(writableStream);
}

TypeScript

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

Downloaden naar een tekenreeks

In het volgende Node.js voorbeeld wordt een blob gedownload naar een tekenreeks met de methode BlobClient.download . In Node.js worden blobgegevens geretourneerd in een readableStreamBody.

JavaScript

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

TypeScript

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

Als u met JavaScript in de browser werkt, worden blobgegevens geretourneerd in een promise blobBody. Zie het voorbeeldgebruik voor browsers op BlobClient.download voor meer informatie.

Resources

Zie de volgende resources voor meer informatie over het downloaden van blobs met behulp van de Azure Blob Storage-clientbibliotheek voor JavaScript.

Codevoorbeelden

Codevoorbeelden uit dit artikel bekijken (GitHub):

• Downloaden naar bestand voor JavaScript of TypeScript
• Downloaden om te streamen voor JavaScript of TypeScript
• Downloaden naar tekenreeks voor JavaScript of TypeScript

REST API-bewerkingen

De Azure SDK voor JavaScript bevat bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende JavaScript-paradigma's. De clientbibliotheekmethoden voor het downloaden van blobs gebruiken de volgende REST API-bewerking:

• Blob ophalen (REST API)

Clientbibliotheekbronnen

• Referentiedocumentatie voor clientbibliotheek
• Broncode van clientbibliotheek
• Package (npm)

Gerelateerde inhoud

• Dit artikel maakt deel uit van de ontwikkelaarshandleiding voor Blob Storage voor JavaScript/Typescript. Zie de volledige lijst met artikelen over ontwikkelaarshandleidingen in Uw JavaScript-/Typescript-app bouwen voor meer informatie.