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

שיטות

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) אופציונלית שתרוץ כשהרשומה תשוחזר.

פרמטרים

החזרות

  • Promise&lt;Session&gt;

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

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

אירועים

onChanged

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

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

פרמטרים

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

    פונקציה

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

    () => void