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

المرتجعات

• الوعد<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[]

المرتجعات

• الوعد<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

  • مجموعة

    TabGroup

onMoved

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

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

المعلمات

• رد الاتصال

  دالة

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

  (group: TabGroup) => void

  • مجموعة

    TabGroup

onRemoved

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

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

المعلمات

• رد الاتصال

  دالة

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

  (group: TabGroup) => void

  • مجموعة

    TabGroup

onUpdated

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

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

المعلمات

• رد الاتصال

  دالة

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

  (group: TabGroup) => void

  • مجموعة

    TabGroup