JavaScript में ऑफ़लाइन क्षमताएं चालू करना

Firebase ऐप्लिकेशन, नेटवर्क कनेक्शन के कुछ समय के लिए बंद होने पर भी काम करते हैं. हम डिवाइस की मौजूदगी की निगरानी करने और स्थानीय स्थिति को सर्वर की स्थिति के साथ सिंक करने के लिए कई टूल उपलब्ध कराते हैं. इन टूल के बारे में इस दस्तावेज़ में बताया गया है.

मौजूदगी की जानकारी मैनेज करना

रीयल टाइम ऐप्लिकेशन में, यह पता लगाना अक्सर फ़ायदेमंद होता है कि क्लाइंट कब कनेक्ट और डिसकनेक्ट होते हैं. उदाहरण के लिए, हो सकता है कि आप किसी उपयोगकर्ता के क्लाइंट के डिसकनेक्ट होने पर, उसे 'ऑफ़लाइन' के तौर पर मार्क करना चाहें.

Firebase डेटाबेस क्लाइंट, आसान प्राइमिटिव उपलब्ध कराते हैं. इनका इस्तेमाल, क्लाइंट के Firebase डेटाबेस सर्वर से डिसकनेक्ट होने पर, डेटाबेस में डेटा लिखने के लिए किया जा सकता है. ये अपडेट तब भी होते हैं, जब क्लाइंट सही तरीके से डिसकनेक्ट नहीं होता है. इसलिए, डेटा को क्लीन अप करने के लिए इन पर भरोसा किया जा सकता है. भले ही, कनेक्शन बंद हो गया हो या क्लाइंट क्रैश हो गया हो. डिसकनेक्ट होने पर, सेटिंग, अपडेट करने, और हटाने जैसे सभी लिखने के काम किए जा सकते हैं.

यहां onDisconnect प्राइमिटिव का इस्तेमाल करके, डिसकनेक्ट होने पर डेटा लिखने का एक आसान उदाहरण दिया गया है:

Web

import { getDatabase, ref, onDisconnect } from "firebase/database";

const db = getDatabase();
const presenceRef = ref(db, "disconnectmessage");
// Write a string when this client loses connection
onDisconnect(presenceRef).set("I disconnected!");
rtdb_ondisconnect_simple.js

Web

var presenceRef = firebase.database().ref("disconnectmessage");
// Write a string when this client loses connection
presenceRef.onDisconnect().set("I disconnected!");
offline.js

onDisconnect इवेंट के काम करने का तरीका

onDisconnect() ऑपरेशन सेट अप करने पर, ऑपरेशन Firebase Realtime Database सर्वर पर सेव हो जाता है. सर्वर, सुरक्षा की जांच करता है, ताकि यह पक्का किया जा सके कि उपयोगकर्ता, लिखने के लिए अनुरोध किए गए इवेंट को पूरा कर सकता है. अगर इवेंट अमान्य है, तो सर्वर आपके ऐप्लिकेशन को इसकी सूचना देता है. इसके बाद, सर्वर कनेक्शन को मॉनिटर करता है. अगर किसी भी समय कनेक्शन टाइम आउट हो जाता है या Realtime Database क्लाइंट ने उसे बंद कर दिया है, तो सर्वर दूसरी बार सुरक्षा की जांच करता है. इससे यह पक्का किया जाता है कि कार्रवाई अब भी मान्य है या नहीं. इसके बाद, सर्वर इवेंट को ट्रिगर करता है.

आपका ऐप्लिकेशन, लिखने के ऑपरेशन पर कॉलबैक का इस्तेमाल करके यह पक्का कर सकता है कि onDisconnect सही तरीके से अटैच किया गया है:

Web

onDisconnect(presenceRef).remove().catch((err) => {
  if (err) {
    console.error("could not establish onDisconnect event", err);
  }
});
rtdb_ondisconnect_callback.js

Web

presenceRef.onDisconnect().remove((err) => {
  if (err) {
    console.error("could not establish onDisconnect event", err);
  }
});
offline.js

onDisconnect इवेंट को .cancel() को कॉल करके भी रद्द किया जा सकता है:

Web

