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