Baixar um blob com JavaScript

  • Artigo

Este artigo mostra como baixar um blob usando a Biblioteca de clientes de Armazenamento do Microsoft Azure para JavaScript. Você pode baixar dados de blob em vários destinos, incluindo um caminho de arquivo local, fluxo ou cadeia de caracteres de texto.

Pré-requisitos

  • Os exemplos neste artigo pressupõem que você já tenha um projeto configurado para trabalhar com a biblioteca de clientes do Armazenamento de Blobs do Azure para JavaScript. Para saber mais sobre a configuração do seu projeto, incluindo a instalação de pacotes, a importação de módulos e a criação de um objeto cliente autorizado para trabalhar com recursos de dados, confira Introdução ao Armazenamento de Blobs do Azure e o JavaScript.
  • O mecanismo de autorização deve ter permissões para executar uma operação de download. Para saber mais, confira as diretrizes de autorização para as seguintes operações de API REST:

Baixar um blob

Você pode usar qualquer um dos seguintes métodos para baixar um blob:

Download em um caminho de arquivo

O exemplo a seguir baixa um blob usando um caminho de arquivo com o método BlobClient.downloadToFile. Esse método só está disponível no runtime do Node.js:

async function downloadBlobToFile(containerClient, blobName, fileNameWithPath) {

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

Baixar como fluxo

O exemplo a seguir baixa um blob criando um objeto de fluxo gravável do Node.js e, em seguida, canalizando para esse fluxo com o método BlobClient.download.

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

Download em uma cadeia de caracteres

O exemplo do Node.js a seguir baixa um blob em uma cadeia de caracteres com o método BlobClient.download. No Node.js, os dados de blob são retornados em um 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);
    });
}

Se você estiver trabalhando com JavaScript no navegador, os dados de blob serão retornados em um blobBody de promessa. Para saber mais, confira o exemplo de uso para navegadores em BlobClient.download.

Recursos

Para saber mais sobre como baixar blobs usando a biblioteca de clientes de Armazenamento de Blobs do Azure para JavaScript, consulte os recursos a seguir.

Operações da API REST

O SDK do Azure para JavaScript contém bibliotecas que se baseiam na API REST do Azure, permitindo a interação com as operações de API REST por meio de paradigmas conhecidos do JavaScript. Os métodos da biblioteca de clientes para baixar blobs usam a seguinte operação da API REST:

Exemplos de código

Exibir exemplos de código deste artigo (GitHub):

Recursos da biblioteca de clientes