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

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

المعلمات

  • تصفية

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

  • رد الاتصال

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

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

    (devices: Device[]) => void

    • الأجهزة

      الجهاز[]

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

المرتجعات

  • الوعد<Device[]>

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

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

getRecentlyClosed()

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

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

المعلمات

  • تصفية

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

  • رد الاتصال

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

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

    (sessions: Session[]) => void

    • جلسات

      الجلسة[]

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

المرتجعات

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

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

    تتوفّر الوعود في الإصدار 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

المرتجعات

  • Promise&lt;Session&gt;

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

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

فعاليات

onChanged

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

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

المعلمات

  • رد الاتصال

    دالة

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

    () => void