chrome.sessions

توضیحات

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

مجوزها

sessions

انواع

Device

خواص

  • نام دستگاه

    رشته

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

  • جلسات

    جلسه []

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

Filter

خواص

  • حداکثر نتایج

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

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

Session

خواص

  • lastModified

    شماره

    زمانی که پنجره یا برگه بسته یا تغییر یافته است، در میلی ثانیه از آن دوره نشان داده شده است.

  • برگه

    برگه اختیاری است

    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 به نظر می رسد: 

    (devices: Device[]) => void

    • دستگاه ها

      دستگاه []

      لیست sessions.Device اشیاء دستگاه برای هر جلسه همگام‌سازی شده، به ترتیب از دستگاهی با آخرین جلسه اصلاح شده به دستگاهی با حداقل جلسه اصلاح شده مرتب شده است. اشیاء tabs.Tab بر اساس تازگی در windows.Window مرتب می شوند. پنجره sessions.Session . اشیاء جلسه.

برمی گرداند

  • Promise< دستگاه []>

    Chrome 96+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getRecentlyClosed()

قول بده
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

لیست برگه ها و/یا پنجره های اخیرا بسته شده را دریافت می کند.

پارامترها

  • فیلتر

    فیلتر اختیاری است

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (sessions: Session[]) => void

    • جلسات

      جلسه []

      فهرست ورودی‌های بسته شده به ترتیب معکوس بسته شده‌اند (اخرین برگه یا پنجره بسته شده در نمایه 0 خواهد بود). ورودی ها ممکن است دارای برگه یا پنجره باشند.

برمی گرداند

  • وعده< جلسه []>

    Chrome 96+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

restore()

قول بده
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

یک windows.Window یا tabs.Tab را مجدداً باز می‌کند، با یک پاسخ تماس اختیاری برای اجرا پس از بازیابی ورودی.

پارامترها

  • شناسه جلسه

    رشته اختیاری

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

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (restoredSession: Session) => void

برمی گرداند

  • وعده< جلسه >

    Chrome 96+

    Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

رویدادها

onChanged

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

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

پارامترها

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    () => void