JavaScript'te Çevrimdışı Özellikleri Etkinleştirme

Varlık durumunu yönetme

Gerçek zamanlı uygulamalarda istemcilerin ne zaman bağlanıp bağlantıyı ne zaman kestiğini algılamak genellikle yararlıdır. Örneğin, istemcisinin bağlantısı kesildiğinde bir kullanıcıyı "çevrimdışı" olarak işaretlemek isteyebilirsiniz.

Firebase Database istemcileri, bir istemcinin Firebase Database sunucularıyla bağlantısı kesildiğinde veritabanına yazmak için kullanabileceğiniz basit temel öğeler sağlar. Bu güncellemeler, istemcinin bağlantısı düzgün bir şekilde kesilsin veya kesilmesin gerçekleşir. Bu nedenle, bağlantı kesilse veya istemci kilitlense bile verileri temizlemek için bu güncellemelerden yararlanabilirsiniz. Ayarlama, güncelleme ve kaldırma dahil tüm yazma işlemleri, bağlantı kesildikten sonra gerçekleştirilebilir.

onDisconnect ilkelini kullanarak bağlantı kesildiğinde veri yazmayla ilgili basit bir örnek aşağıda verilmiştir:

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

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

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

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

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

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

Bağlantı durumunu algılama

Uygulamanızın, çevrimiçi veya çevrimdışı olduğunu bilmesi, varlığıyla ilgili birçok özellik için yararlıdır. Firebase Realtime Database, /.info/connected adresinde Firebase Realtime Database istemcisinin bağlantı durumu her değiştiğinde güncellenen özel bir konum sağlar. Aşağıda bir örnek verilmiştir:

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

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, istemcinin durumuna bağlı olduğu için Realtime Database istemcileri arasında senkronize edilmeyen bir boole değeridir. Diğer bir deyişle, bir istemci /.info/connected değerini yanlış olarak okursa bu, ayrı bir istemcinin de yanlış okuduğu anlamına gelmez.

İşleme Gecikmesi

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

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

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

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

Örnek Mevcutluk Uygulaması

Bağlantıyı kesme işlemlerini bağlantı durumu izleme ve sunucu zaman damgalarıyla birleştirerek bir kullanıcı varlığı sistemi oluşturabilirsiniz. Bu sistemde her kullanıcı, Realtime Database istemcisinin çevrimiçi olup olmadığını belirtmek için verileri bir veritabanı konumunda depolar. İstemciler, internete bağlandıklarında bu konumu doğru olarak, bağlantıyı kestiklerinde ise bir zaman damgası olarak ayarlar. Bu zaman damgası, söz konusu kullanıcının en son ne zaman çevrimiçi olduğunu gösterir.

İstemcinin ağ bağlantısı, her iki komut da sunucuya gönderilmeden önce kaybedildiğinde yarış koşullarının oluşmasını önlemek için uygulamanızın, kullanıcı çevrimiçi olarak işaretlenmeden önce bağlantıyı kesme işlemlerini sıraya koyması gerektiğini unutmayın.

Basit bir kullanıcı varlığı sistemi aşağıda verilmiştir:

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

// 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