NexaFirebase (React)
Halaman ini merangkum pola penggunaan NexaFirebase untuk operasi data realtime, sinkronisasi offline, autentikasi dasar, dan utilitas debugging dalam alur aplikasi React.
API utama yang diekspor
NexaFirebase(table): inisialisasi cepat (direkomendasikan).nexaFirebase(table): buat instance CRUD berbasis tabel.firebaseData(table): alias factory tambahan.NexaFirestore: class inti untuk operasi lanjutan.clearNexaFirebaseCache()/getNexaFirebaseCacheInfo(): utilitas cache instance.
Quick start
import { NexaFirebase } from "NexaJS";
const usersCRUD = await NexaFirebase("users");
const ping = await usersCRUD.testConnection();CRUD dasar
// Create
await usersCRUD.add({
user1: { name: "John", email: "john@example.com", active: true },
});
// Read
const one = await usersCRUD.get("user1");
const all = await usersCRUD.getAll();
// Update
await usersCRUD.history({
user1: { name: "John Updated", email: "john@example.com", active: true },
});
// Delete
await usersCRUD.del("user1");Offline & local cache
// Simpan dengan fallback offline
await usersCRUD.addOffline({
user_local: { name: "Offline User", email: "offline@example.com" },
});
// Ambil data (Firebase -> fallback local)
const user = await usersCRUD.getOffline("user_local");
// Sinkronisasi kembali saat online
const sync = await usersCRUD.syncWithFirebase();Auth ringkas
const result = await usersCRUD.createAccount(
"user@example.com",
"password123",
{ displayName: "Nexa User" }
);Platform info & debugging
getPlatformInfo()untuk deteksi Android/iOS/Web saat runtime.testConnection()dantestWritePermission()untuk validasi koneksi.getNexaFirebaseCacheInfo()untuk melihat status cache instance.clearNexaFirebaseCache()untuk reset cache saat troubleshooting.
Praktik disarankan
- Mulai dari
NexaFirebase()agar konfigurasi otomatis konsisten. - Gunakan satu tabel per domain data (mis.
users,orders). - Aktifkan pola offline untuk fitur kritikal di mobile.
- Uji
testConnection()di startup jika aplikasi sensitif jaringan.