chrome.sessions

الوصف

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

الأذونات

sessions

الأنواع

Device

أماكن إقامة

• deviceName

  سلسلة

  اسم الجهاز الأجنبي

• الجلسات

  الجلسة[]

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

Filter

أماكن إقامة

• maxResults

  الرقم اختياري

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

Session

أماكن إقامة

• lastModified

  الرقم

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

• ‏

  Tab اختيارية

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

• نافذة

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

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

أماكن إقامة

MAX_SESSION_RESULTS

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

القيمة

25

الطُرق

getDevices()

وعد

chrome.sessions.getDevices(
  filter?: Filter,
  callback?: function,
)

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

المَعلمات

• filter

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (devices: Device[])=>void

  • جهاز

    الجهاز[]

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

المرتجعات

• تقديم وعود بإرسال<الجهاز[]>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

getRecentlyClosed()

وعد

chrome.sessions.getRecentlyClosed(
  filter?: Filter,
  callback?: function,
)

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

المَعلمات

• filter

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (sessions: Session[])=>void

  • الجلسات

    الجلسة[]

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

المرتجعات

• الوعد<الجلسة[]>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

restore()

وعد

chrome.sessions.restore(
  sessionId?: string,
  callback?: function,
)

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

المَعلمات

• sessionId

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (restoredSession: Session)=>void

  • restoredSession

    الجلسة

    sessions.Session يحتوي على الكائن windows.Window أو tabs.Tab الذي تمت استعادته.

المرتجعات

• الوعد<جلسة>

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

  تتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.

فعاليات

onChanged

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

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

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  ()=>void