Setelah mengupload file ke referensi Cloud Storage, Anda juga bisa mendapatkan atau memperbarui metadata file, misalnya untuk memperbarui jenis konten. File juga dapat menyimpan pasangan kunci/nilai khusus dengan metadata file tambahan.
Dapatkan File Metadata
Metadata file berisi properti umum seperti name
, size
, dan contentType
(sering disebut sebagai tipe MIME) selain beberapa properti yang kurang umum seperti contentDisposition
dan timeCreated
. Metadata ini dapat diambil dari referensi Cloud Storage menggunakan metode getMetadata()
. getMetadata()
mengembalikan Promise
yang berisi metadata lengkap, atau kesalahan jika Promise
ditolak.
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! });
Perbarui File Metadata
Anda dapat memperbarui metadata file kapan pun setelah unggahan file selesai menggunakan metode updateMetadata()
. Lihat daftar lengkap untuk informasi lebih lanjut tentang properti apa yang dapat diperbarui. Hanya properti yang ditentukan dalam metadata yang diperbarui, yang lainnya tidak diubah. updateMetadata()
mengembalikan Promise
yang berisi metadata lengkap, atau kesalahan jika Promise
ditolak.
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! });
Anda dapat menghapus properti metadata dengan menyetelnya ke 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! });
Menangani Kesalahan
Ada sejumlah alasan mengapa kesalahan dapat terjadi saat mendapatkan atau memperbarui metadata, termasuk file tidak ada, atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut tentang kesalahan dapat ditemukan di bagian Penanganan Kesalahan pada dokumen.
Metadata Kustom
Anda dapat menentukan metadata khusus sebagai objek yang berisi properti 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' } };
Anda dapat menggunakan metadata khusus untuk menyimpan data khusus aplikasi tambahan untuk setiap file, tetapi kami sangat menyarankan penggunaan database (seperti Firebase Realtime Database ) untuk menyimpan dan menyinkronkan jenis data ini.
Properti Metadata Berkas
Daftar lengkap properti metadata pada file tersedia di bawah ini:
Properti | Jenis | Dapat ditulis |
---|---|---|
bucket | rangkaian | TIDAK |
generation | rangkaian | TIDAK |
metageneration | rangkaian | TIDAK |
fullPath | rangkaian | TIDAK |
name | rangkaian | TIDAK |
size | nomor | TIDAK |
timeCreated | rangkaian | TIDAK |
updated | rangkaian | TIDAK |
md5Hash | rangkaian | YA saat mengunggah, TIDAK saat memperbaruiMetadata |
cacheControl | rangkaian | YA |
contentDisposition | rangkaian | YA |
contentEncoding | rangkaian | YA |
contentLanguage | rangkaian | YA |
contentType | rangkaian | YA |
customMetadata | Objek yang berisi string->pemetaan string | YA |
Mengunggah, mengunduh, dan memperbarui file itu penting, tetapi begitu juga dengan menghapusnya. Mari pelajari cara menghapus file dari Cloud Storage.