chrome.sessions

תיאור

אפשר להשתמש ב-chrome.sessions API כדי לשלוח שאילתות ולשחזר כרטיסיות וחלונות מסשן גלישה.

הרשאות

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,
): Promise<Device[]>

אחזור של כל המכשירים עם סשנים מסונכרנים.

פרמטרים

  • סינון

    מסנן אופציונלי

החזרות

  • Promise<Device[]>

    ‫Chrome 96 ואילך

getRecentlyClosed()

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
): Promise<Session[]>

מקבל את רשימת הכרטיסיות או החלונות שנסגרו לאחרונה.

פרמטרים

  • סינון

    מסנן אופציונלי

החזרות

  • Promise<Session[]>

    ‫Chrome 96 ואילך

restore()

chrome.sessions.restore(
  sessionId?: string,
): Promise<Session>

פותח מחדש windows.Window או tabs.Tab, עם אפשרות להפעיל קריאה חוזרת כשהערך משוחזר.

פרמטרים

  • sessionId

    מחרוזת אופציונלי

    ‫windows.Window.sessionId או tabs.Tab.sessionId כדי לשחזר. אם לא מציינים את הפרמטר הזה, הסשן שנסגר לאחרונה משוחזר.

החזרות

  • Promise<Session>

    ‫Chrome 96 ואילך

אירועים

onChanged

chrome.sessions.onChanged.addListener(
  callback: function,
)

האירוע מופעל כשחל שינוי בכרטיסיות או בחלונות שנסגרו לאחרונה. האירוע הזה לא עוקב אחרי שינויים בסשנים מסונכרנים.

פרמטרים

  • callback

    פונקציה

    הפרמטר callback נראה כך: 

    () => void