chrome.tabGroups

الوصف

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

الأذونات

tabGroups

مدى التوفّر

الإصدار 89 من Chrome أو إصدار أحدث الإصدار 3 من Manifest V أو إصدار أحدث

الأنواع

Color

لون المجموعة

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

الخصائص

  • تم التصغير

    قيمة منطقية

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

  • اللون

    اللون

    لون المجموعة

  • id

    الرقم

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

  • مشترَكة

    قيمة منطقية

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

    تُستخدَم لتحديد ما إذا كانت المجموعة مشترَكة.

  • title

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

    تمثّل هذه السمة عنوان المجموعة.

  • windowId

    الرقم

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

الخصائص

TAB_GROUP_ID_NONE

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

القيمة

-1

الطُرق

get()

chrome.tabGroups.get(
  groupId: number,
): Promise<TabGroup>

تسترد هذه الطريقة تفاصيل حول المجموعة المحدّدة.

المعلمات

  • groupId

    الرقم

المرتجعات

  • Promise<TabGroup>

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

move()

chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
): Promise<TabGroup | undefined>

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

المعلمات

  • groupId

    الرقم

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

  • moveProperties

    عنصر

    • الفهرس

      الرقم

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

    • windowId

      number اختياري

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

المرتجعات

  • Promise<TabGroup | undefined>

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

query()

chrome.tabGroups.query(
  queryInfo: object,
): Promise<TabGroup[]>

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

المعلمات

  • queryInfo

    عنصر

    • تم التصغير

      boolean اختياري

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

    • اللون

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

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

    • مشترَكة

      boolean اختياري

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

      تُستخدَم لتحديد ما إذا كانت المجموعة مشترَكة.

    • title

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

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

    • windowId

      number اختياري

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

المرتجعات

  • Promise<TabGroup[]>

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

update()

chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
): Promise<TabGroup | undefined>

تعدّل هذه الطريقة خصائص مجموعة. لا يتم تعديل الخصائص غير المحدّدة في updateProperties.

المعلمات

  • groupId

    الرقم

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

  • updateProperties

    عنصر

    • تم التصغير

      boolean اختياري

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

    • اللون

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

      لون المجموعة

    • title

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

      تمثّل هذه السمة عنوان المجموعة.

المرتجعات

  • Promise<TabGroup | undefined>

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

الفعاليات

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