chrome.sessions

refresh date: 2026-09-25 robots: noindex

شرح

از 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()

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

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

پارامترها

  • فیلتر کردن

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

  • تماس برگشتی

    تابع اختیاری

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

    (devices: Device[]) => void

    • دستگاه

      دستگاه[]

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

بازگشتی‌ها

  • Promise<Device[]>

    Chrome نسخه ۹۶ به بالا

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getRecentlyClosed()

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

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

پارامترها

  • فیلتر کردن

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

  • تماس برگشتی

    تابع اختیاری

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

    (sessions: Session[]) => void

    • جلسه‌ها

      جلسه[]

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

بازگشتی‌ها

  • Promise<Session[]>

    Chrome نسخه ۹۶ به بالا

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

restore()

قول 
chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
): Promise<Session>

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

پارامترها

  • sessionId

    رشته اختیاری

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

  • تماس برگشتی

    تابع اختیاری

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

    (restoredSession: Session) => void

بازگشتی‌ها

  • Promise<Session>

    Chrome نسخه ۹۶ به بالا

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

رویدادها

onChanged

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

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

پارامترها

  • تماس برگشتی

    عملکرد

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

    () => void