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) שתבוצע כשהערך ישוחזר.

פרמטרים

• sessionId

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

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

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

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

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

  (restoredSession: Session)=>void

  • restoredSession

    סשן

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

החזרות

• הבטחה<סשן>

  Chrome 96 ומעלה

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

אירועים

onChanged

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

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

פרמטרים

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

  פונקציה

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

  ()=>void