जावास्क्रिप्ट में ऑफ़लाइन क्षमताओं को सक्षम करना

यदि आपका ऐप अस्थायी रूप से अपना नेटवर्क कनेक्शन खो देता है तो भी फायरबेस एप्लिकेशन काम करते हैं। हम उपस्थिति की निगरानी और स्थानीय स्थिति को सर्वर स्थिति के साथ सिंक्रनाइज़ करने के लिए कई उपकरण प्रदान करते हैं, जो इस दस्तावेज़ में प्रस्तुत किए गए हैं।

उपस्थिति का प्रबंधन

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

फ़ायरबेस डेटाबेस क्लाइंट सरल प्राइमेटिव प्रदान करते हैं जिनका उपयोग आप डेटाबेस में लिखने के लिए कर सकते हैं जब कोई क्लाइंट फ़ायरबेस डेटाबेस सर्वर से डिस्कनेक्ट हो जाता है। ये अपडेट होते हैं चाहे क्लाइंट साफ-साफ डिस्कनेक्ट हो या नहीं, इसलिए कनेक्शन टूटने या क्लाइंट क्रैश होने पर भी आप डेटा को साफ करने के लिए उन पर भरोसा कर सकते हैं। सेटिंग, अपडेट करने और हटाने सहित सभी लेखन कार्य डिस्कनेक्शन पर किए जा सकते हैं।

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

Web modular API

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!");

Web namespaced API

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

ऑनडिस्कनेक्ट कैसे काम करता है

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

आपका ऐप राइट ऑपरेशन पर कॉलबैक का उपयोग यह सुनिश्चित करने के लिए कर सकता है कि onDisconnect सही ढंग से संलग्न था:

Web modular API

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

Web namespaced API

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

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

Web modular API

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

Web namespaced API

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

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

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

Web modular API

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");
  }
});

Web namespaced API

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

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

विलंबता को संभालना

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

फायरबेस रीयलटाइम डेटाबेस सर्वर सर्वर पर उत्पन्न टाइमस्टैम्प को डेटा के रूप में सम्मिलित करने के लिए एक तंत्र प्रदान करते हैं। यह सुविधा, onDisconnect के साथ मिलकर, उस समय को विश्वसनीय रूप से नोट करने का एक आसान तरीका प्रदान करती है जिस पर रीयलटाइम डेटाबेस क्लाइंट डिस्कनेक्ट हुआ था:

Web modular API

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

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

Web namespaced API

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

कालद विचलन

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

Web modular API

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;
});

Web namespaced API

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

नमूना उपस्थिति ऐप

कनेक्शन स्थिति निगरानी और सर्वर टाइमस्टैम्प के साथ डिस्कनेक्ट संचालन को जोड़कर, आप एक उपयोगकर्ता उपस्थिति प्रणाली बना सकते हैं। इस प्रणाली में, प्रत्येक उपयोगकर्ता यह इंगित करने के लिए डेटाबेस स्थान पर डेटा संग्रहीत करता है कि रीयलटाइम डेटाबेस क्लाइंट ऑनलाइन है या नहीं। ग्राहक ऑनलाइन आने पर इस स्थान को सही पर सेट करते हैं और डिस्कनेक्ट होने पर टाइमस्टैम्प को सेट करते हैं। यह टाइमस्टैम्प इंगित करता है कि दिया गया उपयोगकर्ता आखिरी बार कब ऑनलाइन था।

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

यहाँ एक सरल उपयोगकर्ता उपस्थिति प्रणाली है:

Web modular API

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());
  }
});

Web namespaced API

// 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);
  }
});