Buka konsol

Menangani Error di Web

Terkadang ketika Anda membuat aplikasi, ada hal-hal yang tidak berjalan sesuai rencana dan terjadi error.

Jika merasa ragu, periksa penangan error (atau fungsi catch() untuk Promises), lalu lihat apa isi pesan error.

Jika Anda sudah memeriksa pesan error dan memiliki Aturan Keamanan Storage yang mengizinkan tindakan Anda, tetapi masih kesulitan dalam mengatasi error tersebut, kunjungi halaman Dukungan dan beri tahu masalahnya agar kami dapat membantu.

Menangani Pesan Error

Ada beberapa alasan mengapa terjadi error, termasuk tidak adanya file, pengguna tidak memiliki izin untuk mengakses file yang diinginkan, atau pengguna membatalkan upload file.

Untuk mendiagnosis masalah dan menangani error dengan benar, berikut ini daftar lengkap semua error yang dialami klien kami, dan bagaimana error tersebut terjadi.

Kode Alasan
storage/unknown Terjadi error yang tidak diketahui.
storage/object-not-found Tidak ada objek pada referensi yang diinginkan.
storage/bucket-not-found Tidak ada bucket yang dikonfigurasi untuk Cloud Storage.
storage/project-not-found Tidak ada project yang dikonfigurasi untuk Cloud Storage.
storage/quota-exceeded Kuota pada bucket Cloud Storage telah terlampaui. Jika Anda adalah pengguna paket gratis, upgrade ke paket berbayar. Jika Anda menggunakan paket berbayar, hubungi dukungan Firebase.
storage/unauthenticated Pengguna tidak terautentikasi. Autentikasikan pengguna, lalu coba lagi.
storage/unauthorized Pengguna tidak berwenang untuk melakukan tindakan yang diinginkan. Periksa aturan keamanan Anda untuk memastikan bahwa aturan tersebut sudah benar.
storage/retry-limit-exceeded Batas waktu maksimum pada operasi (upload, download, hapus, dll.) telah terlampaui. Coba upload lagi.
storage/invalid-checksum File pada klien tidak cocok dengan checksum file yang diterima oleh server. Coba upload lagi.
storage/canceled Pengguna membatalkan operasi.
storage/invalid-event-name Nama peristiwa yang diberikan tidak valid. Harus berupa salah satu dari [`running`, `progress`, `pause`]
storage/invalid-url URL yang tidak valid diberikan untuk refFromURL(). Harus berupa: gs://bucket/object atau https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=&ltTOKEN>
storage/invalid-argument Argumen yang diteruskan ke put() harus berupa Array `File`, `Blob`, atau `UInt8`. Argumen yang diteruskan ke putString() harus berupa string mentah, `Base64`, atau `Base64URL`.
storage/no-default-bucket Tidak ada bucket yang telah disetel dalam konfigurasi properti storageBucket Anda.
storage/cannot-slice-blob Biasanya terjadi ketika file lokal berubah (dihapus, disimpan lagi, dll.). Coba upload lagi setelah memverifikasi bahwa file tersebut tidak berubah.
storage/server-file-wrong-size Ukuran file pada klien tidak cocok dengan ukuran file yang diterima server. Coba upload lagi.