chrome.sessions

תיאור

שימוש ב-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,
)

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

פרמטרים

  • סינון

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

  • callback

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

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

    (devices: Device[]) => void

    • מכשירים

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

החזרות

  • Promise<Device[]>

    גרסה 96 ואילך של Chrome

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

getRecentlyClosed()

Promise
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

פרמטרים

  • סינון

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

  • callback

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

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

    (sessions: Session[]) => void

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

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

החזרות

  • Promise<Session[]>

    גרסה 96 ואילך של Chrome

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

restore()

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

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

פרמטרים

החזרות

  • Promise<Session>

    גרסה 96 ואילך של Chrome

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

אירועים

onChanged

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

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

פרמטרים

  • callback

    פונקציה

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

    () => void