chrome.sessions

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

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

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

פרמטרים

  • סינון

    Filter אופציונלי

  • callback

    פונקציה אופציונלית

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

    (devices: Device[]) => void

    • מכשירים

      Device[]

      רשימת האובייקטים של sessions.Device לכל סשן מסונכרן, ממוינת לפי סדר מהמכשיר עם הסשן שעבר שינוי לאחרונה למכשיר עם הסשן שעבר שינוי הכי מזמן. אובייקטים מסוג tabs.Tab ממוינים לפי התאריך האחרון ב-windows.Window של אובייקטים מסוג sessions.Session.

החזרות

  • Promise<Device[]>

    ‫Chrome 96 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getRecentlyClosed()

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

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

פרמטרים

  • סינון

    Filter אופציונלי

  • callback

    פונקציה אופציונלית

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

    (sessions: Session[]) => void

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

      Session[]

      רשימת הרשומות שנסגרו בסדר הפוך לסדר שבו הן נסגרו (הכרטיסייה או החלון שנסגרו לאחרונה יהיו באינדקס 0). הרשומות יכולות להכיל כרטיסיות או חלונות.

החזרות

  • ‫Promise<Session[]>

    ‫Chrome 96 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

restore()

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

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

פרמטרים

  • sessionId

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

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

  • callback

    פונקציה אופציונלית

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

    (restoredSession: Session) => void

החזרות

  • Promise<Session>

    ‫Chrome 96 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

onChanged

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

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

פרמטרים

  • callback

    פונקציה

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

    () => void