browser.sessions

شرح

از chrome.sessions API برای پرسمان و بازیابی برگه‌ها و پنجره‌ها از جلسه مرور استفاده کنید.

اجازه‌ها

sessions

انواع

Device

مشخصات

  • deviceName

    رشته

    نام دستگاه خارجی.

  • جلسه‌ها

    فهرستی از جلسه‌های پنجره باز برای دستگاه خارجی، که از جدیدترین به قدیمی‌ترین جلسه اصلاح‌شده مرتب شده است.

Filter

مشخصات

  • maxResults

    شماره اختیاری

    حداکثر تعداد ورودی‌هایی که باید در فهرست درخواستی واکشی شود. برای واکشی حداکثر تعداد ورودی‌ها (sessions.MAX_SESSION_RESULTS)، این پارامتر را حذف کنید.

Session

مشخصات

  • lastModified

    شماره

    زمانی که پنجره یا برگه بسته یا اصلاح شده است، برحسب ثانیه از تاریخ.

  • جهش

    برگه اختیاری

    tabs.Tab، اگر این ورودی زبانه‌ای را توصیف کند. یا این یا sessions.Session.window تنظیم خواهد شد.

  • پنجره

    پنجره اختیاری

    windows.Window، اگر این ورودی پنجره‌ای را توصیف کند. یا این یا sessions.Session.tab تنظیم خواهد شد.

مشخصات

MAX_SESSION_RESULTS

حداکثر تعداد sessions.Session که در فهرست درخواستی گنجانده خواهد شد.

مقدار

۲۵

روش‌ها

getDevices()

browser.sessions.getDevices(
  filter?: Filter,
)
: Promise<Device[]>

همه دستگاه‌های دارای جلسه‌های همگام‌سازی‌شده را بازیابی می‌کند.

پارامترها

بازگشتی‌ها

  • Promise<Device[]>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

getRecentlyClosed()

browser.sessions.getRecentlyClosed(
  filter?: Filter,
)
: Promise<Session[]>

فهرست زبانه‌ها و/یا پنجره‌های اخیراً بسته‌شده را دریافت می‌کند.

پارامترها

بازگشتی‌ها

  • Promise<Session[]>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

restore()

browser.sessions.restore(
  sessionId?: string,
)
: Promise<Session>

windows.Window یا tabs.Tab را دوباره باز می‌کند، با یک فراخوانی اختیاری برای اجرا شدن وقتی ورودی بازیابی شده است.

پارامترها

  • sessionId

    رشته اختیاری

    windows.Window.sessionId، یا tabs.Tab.sessionId برای بازیابی. اگر این پارامتر مشخص نشده باشد، آخرین جلسه بسته‌شده بازیابی می‌شود.

بازگشتی‌ها

  • Promise<Session>

    Chrome نسخه ۹۶ و بالاتر browser.* از Chrome نسخه ۱۴۸

رویدادها

onChanged

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

وقتی زبانه‌ها و/یا پنجره‌های اخیراً بسته‌شده تغییر می‌کنند، فعال می‌شود. این رویداد تغییرات جلسه‌های همگام‌سازی‌شده را پایش نمی‌کند.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است:

    () => void