chrome.sessions

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات 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[]>

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

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

getRecentlyClosed()

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

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

المعلمات

  • تصفية

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

  • callback

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

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

    (sessions: Session[]) => void

    • جلسات

      Session[]

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

المرتجعات

  • Promise<Session[]>

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

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

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

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

الفعاليات

onChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void