browser.tabGroups

الوصف

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

الأذونات

tabGroups

مدى التوفّر

الإصدار 89 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome الإصدار 3 من MV والإصدارات الأحدث

الأنواع

Color

لون المجموعة

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

الخصائص

  • تم التصغير

    قيمة منطقية

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

  • اللون

    Color

    لون المجموعة

  • id

    الرقم

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

  • مشترَكة

    قيمة منطقية

    الإصدار 137 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

  • title

    string اختياري

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

  • windowId

    الرقم

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

الخصائص

TAB_GROUP_ID_NONE

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

القيمة

-1

الطُرق

get()

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

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

المعلمات

  • groupId

    الرقم

المرتجعات

  • Promise<TabGroup>

    الإصدار 90 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

move()

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

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

المعلمات

  • groupId

    الرقم

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

  • moveProperties

    عنصر

    • الفهرس

      الرقم

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

    • windowId

      number اختيارية

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

المرتجعات

  • Promise<TabGroup | undefined>

    الإصدار 90 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

query()

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

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

المعلمات

  • queryInfo

    عنصر

    • تم التصغير

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

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

    • اللون

      Color اختيارية

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

    • مشترَكة

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

      الإصدار 137 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

    • title

      string اختياري

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

    • windowId

      number اختيارية

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

المرتجعات

  • Promise<TabGroup[]>

    الإصدار 90 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

update()

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

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

المعلمات

  • groupId

    الرقم

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

  • updateProperties

    عنصر

    • تم التصغير

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

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

    • اللون

      Color اختيارية

      لون المجموعة

    • title

      string اختياري

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

المرتجعات

  • Promise<TabGroup | undefined>

    الإصدار 90 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

الفعاليات

onCreated

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

يتم تنشيط هذا الحدث عند إنشاء مجموعة.

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void

onMoved

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

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

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void

onRemoved

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

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

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void

onUpdated

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

يتم تنشيط هذا الحدث عند تعديل مجموعة.

المعلمات

  • callback

    دالة

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

    (group: TabGroup) => void