Nach dem Hochladen einer Datei in eine Cloud Storage-Referenz kannst du auch Folgendes abrufen: oder die Metadaten der Datei aktualisieren, um beispielsweise den Inhaltstyp zu aktualisieren. Dateien können auch benutzerdefinierte Schlüssel/Wert-Paare mit zusätzlichen Dateimetadaten speichern.
Dateimetadaten abrufen
Dateimetadaten enthalten gängige Eigenschaften wie name
, size
und contentType
(oft als MIME-Typ bezeichnet) sowie einige weniger gängige wie contentDisposition
und timeCreated
. Diese Metadaten können
aus einer Cloud Storage-Referenz mithilfe von
die Methode getMetadata()
. getMetadata()
gibt eine Promise
mit den vollständigen Metadaten zurück oder einen Fehler, wenn die Promise
abgelehnt wird.
Web
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
// 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! });
Dateimetadaten aktualisieren
Sie können die Dateimetadaten jederzeit nach Abschluss des Dateiuploads mit der Methode updateMetadata()
aktualisieren. Weitere Informationen finden Sie im
finden Sie in der vollständigen Liste.
aktualisiert werden kann. Es werden nur die in den Metadaten angegebenen Properties aktualisiert. Alle anderen bleiben unverändert. updateMetadata()
gibt eine Promise
mit den vollständigen Metadaten zurück oder einen Fehler, wenn die Promise
abgelehnt wird.
Web
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
// 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! });
Sie können eine Metadateneigenschaft löschen, indem Sie sie auf null
festlegen:
Web
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
// 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! });
Fehler behandeln
Es kann verschiedene Gründe dafür geben, dass beim Abrufen oder Aktualisieren von Metadaten Fehler auftreten. Dazu gehört beispielsweise, dass die Datei nicht vorhanden ist oder der Nutzer keine Berechtigung zum Zugriff auf die gewünschte Datei hat. Weitere Informationen zu Fehlern finden Sie in der Fehler beheben der Dokumentation.
Benutzerdefinierte Metadaten
Sie können benutzerdefinierte Metadaten als Objekt mit String
-Eigenschaften angeben.
Web
const metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Web
var metadata = { customMetadata: { 'location': 'Yosemite, CA, USA', 'activity': 'Hiking' } };
Sie können benutzerdefinierte Metadaten verwenden, um zusätzliche App-spezifische Daten für jede Wir empfehlen jedoch dringend die Verwendung einer Datenbank (z. B. Firebase Realtime Database) um diese Art von Daten zu speichern und zu synchronisieren.
Dateimetadateneigenschaften
Eine vollständige Liste der Metadateneigenschaften einer Datei finden Sie unten:
Attribut | Typ | Beschreibbar |
---|---|---|
bucket |
String | NEIN |
generation |
String | NEIN |
metageneration |
String | NEIN |
fullPath |
String | NEIN |
name |
String | NEIN |
size |
number | NEIN |
timeCreated |
String | NEIN |
updated |
String | NEIN |
md5Hash |
String | JA beim Upload, NEIN bei updateMetadata |
cacheControl |
String | YES |
contentDisposition |
String | YES |
contentEncoding |
String | YES |
contentLanguage |
String | YES |
contentType |
String | YES |
customMetadata |
Objekt mit Stringzuordnungen | YES |
Das Hochladen, Herunterladen und Aktualisieren von Dateien ist wichtig, um sie zu entfernen. Sehen wir uns an, wie Sie Dateien in Cloud Storage löschen.