chrome.sessions

תיאור

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

הרשאות

sessions

סוגים

Device

תכונות

  • deviceName

    מחרוזת

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

  • ביקורים

    סשן[]

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

Filter

תכונות

  • maxResults

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

    המספר המקסימלי של הערכים לאחזור ברשימה המבוקשת. יש להשמיט את הפרמטר הזה כדי לאחזר את מספר הרשומות המקסימלי (sessions.MAX_SESSION_RESULTS).

Session

תכונות

  • lastModified

    מספר

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

  • tab

    Tab אופציונלי

    tabs.Tab, אם הרשומה הזו מתארת כרטיסייה. השדה הזה או sessions.Session.window יוגדר.

  • חלון

    חלון אופציונלי

    windows.Window, אם הערך הזה מתאר חלון. השדה הזה או sessions.Session.tab יוגדר.

תכונות

MAX_SESSION_RESULTS

המספר המקסימלי של sessions.Session שייכללו ברשימה המבוקשת.

Value

25

שיטות

getDevices()

הבטחה 
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

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

פרמטרים

  • סינון

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

  • קריאה חוזרת (callback)

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

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

    (devices: Device[])=>void

    • מכשירים

      המכשיר[]

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

החזרות

  • הבטחה<מכשיר[]>

    Chrome 96 ומעלה

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getRecentlyClosed()

הבטחה 
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

פרמטרים

  • סינון

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

  • קריאה חוזרת (callback)

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

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

    (sessions: Session[])=>void

    • ביקורים

      סשן[]

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

החזרות

  • הבטחה<סשן[]>

    Chrome 96 ומעלה

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

restore()

הבטחה 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

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

פרמטרים

החזרות

  • הבטחה<סשן>

    Chrome 96 ומעלה

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

אירועים

onChanged

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

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

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

    ()=>void