الوصف
استخدام واجهة برمجة تطبيقات 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,
)
للحصول على قائمة بعلامات التبويب و/أو النوافذ التي تم إغلاقها مؤخرًا.
المَعلمات
المرتجعات
-
الوعد<الجلسة[]>
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