תיאור
שימוש ב-API chrome.sessions
כדי לשלוח שאילתות ולשחזר כרטיסיות וחלונות מסשן דפדוף.
הרשאות
sessions
סוגים
Device
מאפיינים
-
deviceName
מחרוזת
השם של המכשיר הזר.
-
פעילויות באתר
Session[]
רשימה של סשנים של חלונות פתוחים במכשיר הזר, ממוינים מהסשן האחרון ששונה לסשן האחרון ששונה לפני כן.
Filter
מאפיינים
-
maxResults
מספר אופציונלי
המספר המקסימלי של רשומות לאחזור ברשימה המבוקשת. כדי לאחזר את המספר המקסימלי של רשומות, משמיטים את הפרמטר הזה (
sessions.MAX_SESSION_RESULTS
).
Session
מאפיינים
-
lastModified
number
הזמן שבו החלון או הכרטיסייה נסגרו או שונו, שמוצג בשניות מאז תחילת המילניום.
-
כרטיסייה
Tab אופציונלי
הערך
tabs.Tab
, אם הרשומה הזו מתארת כרטיסייה. תתבצע הגדרה של הערך הזה או של הערךsessions.Session.window
. -
חלון
חלון אופציונלי
windows.Window
, אם הרשומה הזו מתארת חלון. תתבצע הגדרה של הערך הזה או של הערךsessions.Session.tab
.
מאפיינים
MAX_SESSION_RESULTS
המספר המקסימלי של sessions.Session
שייכללו ברשימה המבוקשת.
ערך
25
Methods
getDevices()
chrome.sessions.getDevices(
filter?: Filter,
callback?: function,
)
אחזור של כל המכשירים עם סשנים מסונכרנים.
פרמטרים
-
סינון
מסנן אופציונלי
-
callback
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(devices: Device[]) => void
-
מכשירים
מכשיר[]
רשימת האובייקטים מסוג
sessions.Device
לכל סשן סונכרן, ממוינת לפי המכשיר שבו בוצע השינוי האחרון בסשן ועד למכשיר שבו בוצע השינוי הקודם ביותר בסשן. אובייקטים מסוגtabs.Tab
ממוינים לפי תאריך היצירה ב-windows.Window
של אובייקטים מסוגsessions.Session
.
-
החזרות
-
Promise<Device[]>
גרסה 96 ואילך של Chromeיש תמיכה ב-Promises ב-Manifest V3 ואילך, אבל פונקציות קריאה חוזרת (callbacks) ניתנות לצורך תאימות לאחור. אי אפשר להשתמש בשניהם באותה קריאה לפונקציה. הפתרון של ההבטחה יהיה באותו סוג שהוענק ל-callback.
getRecentlyClosed()
chrome.sessions.getRecentlyClosed(
filter?: Filter,
callback?: function,
)
הפונקציה מקבלת את רשימת הכרטיסיות או החלונות שנסגרו לאחרונה.
פרמטרים
החזרות
-
Promise<Session[]>
גרסה 96 ואילך של Chromeיש תמיכה ב-Promises ב-Manifest V3 ואילך, אבל פונקציות קריאה חוזרת (callbacks) ניתנות לצורך תאימות לאחור. אי אפשר להשתמש בשניהם באותה קריאה לפונקציה. הפתרון של ההבטחה יהיה באותו סוג שהוענק ל-callback.
restore()
chrome.sessions.restore(
sessionId?: string,
callback?: function,
)
הפונקציה פותחת מחדש את windows.Window
או את tabs.Tab
, עם קריאה חוזרת אופציונלית שתופעל אחרי שהרשומה תוחזר.
פרמטרים
-
sessionId
מחרוזת אופציונלי
windows.Window.sessionId
אוtabs.Tab.sessionId
כדי לשחזר. אם לא מציינים את הפרמטר הזה, מתבצע שחזור של הסשן שנסגר לאחרונה. -
callback
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(restoredSession: Session) => void
-
restoredSession
sessions.Session
שמכיל את האובייקטwindows.Window
אוtabs.Tab
ששוחזר.
-
החזרות
-
Promise<Session>
גרסה 96 ואילך של Chromeיש תמיכה ב-Promises ב-Manifest V3 ואילך, אבל פונקציות קריאה חוזרת (callbacks) ניתנות לצורך תאימות לאחור. אי אפשר להשתמש בשניהם באותה קריאה לפונקציה. הפתרון של ההבטחה יהיה באותו סוג שהוענק ל-callback.
אירועים
onChanged
chrome.sessions.onChanged.addListener(
callback: function,
)
האירוע מופעל כשיש שינוי בכרטיסיות או בחלונות שנסגרו לאחרונה. האירוע הזה לא עוקב אחרי שינויים בסשנים מסונכרנים.
פרמטרים
-
callback
פונקציה
הפרמטר
callback
נראה כך:() => void