chrome.sessions

refresh date: 2026-09-25 robots: noindex

תיאור

משתמשים ב-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()

Promise

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

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

פרמטרים

• סינון

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

• callback

  function optional

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

  (devices: Device[]) => void

  • מכשירים

    מכשיר[]

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

החזרות

• Promise<Device[]>

  ‫Chrome מגרסה 96 ואילך

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getRecentlyClosed()

Promise

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

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

פרמטרים

• סינון

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

• callback

  function optional

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

  (sessions: Session[]) => void

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

    סשן[]

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

החזרות

• Promise<Session[]>

  ‫Chrome מגרסה 96 ואילך

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

restore()

Promise

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

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

פרמטרים

• sessionId

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

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

• callback

  function optional

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

  (restoredSession: Session) => void

  • restoredSession

    סשן

    ‫sessions.Session שמכיל את האובייקט המשוחזר windows.Window או tabs.Tab.

החזרות

• Promise<Session>

  ‫Chrome מגרסה 96 ואילך

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

אירועים

onChanged

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

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

פרמטרים

• callback

  פונקציה

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

  () => void