chrome.sessions

تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex

توضیحات

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

مجوزها

sessions

انواع

Device

خواص

  • نام دستگاه

    رشته

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

  • جلسات

    جلسه []

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

Filter

خواص

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

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

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

Session

خواص

  • آخرین اصلاح‌شده

    شماره

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

  • تب

    تب اختیاری

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

  • پنجره

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

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

خواص

MAX_SESSION_RESULTS

حداکثر تعداد sessions.Session که در لیست درخواستی قرار خواهد گرفت.

ارزش

۲۵

روش‌ها

getDevices()

وعده
chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
): Promise<Device[]>

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

پارامترها

  • فیلتر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (devices: Device[]) => void

    • دستگاه‌ها

      دستگاه []

      فهرست اشیاء sessions.Device برای هر جلسه همگام‌سازی شده، که به ترتیب از دستگاهی با جدیدترین جلسه تغییر یافته تا دستگاهی با کمترین تغییرات اخیر در جلسه مرتب شده‌اند. tabs.Tab اشیاء بر اساس تازگی در windows.Window مربوط به اشیاء sessions.Session مرتب شده‌اند.

بازگشت‌ها

  • قول< دستگاه []>

    کروم ۹۶+

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

getRecentlyClosed()

وعده
chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
): Promise<Session[]>

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

پارامترها

  • فیلتر

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (sessions: Session[]) => void

    • جلسات

      جلسه []

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

بازگشت‌ها

  • قول< جلسه []>

    کروم ۹۶+

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

restore()

وعده
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

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

پارامترها

  • شناسه جلسه

    رشته اختیاری

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

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به شکل زیر است: 

    (restoredSession: Session) => void

بازگشت‌ها

  • وعده< جلسه >

    کروم ۹۶+

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

رویدادها

onChanged

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

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

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    () => void