الوصف
استخدِم واجهة برمجة تطبيقات chrome.tabGroups
للتفاعل مع نظام تجميع علامات التبويب في المتصفّح. يمكنك استخدام واجهة برمجة التطبيقات هذه لتعديل مجموعات علامات التبويب وإعادة ترتيبها في المتصفّح. لتجميع علامات التبويب وإلغاء تجميعها، أو الاستعلام عن علامات التبويب في المجموعات، استخدِم واجهة برمجة تطبيقات chrome.tabs
.
الأذونات
tabGroups
مدى التوفّر
الأنواع
Color
لون المجموعة.
التعداد
TabGroup
أماكن إقامة
-
تم تصغير الصف.
boolean
ما إذا كانت المجموعة مصغَّرة المجموعة المصغّرة هي المجموعة التي تكون علامات تبويبها مخفية.
-
اللون
لون المجموعة.
-
id
الرقم
رقم تعريف المجموعة. تكون أرقام تعريف المجموعات فريدة ضمن جلسة متصفّح.
-
title
سلسلة اختيارية
عنوان المجموعة.
-
windowId
الرقم
رقم تعريف النافذة التي تحتوي على المجموعة.
أماكن إقامة
TAB_GROUP_ID_NONE
معرّف يمثّل غياب مجموعة.
القيمة
-1
الطُرق
get()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
استرداد تفاصيل حول المجموعة المحددة.
المَعلمات
-
groupId
الرقم
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(group: TabGroup) => void
-
مجموعة
-
المرتجعات
-
Promise<TabGroup>
Chrome 90 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
move()
chrome.tabGroups.move(
groupId: number,
moveProperties: object,
callback?: function,
)
نقل المجموعة وجميع علامات التبويب الخاصة بها داخل نافذتها أو إلى نافذة جديدة
المَعلمات
-
groupId
الرقم
رقم تعريف المجموعة المطلوب نقلها.
-
moveProperties
عنصر
-
المؤشر
الرقم
الموضع الذي سيتم نقل المجموعة إليه. استخدِم
-1
لوضع المجموعة في نهاية النافذة. -
windowId
الرقم اختياري
النافذة المراد نقل المجموعة إليها يتم ضبط هذه السياسة تلقائيًا على النافذة التي توجد فيها المجموعة حاليًا. يُرجى العلم أنّه لا يمكن نقل المجموعات من وإلى النوافذ التي تستخدم النوع
windows.WindowType
من النوع"normal"
فقط.
-
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(group?: TabGroup) => void
-
مجموعة
TabGroup اختيارية
تفاصيل حول المجموعة التي تم نقلها
-
المرتجعات
-
Promise<TabGroup | undefined>
Chrome 90 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
query()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
للحصول على جميع المجموعات التي تتضمن السمات المحدّدة، أو جميع المجموعات إذا لم يتم تحديد أي خصائص
المَعلمات
-
queryInfo
عنصر
-
تم تصغير الصف.
منطقية اختيارية
ما إذا كان سيتم تصغير المجموعات
-
اللون
اللون اختياري
لون المجموعات
-
title
سلسلة اختيارية
مطابقة عناوين المجموعة بنمط معيّن
-
windowId
الرقم اختياري
رقم تعريف النافذة الرئيسية، أو
windows.WINDOW_ID_CURRENT
للنافذة الحالية.
-
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: TabGroup[]) => void
-
نتيجة
TabGroup[]
-
المرتجعات
-
Promise<TabGroup[]>
Chrome 90 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
callback?: function,
)
لتعديل خصائص مجموعة. ولا يتم تعديل الخصائص غير المحدّدة في updateProperties
.
المَعلمات
-
groupId
الرقم
رقم تعريف المجموعة المطلوب تعديلها.
-
updateProperties
عنصر
-
تم تصغير الصف.
منطقية اختيارية
ما إذا كان يجب تصغير المجموعة أم لا.
-
اللون
اللون اختياري
لون المجموعة.
-
title
سلسلة اختيارية
عنوان المجموعة.
-
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(group?: TabGroup) => void
-
مجموعة
TabGroup اختيارية
تفاصيل عن المجموعة المعدّلة
-
المرتجعات
-
Promise<TabGroup | undefined>
Chrome 90 والإصدارات الأحدثتتوفّر الوعود في إصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال من أجل التوافق مع الأنظمة القديمة. لا يمكنك استخدام كليهما في نفس استدعاء الدالة. يتم حل الوعد بنفس النوع الذي يتم تمريره إلى معاودة الاتصال.
فعاليات
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
يتم تنشيطها عند إنشاء مجموعة.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(group: TabGroup) => void
-
مجموعة
-
onMoved
chrome.tabGroups.onMoved.addListener(
callback: function,
)
يتم تنشيطها عند نقل مجموعة داخل نافذة. يستمر تنشيط أحداث النقل لعلامات التبويب الفردية ضمن المجموعة وكذلك للمجموعة نفسها. لا يتم تنشيط هذا الحدث عند نقل مجموعة بين النوافذ، بل ستتم إزالته من نافذة وإنشاءه في نافذة أخرى.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(group: TabGroup) => void
-
مجموعة
-
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
يتم تنشيطها عند إغلاق المجموعة، إما مباشرةً من قِبل المستخدم أو تلقائيًا لأنها لا تحتوي على أي علامات تبويب.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(group: TabGroup) => void
-
مجموعة
-
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
يتم تنشيطها عند تعديل المجموعة.