OnDisconnect class

המחלקה onDisconnect מאפשרת לך לכתוב או לנקות נתונים כאשר הלקוח שלך מתנתק משרת מסד הנתונים. עדכונים אלה מתרחשים בין אם הלקוח שלך מתנתק בצורה נקייה או לא, כך שאתה יכול לסמוך עליהם כדי לנקות נתונים גם אם חיבור נותק או לקוח קורס.

המחלקה onDisconnect משמשת לרוב לניהול נוכחות ביישומים שבהם כדאי לזהות כמה לקוחות מחוברים ומתי לקוחות אחרים מתנתקים. ראה הפעלת יכולות לא מקוונות ב-JavaScript למידע נוסף.

כדי למנוע בעיות כאשר חיבור נותק לפני שניתן להעביר את הבקשות לשרת מסד הנתונים, יש לקרוא לפונקציות אלו לפני כתיבת נתונים.

שים לב שפעולות onDisconnect מופעלות פעם אחת בלבד. אם אתה רוצה שפעולה תתרחש בכל פעם שמתרחש ניתוק, תצטרך להקים מחדש את פעולות onDisconnect בכל פעם שאתה מתחבר מחדש.

חֲתִימָה:

export declare class OnDisconnect 

שיטות

OnDisconnect.cancel()

מבטל את כל אירועי ההגדרה או העדכון onDisconnect() שהוגדרו בעבר בתור עבור מיקום זה וכל הילדים.

אם כתיבה הועמדה בתור למיקום זה באמצעות set() או update() במיקום אב, הכתיבה במיקום זה תבוטל, אם כי כתיבה למיקומי אחים עדיין תתרחש.

חֲתִימָה:

cancel(): Promise<void>;

החזרות:

הבטחה<void>

נפתר כאשר הסנכרון לשרת הושלם.

OnDisconnect.remove()

מבטיח שהנתונים במיקום זה יימחקו כאשר הלקוח מנותק (עקב סגירת הדפדפן, ניווט לדף חדש או בעיות ברשת).

חֲתִימָה:

remove(): Promise<void>;

החזרות:

הבטחה<void>

נפתר כאשר הסנכרון לשרת הושלם.

OnDisconnect.set()

מבטיח שהנתונים במיקום זה מוגדרים לערך שצוין כאשר הלקוח מנותק (עקב סגירת הדפדפן, ניווט לדף חדש או בעיות ברשת).

set() שימושי במיוחד להטמעת מערכות "נוכחות", שבהן יש לשנות או לנקות ערך כאשר משתמש מתנתק כך שהם ייראו "לא מקוונים" למשתמשים אחרים. ראה הפעלת יכולות לא מקוונות ב-JavaScript למידע נוסף.

שים לב שפעולות onDisconnect מופעלות פעם אחת בלבד. אם אתה רוצה שפעולה תתרחש בכל פעם שמתרחש ניתוק, תצטרך להקים מחדש את פעולות onDisconnect בכל פעם.

חֲתִימָה:

set(value: unknown): Promise<void>;

פרמטרים

החזרות:

הבטחה<void>

פותר כאשר הסנכרון למסד הנתונים הושלם.

OnDisconnect.setWithPriority()

מבטיח שהנתונים במיקום זה מוגדרים לערך ולעדיפות שצוינו כאשר הלקוח מנותק (עקב סגירת הדפדפן, ניווט לדף חדש או בעיות ברשת).

חֲתִימָה:

setWithPriority(value: unknown, priority: number | string | null): Promise<void>;

פרמטרים

החזרות:

הבטחה<void>

פותר כאשר הסנכרון למסד הנתונים הושלם.

OnDisconnect.update()

כותב מספר ערכים במיקום זה כאשר הלקוח מנותק (עקב סגירת הדפדפן, ניווט לדף חדש או בעיות ברשת).

הארגומנט values ​​מכיל צמדי ערך נכסים מרובים שייכתבו למסד הנתונים ביחד. כל מאפיין צאצא יכול להיות מאפיין פשוט (לדוגמה, "שם") או נתיב יחסי (לדוגמה, "שם/ראשון") מהמיקום הנוכחי לנתונים שיש לעדכן.

בניגוד לשיטת set() , ניתן להשתמש update() כדי לעדכן באופן סלקטיבי רק את המאפיינים המוזכרים במיקום הנוכחי (במקום להחליף את כל מאפייני הצאצא במיקום הנוכחי).

חֲתִימָה:

update(values: object): Promise<void>;

פרמטרים

החזרות:

הבטחה<void>

פותר כאשר הסנכרון למסד הנתונים הושלם.