const onDisconnectRef = onDisconnect(presenceRef);
onDisconnectRef.set("I disconnected");
// some time later when we change our minds
onDisconnectRef.cancel();
rtdb_ondisconnect_cancel.js

Web

var onDisconnectRef = presenceRef.onDisconnect();
onDisconnectRef.set("I disconnected");
// some time later when we change our minds
onDisconnectRef.cancel();
offline.js

कनेक्शन की स्थिति का पता लगाना

ऑनलाइन होने की जानकारी से जुड़ी कई सुविधाओं के लिए, यह जानना आपके ऐप्लिकेशन के लिए फ़ायदेमंद होता है कि वह कब ऑनलाइन है और कब ऑफ़लाइन. Firebase Realtime Database /.info/connected पर एक खास जगह उपलब्ध कराता है, जो हर बार Firebase Realtime Database क्लाइंट के कनेक्शन की स्थिति बदलने पर अपडेट होती है. यहां एक उदाहरण दिया गया है:

Web

import { getDatabase, ref, onValue } from "firebase/database";

const db = getDatabase();
const connectedRef = ref(db, ".info/connected");
onValue(connectedRef, (snap) => {
  if (snap.val() === true) {
    console.log("connected");
  } else {
    console.log("not connected");
  }
});
rtdb_detect_connection_state.js

Web

var connectedRef = firebase.database().ref(".info/connected");
connectedRef.on("value", (snap) => {
  if (snap.val() === true) {
    console.log("connected");
  } else {
    console.log("not connected");
  }
});
offline.js

/.info/connected एक बूलियन वैल्यू है, जो Realtime Database क्लाइंट के बीच सिंक नहीं होती, क्योंकि वैल्यू क्लाइंट की स्थिति पर निर्भर करती है. दूसरे शब्दों में, अगर एक क्लाइंट /.info/connected को गलत के तौर पर पढ़ता है, तो इस बात की कोई गारंटी नहीं है कि कोई दूसरा क्लाइंट भी गलत पढ़ेगा.

इंतज़ार का समय कम करना

सर्वर टाइमस्टैंप

Firebase Realtime Database सर्वर, डेटा के तौर पर सर्वर पर जनरेट किए गए टाइमस्टैंप डालने का तरीका उपलब्ध कराते हैं. इस सुविधा को onDisconnect के साथ इस्तेमाल करके, Realtime Database क्लाइंट के डिसकनेक्ट होने के समय को आसानी से रिकॉर्ड किया जा सकता है:

Web

import { getDatabase, ref, onDisconnect, serverTimestamp } from "firebase/database";

const db = getDatabase();
const userLastOnlineRef = ref(db, "users/joe/lastOnline");
onDisconnect(userLastOnlineRef).set(serverTimestamp());
rtdb_set_server_timestamp.js

Web

var userLastOnlineRef = firebase.database().ref("users/joe/lastOnline");
userLastOnlineRef.onDisconnect().set(firebase.database.ServerValue.TIMESTAMP);
offline.js

क्लॉक स्क्यू

firebase.database.ServerValue.TIMESTAMP ज़्यादा सटीक है और ज़्यादातर पढ़ने/लिखने के कामों के लिए इसे प्राथमिकता दी जाती है. हालांकि, कभी-कभी Firebase Realtime Database के सर्वर के हिसाब से क्लाइंट की घड़ी के स्क्यू का अनुमान लगाने के लिए, यह काम का हो सकता है. /.info/serverTimeOffset के लिए कॉलबैक जोड़ा जा सकता है, ताकि मिलीसेकंड में वैल्यू मिल सके. Firebase Realtime Database क्लाइंट, सर्वर के समय का अनुमान लगाने के लिए, स्थानीय समय (मिलीसेकंड में युग का समय) में जोड़ते हैं. ध्यान दें कि नेटवर्किंग में लगने वाले समय की वजह से, इस ऑफ़सेट की सटीक जानकारी पर असर पड़ सकता है. इसलिए, यह मुख्य रूप से घड़ी के समय में बड़ी (> 1 सेकंड) गड़बड़ियों का पता लगाने के लिए काम आता है.

Web

