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

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

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

פרמטרים

  • סינון

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

  • callback

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

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

    (devices: Device[]) => void

    • מכשירים

      מכשיר[]

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

החזרות

  • Promise<Device[]>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

getRecentlyClosed()

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

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

פרמטרים

  • סינון

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

  • callback

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

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

    (sessions: Session[]) => void

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

      Session[]

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

החזרות

  • Promise<Session[]>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

restore()

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

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

פרמטרים

החזרות

  • Promise<Session>

    ‫Chrome 96 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

אירועים

onChanged

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

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

פרמטרים

  • callback

    פונקציה

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

    () => void