chrome.tabGroups

الوصف

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

الأذونات

tabGroups

مدى التوفّر

الإصدار 89 من Chrome أو الإصدارات الأحدث MV3+

الأنواع

Color

لون المجموعة

Enum

"رمادي"

"أزرق"

"أحمر"

"أصفر"

"أخضر"

"وردي"

"أرجواني"

"أزرق"

"برتقالي"

TabGroup

أماكن إقامة

  • تم التصغير

    منطقي

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

  • اللون

    اللون

    لون المجموعة

  • id

    الرقم

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

  • title

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

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

  • windowId

    الرقم

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

أماكن إقامة

TAB_GROUP_ID_NONE

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

القيمة

-1

الطُرق

get()

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

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

المعلمات

  • groupId

    الرقم

  • رد الاتصال

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

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

    (group: TabGroup) => void

المرتجعات

  • الوعد<TabGroup>

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

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

move()

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

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

المعلمات

  • groupId

    الرقم

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

  • moveProperties

    كائن

    • المؤشر

      الرقم

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

    • windowId

      الرقم اختياري

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

  • رد الاتصال

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

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

    (group?: TabGroup) => void

    • مجموعة

      TabGroup اختيارية

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

المرتجعات

  • الوعد<TabGroup | غير محددة>

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

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

query()

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

الحصول على جميع المجموعات التي تحتوي على السمات المحدَّدة، أو كل المجموعات إذا لم يتم تحديد أي خصائص.

المعلمات

  • queryInfo

    كائن

    • تم التصغير

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

      ما إذا كان سيتم تصغير المجموعات.

    • اللون

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

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

    • title

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

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

    • windowId

      الرقم اختياري

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

  • رد الاتصال

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

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

    (result: TabGroup[]) => void

المرتجعات

  • الوعد<TabGroup[]>

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

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

update()

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

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

المعلمات

  • groupId

    الرقم

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

  • updateProperties

    كائن

    • تم التصغير

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

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

    • اللون

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

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

    • title

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

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

  • رد الاتصال

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

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

    (group?: TabGroup) => void

    • مجموعة

      TabGroup اختيارية

      تفاصيل حول المجموعة التي تم تعديلها.

المرتجعات

  • الوعد<TabGroup | غير محددة>

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

    تتوفّر الوعود في الإصدار 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,
)

يتم الإطلاق عند تعديل مجموعة.

المعلمات

  • رد الاتصال

    دالة

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

    (group: TabGroup) => void