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