Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Gunakan metadata file dengan Cloud Storage di Web

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Setelah mengunggah 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 Metadata File

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 Metadata File

Anda dapat memperbarui metadata file kapan saja setelah pengunggahan file selesai dengan 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 beberapa alasan mengapa kesalahan dapat terjadi saat mendapatkan atau memperbarui metadata, termasuk file yang tidak ada, atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut tentang kesalahan dapat ditemukan di bagian Menangani Kesalahan pada dokumen.

Metadata Khusus

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 untuk menggunakan database (seperti Firebase Realtime Database ) untuk menyimpan dan menyinkronkan jenis data ini.

Properti Metadata File

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 pada unggahan, TIDAK pada pembaruanMetadata
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 juga dapat menghapusnya. Mari pelajari cara menghapus file dari Cloud Storage.