chrome.sessions

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

sessions

الأنواع

Device

الخصائص

  • deviceName

    سلسلة

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

  • جلسات

    الجلسة[]

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

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

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

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

المعلمات

  • تصفية

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

  • callback

    function اختياري

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

    (devices: Device[]) => void

    • الأجهزة

      الجهاز[]

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

المرتجعات

  • Promise<Device[]>

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

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

getRecentlyClosed()

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

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

المعلمات

  • تصفية

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

  • callback

    function اختياري

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

    (sessions: Session[]) => void

    • جلسات

      الجلسة[]

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

المرتجعات

  • Promise<Session[]>

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

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

restore()

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

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

المعلمات

  • sessionId

    string اختياري

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

  • callback

    function اختياري

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

    (restoredSession: Session) => void

المرتجعات

  • Promise<Session>

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

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

الفعاليات

onChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void