תיאור
אפשר להשתמש ב-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