Class onDisconnect memungkinkan Anda menulis atau menghapus data saat klien Anda memutuskan koneksi dari server Database. Update ini akan terjadi, terlepas dari apakah klien memutuskan koneksi secara bersih atau tidak, sehingga Anda dapat mengandalkan update ini untuk membersihkan data, meskipun koneksi terputus atau klien mengalami error.
Class onDisconnect paling sering digunakan untuk mengelola kehadiran di aplikasi yang berguna untuk mendeteksi jumlah klien yang terhubung dan kapan klien lain memutuskan koneksi. Lihat Mengaktifkan Kemampuan Offline di JavaScript untuk informasi selengkapnya.
Untuk menghindari masalah saat koneksi terputus sebelum permintaan dapat ditransfer ke server Database, fungsi-fungsi ini harus dipanggil sebelum menulis data apa pun.
Perhatikan bahwa operasi onDisconnect hanya dipicu satu kali. Jika ingin operasi terjadi setiap kali terjadi pemutusan koneksi, Anda harus membuat kembali operasi onDisconnect setiap kali Anda terhubung kembali.
Tanda Tangan:
export declare class OnDisconnect
Metode
| Metode | Pengubah | Deskripsi |
|---|---|---|
| cancel(). | Membatalkan semua peristiwa pembaruan atau kumpulan onDisconnect() yang sebelumnya diantrekan untuk lokasi ini dan semua turunan.Jika operasi tulis telah diantrekan untuk lokasi ini melalui set() atau update() di lokasi induk, penulisan di lokasi ini akan dibatalkan, meskipun operasi tulis ke lokasi yang seinduk akan tetap terjadi. |
|
| remove() | Memastikan data di lokasi ini dihapus saat klien terputus (karena menutup browser, menavigasi ke halaman baru, atau masalah jaringan). | |
| set(nilai) | Memastikan data di lokasi ini ditetapkan ke nilai yang ditentukan saat klien tidak terhubung (karena menutup browser, membuka halaman baru, atau masalah jaringan).set() sangat berguna untuk menerapkan "kehadiran" sistem, di mana nilai harus diubah atau dihapus saat pengguna memutuskan koneksi sehingga terlihat "offline" kepada pengguna lain. Lihat Mengaktifkan Kemampuan Offline di JavaScript untuk informasi selengkapnya.Perhatikan bahwa operasi onDisconnect hanya dipicu satu kali. Jika ingin operasi terjadi setiap kali terjadi pemutusan koneksi, Anda harus membuat kembali operasi onDisconnect setiap kali pemutusan koneksi. |
|
| setWithPriority(nilai, prioritas) | Memastikan data di lokasi ini ditetapkan ke nilai dan prioritas yang ditentukan saat klien terputus (karena menutup browser, menavigasi ke halaman baru, atau masalah jaringan). | |
| update(nilai) | Menulis beberapa nilai di lokasi ini saat klien tidak terhubung (karena menutup browser, membuka halaman baru, atau masalah jaringan).Argumen values berisi beberapa pasangan nilai properti yang akan ditulis ke Database bersama-sama. Setiap properti turunan dapat berupa properti sederhana (misalnya, "nama") atau jalur relatif (misalnya, "nama/depan") dari lokasi saat ini ke data yang akan diperbarui.Berbeda dengan metode set(), update() dapat digunakan untuk memperbarui secara selektif hanya properti yang direferensikan di lokasi saat ini (bukan mengganti semua properti turunan di lokasi saat ini). |
OnPutuskan Koneksi.cancel()
Membatalkan semua peristiwa kumpulan atau pembaruan onDisconnect() yang berada dalam antrean sebelumnya untuk lokasi ini dan semua turunan.
Jika operasi tulis telah diantrekan untuk lokasi ini melalui set() atau update() di lokasi induk, penulisan di lokasi ini akan dibatalkan, meskipun operasi tulis ke lokasi yang seinduk masih akan terjadi.
Tanda Tangan:
cancel(): Promise<void>;
Hasil:
Janji<void>
Menyelesaikan masalah saat sinkronisasi ke server selesai.
OnPutuskan Koneksi.remove()
Memastikan data di lokasi ini dihapus saat klien terputus (karena menutup browser, menavigasi ke halaman baru, atau masalah jaringan).
Tanda Tangan:
remove(): Promise<void>;
Hasil:
Janji<void>
Menyelesaikan masalah saat sinkronisasi ke server selesai.
Putuskan Koneksi.set()
Memastikan data di lokasi ini ditetapkan ke nilai yang ditentukan saat klien terputus (karena menutup browser, menavigasi ke halaman baru, atau masalah jaringan).
set() sangat berguna untuk menerapkan "kehadiran" sistem, di mana nilai harus diubah atau dihapus saat pengguna memutuskan koneksi sehingga terlihat "offline" kepada pengguna lain. Lihat Mengaktifkan Kemampuan Offline di JavaScript untuk informasi selengkapnya.
Perhatikan bahwa operasi onDisconnect hanya dipicu satu kali. Jika ingin operasi terjadi setiap kali terjadi pemutusan koneksi, Anda harus membuat kembali operasi onDisconnect setiap kali pemutusan koneksi.
Tanda Tangan:
set(value: unknown): Promise<void>;
Parameter
| Parameter | Jenis | Deskripsi |
|---|---|---|
| value | tidak diketahui | Nilai yang akan ditulis ke lokasi ini saat memutuskan koneksi (dapat berupa objek, array, string, angka, boolean, atau null). |
Hasil:
Janji<void>
Menyelesaikan masalah saat sinkronisasi ke Database selesai.
OnPutuskan.setWithPriority()
Memastikan data di lokasi ini ditetapkan ke nilai dan prioritas yang ditentukan saat klien terputus (karena menutup browser, menavigasi ke halaman baru, atau masalah jaringan).
Tanda Tangan:
setWithPriority(value: unknown, priority: number | string | null): Promise<void>;
Parameter
| Parameter | Jenis | Deskripsi |
|---|---|---|
| value | tidak diketahui | Nilai yang akan ditulis ke lokasi ini saat memutuskan koneksi (dapat berupa objek, array, string, angka, boolean, atau null). |
| priority | angka | rangkaian | null (kosong) | Prioritas yang akan ditulis (string, angka, atau null). |
Hasil:
Janji<void>
Menyelesaikan masalah saat sinkronisasi ke Database selesai.
OnPutuskan Koneksi.update()
Menulis beberapa nilai di lokasi ini saat klien terputus (karena menutup browser, menavigasi ke halaman baru, atau masalah jaringan).
Argumen values berisi beberapa pasangan nilai properti yang akan ditulis ke Database bersama-sama. Setiap properti turunan dapat berupa properti sederhana (misalnya, "nama") atau jalur relatif (misalnya, "nama/depan") dari lokasi saat ini ke data yang akan diperbarui.
Berbeda dengan metode set(), update() dapat digunakan untuk memperbarui secara selektif hanya properti yang direferensikan di lokasi saat ini (bukan mengganti semua properti turunan di lokasi saat ini).
Tanda Tangan:
update(values: object): Promise<void>;
Parameter
| Parameter | Jenis | Deskripsi |
|---|---|---|
| nilai | objek | Objek yang berisi beberapa nilai. |
Hasil:
Janji<void>
Menyelesaikan masalah saat sinkronisasi ke Database selesai.