Web'de Bulut Depolama ile dosyaları indirin

Firebase için Cloud Storage, Firebase tarafından sağlanan ve yönetilen bir Cloud Storage paketinden hızlı ve kolay bir şekilde dosya indirmenize olanak tanır.

Referans Oluştur

Bir dosyayı indirmek için önce indirmek istediğiniz dosyaya bir Bulut Depolama referansı oluşturun .

Cloud Storage paketinizin kök dizinine alt yollar ekleyerek bir referans oluşturabilir veya Cloud Storage'daki bir nesneye başvuran mevcut bir gs:// veya https:// URL'sinden bir referans oluşturabilirsiniz.

import { getStorage, ref } from "firebase/storage";

// Create a reference with an initial file path and name
const storage = getStorage();
const pathReference = ref(storage, 'images/stars.jpg');

// Create a reference from a Google Cloud Storage URI
const gsReference = ref(storage, 'gs://bucket/images/stars.jpg');

// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
const httpsReference = ref(storage, 'https://firebasestorage.googleapis.com/b/bucket/o/images%20stars.jpg');  
storage_download_create_ref.js

// Create a reference with an initial file path and name
var storage = firebase.storage();
var pathReference = storage.ref('images/stars.jpg');

// Create a reference from a Google Cloud Storage URI
var gsReference = storage.refFromURL('gs://bucket/images/stars.jpg');

// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
var httpsReference = storage.refFromURL('https://firebasestorage.googleapis.com/b/bucket/o/images%20stars.jpg');  
download-files.js

Verileri URL yoluyla İndir

Bir Bulut Depolama referansında getDownloadURL() yöntemini çağırarak bir dosyanın indirme URL'sini alabilirsiniz.

import { getStorage, ref, getDownloadURL } from "firebase/storage";

const storage = getStorage();
getDownloadURL(ref(storage, 'images/stars.jpg'))
  .then((url) => {
    // `url` is the download URL for 'images/stars.jpg'

    // This can be downloaded directly:
    const xhr = new XMLHttpRequest();
    xhr.responseType = 'blob';
    xhr.onload = (event) => {
      const blob = xhr.response;
    };
    xhr.open('GET', url);
    xhr.send();

    // Or inserted into an <img> element
    const img = document.getElementById('myimg');
    img.setAttribute('src', url);
  })
  .catch((error) => {
    // Handle any errors
  });
storage_download_via_url.js

storageRef.child('images/stars.jpg').getDownloadURL()
  .then((url) => {
    // `url` is the download URL for 'images/stars.jpg'

    // This can be downloaded directly:
    var xhr = new XMLHttpRequest();
    xhr.responseType = 'blob';
    xhr.onload = (event) => {
      var blob = xhr.response;
    };
    xhr.open('GET', url);
    xhr.send();

    // Or inserted into an <img> element
    var img = document.getElementById('myimg');
    img.setAttribute('src', url);
  })
  .catch((error) => {
    // Handle any errors
  });
download-files.js

Verileri Doğrudan SDK'dan İndirin

9.5 ve üzeri sürümlerden itibaren SDK, doğrudan indirme için şu işlevleri sağlar:

• getBlob()
• getBytes()
• getStream()

Bu işlevleri kullanarak, bir URL'den indirmeyi atlayabilir ve bunun yerine kodunuzdaki verileri döndürebilirsiniz. Bu, Firebase Güvenlik Kuralları aracılığıyla daha ayrıntılı erişim kontrolü sağlar.

CORS Yapılandırması

Verileri doğrudan tarayıcıdan indirmek için Cloud Storage grubunuzu kaynaklar arası erişim (CORS) için yapılandırmanız gerekir. Bu, buradan yükleyebileceğiniz gsutil komut satırı aracıyla yapılabilir.

Etki alanı tabanlı herhangi bir kısıtlama istemiyorsanız (en yaygın senaryo), bu JSON'u cors.json :

[
  {
    "origin": ["*"],
    "method": ["GET"],
    "maxAgeSeconds": 3600
  }
]

Bu kısıtlamaları dağıtmak için gsutil cors set cors.json gs://<your-cloud-storage-bucket> çalıştırın.

Daha fazla bilgi için Google Bulut Depolama belgelerine bakın.

İşleme Hataları

Dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişim iznine sahip olmaması da dahil olmak üzere indirme sırasında hataların ortaya çıkmasının çeşitli nedenleri vardır. Hatalar hakkında daha fazla bilgi, belgelerin Hataları İşle bölümünde bulunabilir.

Tam Örnek

Hata işlemeli tam bir indirme örneği aşağıda gösterilmiştir:

import { getStorage, ref, getDownloadURL } from "firebase/storage";

// Create a reference to the file we want to download
const storage = getStorage();
const starsRef = ref(storage, 'images/stars.jpg');

// Get the download URL
getDownloadURL(starsRef)
  .then((url) => {
    // Insert url into an <img> tag to "download"
  })
  .catch((error) => {
    // A full list of error codes is available at
    // https://firebase.google.com/docs/storage/web/handle-errors
    switch (error.code) {
      case 'storage/object-not-found':
        // File doesn't exist
        break;
      case 'storage/unauthorized':
        // User doesn't have permission to access the object
        break;
      case 'storage/canceled':
        // User canceled the upload
        break;

      // ...

      case 'storage/unknown':
        // Unknown error occurred, inspect the server response
        break;
    }
  });
storage_download_full_example.js

// Create a reference to the file we want to download
var starsRef = storageRef.child('images/stars.jpg');

// Get the download URL
starsRef.getDownloadURL()
.then((url) => {
  // Insert url into an <img> tag to "download"
})
.catch((error) => {
  // A full list of error codes is available at
  // https://firebase.google.com/docs/storage/web/handle-errors
  switch (error.code) {
    case 'storage/object-not-found':
      // File doesn't exist
      break;
    case 'storage/unauthorized':
      // User doesn't have permission to access the object
      break;
    case 'storage/canceled':
      // User canceled the upload
      break;

    // ...

    case 'storage/unknown':
      // Unknown error occurred, inspect the server response
      break;
  }
});
download-files.js

Ayrıca Cloud Storage'da depolanan dosyalar için meta verileri alabilir veya güncelleyebilirsiniz .