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 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

getRecentlyClosed()

وعده

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

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

مولفه های

• فیلتر

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

• پاسخ به تماس

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

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

  (sessions: Session[])=>void

  • جلسات

    جلسه []

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

برمی گرداند

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

  Chrome 96+

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

restore()

وعده

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

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

مولفه های

• شناسه جلسه

  رشته اختیاری

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

• پاسخ به تماس

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

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

  (restoredSession: Session)=>void

  • RestoreSession

    جلسه

    یک sessions.Session حاوی windows.Window یا tabs.Tab .

برمی گرداند

• وعده< جلسه >

  Chrome 96+

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

مناسبت ها

onChanged

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

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

مولفه های

• پاسخ به تماس

  تابع

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

  ()=>void