browser.sessions

תיאור

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

הרשאות

sessions

סוגים

Device

מאפיינים

  • deviceName

    מחרוזת

    שם המכשיר הזר.

  • פעילויות באתר

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

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()

browser.sessions.getDevices(
  filter?: Filter,
)
: Promise<Device[]>

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

פרמטרים

  • סינון

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

החזרות

  • Promise<Device[]>

    ‫Chrome 96 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

getRecentlyClosed()

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

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

פרמטרים

  • סינון

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

החזרות

  • Promise<Session[]>

    ‫Chrome 96 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

restore()

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

פתיחה מחדש של windows.Window או tabs.Tab, עם קריאה חוזרת (callback) אופציונלית להפעלה כשהרשומה שוחזרה.

פרמטרים

החזרות

  • Promise<Session>

    ‫Chrome 96 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

אירועים

onChanged

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

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

פרמטרים

  • callback

    פונקציה

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

    () => void