chrome.tabGroups

الوصف

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

الأذونات

tabGroups

مدى توفّر الخدمة

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

الأنواع

Color

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

التعداد

TabGroup

أماكن إقامة

• تم تصغير الصف.

  boolean

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

• اللون

  اللون

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

• id

  الرقم

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

• title

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

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

• windowId

  الرقم

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

أماكن إقامة

TAB_GROUP_ID_NONE

معرّف يمثّل غياب مجموعة.

القيمة

-1

الطُرق

get()

وعد

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

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

المَعلمات

• groupId

  الرقم

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (group: TabGroup)=>void

  • مجموعة

    TabGroup

المرتجعات

• Promise<TabGroup>

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

  تتوفّر الوعود في إصدار 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|غير محدّدة>

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

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

query()

وعد

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

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

المَعلمات

• queryInfo

  كائن

  • تم تصغير الصف.

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

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

  • اللون

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

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

  • title

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

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

  • windowId

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (result: TabGroup[])=>void

  • نتيجة

    TabGroup[]

المرتجعات

• Promise<TabGroup[]>

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

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

update()

وعد

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

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

المَعلمات

• groupId

  الرقم

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

• updateProperties

  كائن

  • تم تصغير الصف.

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

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

  • اللون

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

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

  • title

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (group?: TabGroup)=>void

  • مجموعة

    TabGroup اختيارية

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

المرتجعات

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

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

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