chrome.sessions

الوصف

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

الأذونات

sessions

الأنواع

Device

الخصائص

  • deviceName

    سلسلة

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

  • جلسات

    Session[]

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

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

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

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

المعلمات

المرتجعات

  • Promise<Device[]>

    الإصدار 96 من Chrome والإصدارات الأحدث

getRecentlyClosed()

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

تعرض هذه الطريقة قائمة بعلامات التبويب و/أو النوافذ التي تم إغلاقها مؤخرًا.

المعلمات

المرتجعات

  • Promise<Session[]>

    الإصدار 96 من Chrome والإصدارات الأحدث

restore()

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

تعيد هذه الطريقة فتح windows.Window أو tabs.Tab، مع إمكانية استخدام دالة ردّ الاتصال الاختيارية التي يتم تنفيذها عند استعادة الإدخال.

المعلمات

  • sessionId

    سلسلة اختيارية

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

المرتجعات

  • Promise<Session>

    الإصدار 96 من Chrome والإصدارات الأحدث

الفعاليات

onChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void