Después de cargar un archivo en la referencia de Cloud Storage, también puede obtener o actualizar los metadatos del archivo, por ejemplo, para actualizar el tipo de contenido. Los archivos también pueden almacenar pares clave/valor personalizados con metadatos de archivos adicionales.
Obtener metadatos de archivo
Los metadatos de archivos contienen propiedades comunes como name
, size
y contentType
(a menudo denominado tipo MIME), además de algunas menos comunes como contentDisposition
y timeCreated
. Estos metadatos se pueden recuperar de una referencia de Cloud Storage mediante el método getMetadata()
. getMetadata()
devuelve una Promise
que contiene los metadatos completos o un error si la Promise
se rechaza.
Web version 9
import { getStorage, ref, getMetadata } from "firebase/storage"; // Create a reference to the file whose metadata we want to retrieve const storage = getStorage(); const forestRef = ref(storage, 'images/forest.jpg'); // Get metadata properties getMetadata(forestRef) .then((metadata) => { // Metadata now contains the metadata for 'images/forest.jpg' }) .catch((error) => { // Uh-oh, an error occurred! });
Web version 8
// Create a reference to the file whose metadata we want to retrieve var forestRef = storageRef.child('images/forest.jpg'); // Get metadata properties forestRef.getMetadata() .then((metadata) => { // Metadata now contains the metadata for 'images/forest.jpg' }) .catch((error) => { // Uh-oh, an error occurred! });
Actualizar metadatos de archivo
Puede actualizar los metadatos del archivo en cualquier momento después de que se complete la carga del archivo mediante el método updateMetadata()
. Consulte la lista completa para obtener más información sobre qué propiedades se pueden actualizar. Solo se actualizan las propiedades especificadas en los metadatos, todas las demás se dejan sin modificar. updateMetadata()
devuelve una Promise
que contiene los metadatos completos o un error si la Promise
se rechaza.
Web version 9
import { getStorage, ref, updateMetadata } from "firebase/storage"; // Create a reference to the file whose metadata we want to change const storage = getStorage(); const forestRef = ref(storage, 'images/forest.jpg'); // Create file metadata to update const newMetadata = { cacheControl: 'public,max-age=300', contentType: 'image/jpeg' }; // Update metadata properties updateMetadata(forestRef, newMetadata) .then((metadata) => { // Updated metadata for 'images/forest.jpg' is returned in the Promise }).catch((error) => { // Uh-oh, an error occurred! });
Web version 8
// Create a reference to the file whose metadata we want to change var forestRef = storageRef.child('images/forest.jpg'); // Create file metadata to update var newMetadata = { cacheControl: 'public,max-age=300', contentType: 'image/jpeg' }; // Update metadata properties forestRef.updateMetadata(newMetadata) .then((metadata) => { // Updated metadata for 'images/forest.jpg' is returned in the Promise }).catch((error) => { // Uh-oh, an error occurred! });
Puede eliminar una propiedad de metadatos configurándola en null
:
Web version 9
import { getStorage, ref, updateMetadata } from "firebase/storage"; const storage = getStorage(); const forestRef = ref(storage, 'images/forest.jpg'); // Create file metadata with property to delete const deleteMetadata = { contentType: null }; // Delete the metadata property updateMetadata(forestRef, deleteMetadata) .then((metadata) => { // metadata.contentType should be null }).catch((error) => { // Uh-oh, an error occurred! });
Web version 8
// Create file metadata with property to delete var deleteMetadata = { contentType: null }; // Delete the metadata property forestRef.updateMetadata(deleteMetadata) .then((metadata) => { // metadata.contentType should be null }).catch((error) => { // Uh-oh, an error occurred! });
Manejar errores
Hay una serie de razones por las que pueden ocurrir errores al obtener o actualizar los metadatos, incluido que el archivo no existe o que el usuario no tiene permiso para acceder al archivo deseado. Puede encontrar más información sobre los errores en la sección Manejar errores de los documentos.
Metadatos personalizados
Puede especificar metadatos personalizados como un objeto que contiene propiedades String
.
Web version 9
const metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Web version 8
var metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Puede usar metadatos personalizados para almacenar datos adicionales específicos de la aplicación para cada archivo, pero recomendamos usar una base de datos (como Firebase Realtime Database ) para almacenar y sincronizar este tipo de datos.
Propiedades de metadatos de archivo
Una lista completa de propiedades de metadatos en un archivo está disponible a continuación:
Propiedad | Escribe | escribible |
---|---|---|
bucket | cuerda | NO |
generation | cuerda | NO |
metageneration | cuerda | NO |
fullPath | cuerda | NO |
name | cuerda | NO |
size | número | NO |
timeCreated | cuerda | NO |
updated | cuerda | NO |
md5Hash | cuerda | SÍ al cargar, NO al actualizar Metadata |
cacheControl | cuerda | SI |
contentDisposition | cuerda | SI |
contentEncoding | cuerda | SI |
contentLanguage | cuerda | SI |
contentType | cuerda | SI |
customMetadata | Objeto que contiene asignaciones de cadena->cadena | SI |
Cargar, descargar y actualizar archivos es importante, pero también lo es poder eliminarlos. Aprendamos cómo eliminar archivos de Cloud Storage.