import { getDatabase, ref, onValue } from "firebase/database";

const db = getDatabase();
const offsetRef = ref(db, ".info/serverTimeOffset");
onValue(offsetRef, (snap) => {
  const offset = snap.val();
  const estimatedServerTimeMs = new Date().getTime() + offset;
});
rtdb_estimate_clock_skew.js

Web

var offsetRef = firebase.database().ref(".info/serverTimeOffset");
offsetRef.on("value", (snap) => {
  var offset = snap.val();
  var estimatedServerTimeMs = new Date().getTime() + offset;
});
offline.js

सैंपल के तौर पर मौजूद ऐप्लिकेशन

डिसकनेक्ट करने की प्रोसेस को कनेक्शन की स्थिति की निगरानी और सर्वर टाइमस्टैंप के साथ जोड़कर, उपयोगकर्ता की मौजूदगी का सिस्टम बनाया जा सकता है. इस सिस्टम में, हर उपयोगकर्ता डेटा को डेटाबेस की किसी जगह पर सेव करता है, ताकि यह पता चल सके कि कोई Realtime Database क्लाइंट ऑनलाइन है या नहीं. क्लाइंट, ऑनलाइन आने पर इस जगह की जानकारी को 'सही है' पर सेट करते हैं. साथ ही, डिसकनेक्ट होने पर टाइमस्टैंप सेट करते हैं. इस टाइमस्टैंप से पता चलता है कि उपयोगकर्ता पिछली बार कब ऑनलाइन था.

ध्यान दें कि आपके ऐप्लिकेशन को उपयोगकर्ता को ऑनलाइन के तौर पर मार्क करने से पहले, डिसकनेक्ट करने के ऑपरेशन को सूची में जोड़ना चाहिए. ऐसा इसलिए, ताकि दोनों निर्देश सर्वर को भेजे जाने से पहले, क्लाइंट का नेटवर्क कनेक्शन बंद होने की स्थिति में, किसी भी तरह की समस्या से बचा जा सके.

उपयोगकर्ता की मौजूदगी का पता लगाने वाला एक आसान सिस्टम यहां दिया गया है:

Web

import { getDatabase, ref, onValue, push, onDisconnect, set, serverTimestamp } from "firebase/database";

// Since I can connect from multiple devices or browser tabs, we store each connection instance separately
// any time that connectionsRef's value is null (i.e. has no children) I am offline
const db = getDatabase();
const myConnectionsRef = ref(db, 'users/joe/connections');

// stores the timestamp of my last disconnect (the last time I was seen online)
const lastOnlineRef = ref(db, 'users/joe/lastOnline');

const connectedRef = ref(db, '.info/connected');
onValue(connectedRef, (snap) => {
  if (snap.val() === true) {
    // We're connected (or reconnected)! Do anything here that should happen only if online (or on reconnect)
    const con = push(myConnectionsRef);

    // When I disconnect, remove this device
    onDisconnect(con).remove();

    // Add this device to my connections list
    // this value could contain info about the device or a timestamp too
    set(con, true);

    // When I disconnect, update the last time I was seen online
    onDisconnect(lastOnlineRef).set(serverTimestamp());
  }
});
rtdb_sample_presence_app.js

Web

// Since I can connect from multiple devices or browser tabs, we store each connection instance separately
// any time that connectionsRef's value is null (i.e. has no children) I am offline
var myConnectionsRef = firebase.database().ref('users/joe/connections');

// stores the timestamp of my last disconnect (the last time I was seen online)
var lastOnlineRef = firebase.database().ref('users/joe/lastOnline');

var connectedRef = firebase.database().ref('.info/connected');
connectedRef.on('value', (snap) => {
  if (snap.val() === true) {
    // We're connected (or reconnected)! Do anything here that should happen only if online (or on reconnect)
    var con = myConnectionsRef.push();

    // When I disconnect, remove this device
    con.onDisconnect().remove();

    // Add this device to my connections list
    // this value could contain info about the device or a timestamp too
    con.set(true);

    // When I disconnect, update the last time I was seen online
    lastOnlineRef.onDisconnect().set(firebase.database.ServerValue.TIMESTAMP);
  }
});
offline.js