Descargar archivos en la Web

Cloud Storage permite a los programadores descargar archivos con rapidez y facilidad desde un depósito de Google Cloud Storage que proporciona y administra Firebase.

Crea una referencia

Para descargar un archivo, primero crea una referencia de Cloud Storage al archivo que deseas descargar.

Para crear una referencia, puedes anexar rutas secundarias a la raíz del almacenamiento o puedes crear una referencia a partir de una URL gs:// o https:// existente que haga referencia a un objeto de Cloud Storage.

// 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');

Descarga datos a través de URL

Para obtener la URL de descarga de un archivo, puedes llamar al método getDownloadURL() en una referencia de almacenamiento.

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

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

  // Or inserted into an <img> element:
  var img = document.getElementById('myimg');
  img.src = url;
}).catch(function(error) {
  // Handle any errors
});

Configuración de CORS

Para descargar datos directamente en el navegador, debes configurar el depósito de Cloud Storage para el acceso multiorigen (CORS). Puedes hacerlo con la herramienta de línea de comandos gsutil, que puedes instalar desde aquí.

Si no deseas que se apliquen restricciones según el dominio (el caso más común), copia este código JSON al archivo llamado cors.json:

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

Ejecuta gsutil cors set cors.json gs://<your-cloud-storage-bucket> para implementar estas restricciones.

Consulta los documentos de Cloud Storage para obtener más información.

Soluciona errores

Existen varios motivos por los cuales pueden ocurrir errores en una descarga: por ejemplo, es posible que el archivo no exista o que el usuario no tenga permiso para acceder al archivo deseado. Para obtener más información sobre los errores, consulta la sección de los documentos denominada Soluciona errores.

Ejemplo completo

A continuación, se muestra un ejemplo completo de una descarga con administración de errores:

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

// Get the download URL
starsRef.getDownloadURL().then(function(url) {
  // Insert url into an <img> tag to "download"
}).catch(function(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;
  }
});

También puedes obtener o actualizar metadatos de los archivos almacenados en Cloud Storage.