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,
  callback?: function,
): Promise<Device[]>

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

المعلمات

  • تصفية

    الفلتر اختياري

  • callback

    الدالة اختيارية

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

    (devices: Device[]) => void

    • الأجهزة

      Device[]

      قائمة بعناصر sessions.Device لكل جلسة تمت مزامنتها، مرتّبة من الجهاز الذي تم تعديل الجلسة فيه مؤخرًا إلى الجهاز الذي تم تعديل الجلسة فيه منذ فترة أطول يتم ترتيب عناصر tabs.Tab حسب تاريخ إنشائها في windows.Window لعناصر sessions.Session.

المرتجعات

  • Promise<Device[]>

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

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

getRecentlyClosed()

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

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

المعلمات

  • تصفية

    الفلتر اختياري

  • callback

    الدالة اختيارية

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

    (sessions: Session[]) => void

    • جلسات

      Session[]

      قائمة الإدخالات المغلقة بترتيب عكسي لترتيب إغلاقها (ستكون علامة التبويب أو النافذة المغلقة مؤخرًا في الفهرس 0). قد تحتوي الإدخالات على علامات تبويب أو نوافذ.

المرتجعات

  • Promise<Session[]>

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

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

restore()

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

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

المعلمات

  • sessionId

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

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

  • callback

    الدالة اختيارية

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

    (restoredSession: Session) => void

المرتجعات

  • Promise<Session>

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

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

الفعاليات

onChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void