JavaScript ile blob indirme
Bu makalede , JavaScript için Azure Depolama istemci kitaplığını kullanarak blob indirme işlemi gösterilmektedir. Blob verilerini yerel dosya yolu, akış veya metin dizesi gibi çeşitli hedeflere indirebilirsiniz.
Önkoşullar
- Bu makaledeki örneklerde, JavaScript için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere ayarlanmış bir projeniz olduğu varsayılır. Paket yükleme, modülleri içeri aktarma ve veri kaynaklarıyla çalışacak yetkili bir istemci nesnesi oluşturma gibi projenizi ayarlama hakkında bilgi edinmek için bkz. Azure Blob Depolama ve JavaScript ile çalışmaya başlama.
- Yetkilendirme mekanizmasının indirme işlemi gerçekleştirme izinleri olmalıdır. Daha fazla bilgi edinmek için aşağıdaki REST API işlemi için yetkilendirme kılavuzuna bakın:
Blobu indirme
Blob indirmek için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz:
- BlobClient.download
- BlobClient.downloadToBuffer (yalnızca Node.js çalışma zamanında kullanılabilir)
- BlobClient.downloadToFile (yalnızca Node.js çalışma zamanında kullanılabilir)
Dosya yoluna indirme
Aşağıdaki örnek , BlobClient.downloadToFile yöntemiyle bir dosya yolu kullanarak bir blob indirir. Bu yöntem yalnızca Node.js çalışma zamanında kullanılabilir:
async function downloadBlobToFile(containerClient, blobName, fileNameWithPath) {
const blobClient = containerClient.getBlobClient(blobName);
await blobClient.downloadToFile(fileNameWithPath);
console.log(`download of ${blobName} success`);
}
Akış olarak indirme
Aşağıdaki örnek, yazılabilir Node.js bir akış nesnesi oluşturarak ve ardından BlobClient.download yöntemiyle bu akışa ekleyerek bir blob indirir.
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`);
}
Dizeye indirme
Aşağıdaki Node.js örnek BlobClient.download yöntemiyle bir dizeye blob indirir. Node.js blob verileri içinde readableStreamBody
döndürür.
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);
});
}
Tarayıcıda JavaScript ile çalışıyorsanız blob verileri promise blobBody içinde döndürülüyor. Daha fazla bilgi edinmek için BlobClient.download adresinde tarayıcılara yönelik örnek kullanıma bakın.
Kaynaklar
JavaScript için Azure Blob Depolama istemci kitaplığını kullanarak blob indirme hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın.
REST API işlemleri
JavaScript için Azure SDK' sı, Azure REST API'sinin üzerinde derleyerek tanıdık JavaScript paradigmalarıyla REST API işlemleriyle etkileşim kurmanızı sağlayan kitaplıklar içerir. Blobları indirmek için istemci kitaplığı yöntemleri aşağıdaki REST API işlemini kullanır:
- Blob Alma (REST API)
Kod örnekleri
Bu makaledeki (GitHub) kod örneklerini görüntüleyin: