browser.sessions

الوصف

استخدِم واجهة برمجة التطبيقات chrome.sessions لطلب علامات التبويب والنوافذ واستعادتها من جلسة تصفّح.

الأذونات

sessions

الأنواع

Device

الخصائص

  • deviceName

    سلسلة

    اسم الجهاز الخارجي

  • جلسات

    الجلسة[]

    قائمة بجلسات النوافذ المفتوحة للجهاز الخارجي، مرتّبة من الجلسة التي تم تعديلها مؤخرًا إلى الجلسة التي تم تعديلها منذ فترة طويلة.

Filter

الخصائص

  • maxResults

    number اختيارية

    الحد الأقصى لعدد الإدخالات التي سيتم جلبها في القائمة المطلوبة. يمكنك حذف هذه المَعلمة لجلب الحد الأقصى لعدد الإدخالات (sessions.MAX_SESSION_RESULTS).

Session

الخصائص

  • lastModified

    الرقم

    الوقت الذي تم فيه إغلاق النافذة أو علامة التبويب أو تعديلها، ويتم تمثيله بالثواني منذ بدء حساب الفترة.

  • ‏:

    علامة التبويب اختيارية

    tabs.Tab، إذا كان هذا الإدخال يصف علامة تبويب سيتم ضبط هذه السمة أو السمة sessions.Session.window.

  • نافذة

    النافذة اختيارية

    windows.Window، إذا كان هذا الإدخال يصف نافذة. سيتم ضبط هذه السمة أو السمة sessions.Session.tab.

الخصائص

MAX_SESSION_RESULTS

الحد الأقصى لعدد sessions.Session التي سيتم تضمينها في القائمة المطلوبة.

القيمة

25

الطُرق

getDevices()

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

تسترد هذه الطريقة جميع الأجهزة التي تتضمّن جلسات متزامنة.

المعلمات

المرتجعات

  • Promise<Device[]>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

getRecentlyClosed()

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

للحصول على قائمة بعلامات التبويب و/أو النوافذ التي تم إغلاقها مؤخرًا

المعلمات

المرتجعات

  • Promise<Session[]>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

restore()

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

لإعادة فتح windows.Window أو tabs.Tab، مع معاودة الاتصال اختياريًا للتشغيل عند استعادة الإدخال.

المعلمات

  • sessionId

    string اختياري

    windows.Window.sessionId أو tabs.Tab.sessionId لاستعادة البيانات في حال عدم تحديد هذه المَعلمة، تتم استعادة آخر جلسة تم إغلاقها.

المرتجعات

  • Promise<Session>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

الفعاليات

onChanged

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

يتم تشغيل هذا الحدث عند تغيير علامات التبويب و/أو النوافذ التي تم إغلاقها مؤخرًا. لا يراقب هذا الحدث التغييرات في الجلسات التي تمت مزامنتها.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void