chrome.tabGroups

الوصف

استخدِم واجهة برمجة التطبيقات chrome.tabGroups للتفاعل مع نظام تجميع علامات التبويب في المتصفّح. يمكنك استخدام واجهة برمجة التطبيقات هذه لتعديل مجموعات علامات التبويب وإعادة ترتيبها في المتصفّح. لتجميع علامات التبويب وإلغاء تجميعها أو للاستعلام عن علامات التبويب المضمّنة في المجموعات، استخدِم واجهة برمجة التطبيقات chrome.tabs.

الأذونات

tabGroups

مدى التوفّر

الإصدار 89 من Chrome والإصدارات الأحدث الإصدار 3 من MV والإصدارات الأحدث

الأنواع

Color

لون المجموعة

تعداد

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

الخصائص

  • تم التصغير

    قيمة منطقية

    ما إذا كانت المجموعة مصغّرة المجموعة المصغّرة هي مجموعة تكون علامات تبويبها مخفية.

  • اللون

    اللون

    لون المجموعة

  • id

    الرقم

    رقم تعريف المجموعة. تكون أرقام تعريف المجموعات فريدة داخل جلسة المتصفّح.

  • تمت المشاركة

    قيمة منطقية

    في انتظار المراجعة

    ما إذا كانت المجموعة مشترَكة

  • title

    سلسلة اختيارية

    عنوان المجموعة.

  • windowId

    الرقم

    رقم تعريف النافذة التي تحتوي على المجموعة.

الخصائص

TAB_GROUP_ID_NONE

رقم تعريف يمثّل عدم توفّر مجموعة.

القيمة

-1

الطُرق

get()

الوعد 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

تستردّد تفاصيل عن المجموعة المحدّدة.

المعلمات

  • groupId

    الرقم

  • callback

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

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

    (group: TabGroup) => void

المرتجعات

  • Promise<TabGroup>

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

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

move()

الوعد 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

ينقل المجموعة وجميع علامات التبويب الخاصة بها داخل نافذتها أو إلى نافذة جديدة.

المعلمات

  • groupId

    الرقم

    رقم تعريف المجموعة المطلوب نقلها.

  • moveProperties

    عنصر

    • الفهرس

      الرقم

      الموضع الذي تريد نقل المجموعة إليه. استخدِم -1 لوضع المجموعة في نهاية النافذة.

    • windowId

      رقم اختياري

      النافذة التي تريد نقل المجموعة إليها الإعداد التلقائي هو النافذة التي تتضمّن المجموعة حاليًا. يُرجى العِلم أنّه لا يمكن نقل المجموعات إلا من وإلى النوافذ التي تحتوي على نوع windows.WindowType "normal".

  • callback

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

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

    (group?: TabGroup) => void

    • مجموعة

      ‫TabGroup اختياري

      تفاصيل عن المجموعة التي تم نقلها

المرتجعات

  • Promise<TabGroup | undefined>

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

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

query()

الوعد 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

تحصل على جميع المجموعات التي تحتوي على المواقع المحدّدة، أو جميع المجموعات في حال عدم تحديد أي مواقع.

المعلمات

  • queryInfo

    عنصر

    • تم التصغير

      منطقي اختياري

      ما إذا كانت المجموعات مصغّرة

    • اللون

      اللون اختياري

      لون المجموعات

    • تمت المشاركة

      منطقي اختياري

      في انتظار المراجعة

      ما إذا كانت المجموعة مشترَكة

    • title

      سلسلة اختيارية

      مطابقة عناوين المجموعات مع نمط

    • windowId

      رقم اختياري

      رقم تعريف النافذة الرئيسية، أو windows.WINDOW_ID_CURRENT للإشارة إلى النافذة الحالية.

  • callback

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

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

    (result: TabGroup[]) => void

المرتجعات

  • Promise<TabGroup[]>

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

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

update()

الوعد 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

تعديل خصائص مجموعة لا يتم تعديل المواقع التي لم يتم تحديدها في updateProperties.

المعلمات

  • groupId

    الرقم

    رقم تعريف المجموعة المطلوب تعديلها.

  • updateProperties

    عنصر

    • تم التصغير

      منطقي اختياري

      ما إذا كان يجب تصغير المجموعة

    • اللون

      اللون اختياري

      لون المجموعة

    • title

      سلسلة اختيارية

      عنوان المجموعة.

  • callback

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

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

    (group?: TabGroup) => void

    • مجموعة

      ‫TabGroup اختياري

      تفاصيل عن المجموعة المعدّلة

المرتجعات

  • Promise<TabGroup | undefined>

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

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

الفعاليات

onCreated

chrome.tabGroups.onCreated.addListener(
  callback: function,
)

يتمّ تشغيله عند إنشاء مجموعة.

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void

onMoved

chrome.tabGroups.onMoved.addListener(
  callback: function,
)

يتم تشغيله عند نقل مجموعة داخل نافذة. ولا تزال أحداث النقل يتم تشغيلها لعلامات التبويب الفردية داخل المجموعة، بالإضافة إلى المجموعة نفسها. لا يتم تشغيل هذا الحدث عند نقل مجموعة بين النوافذ، بل ستتم إزالتها من نافذة وإنشاءها في نافذة أخرى.

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void

onRemoved

chrome.tabGroups.onRemoved.addListener(
  callback: function,
)

يتم تشغيله عند إغلاق مجموعة، إما من قِبل المستخدم مباشرةً أو تلقائيًا لأنّها لم تحتوي على أي علامات تبويب.

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void

onUpdated

chrome.tabGroups.onUpdated.addListener(
  callback: function,
)

يتم تشغيله عند تعديل مجموعة.

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void