chrome.tabGroups

شرح

از chrome.tabGroups API برای تعامل با سیستم گروه بندی برگه های مرورگر استفاده کنید. شما می توانید از این API برای اصلاح و تنظیم مجدد گروه های برگه در مرورگر استفاده کنید. برای گروه‌بندی و حذف گروه‌بندی برگه‌ها، یا پرس و جو از اینکه چه برگه‌هایی در گروه‌ها هستند، از chrome.tabs API استفاده کنید.

مجوزها

tabGroups

دسترسی

Chrome 89+ MV3+

انواع

Color

رنگ گروه

Enum

"خاکستری"

"آبی"

"قرمز"

"رنگ زرد"

"سبز"

"رنگ صورتی"

"رنگ بنفش"

"فیروزه ای"

"نارنجی"

TabGroup

خواص

  • فرو ریخت

    بولی

    این که آیا گروه از بین رفته است. گروه فروپاشیده گروهی است که برگه‌های آن پنهان است.

  • رنگ

    رنگ

    رنگ گروه

  • شناسه

    عدد

    شناسه گروه شناسه های گروه در یک جلسه مرورگر منحصر به فرد هستند.

  • عنوان

    رشته اختیاری

    عنوان گروه.

  • شناسه پنجره

    عدد

    شناسه پنجره حاوی گروه.

خواص

TAB_GROUP_ID_NONE

شناسه ای که نشان دهنده عدم وجود یک گروه است.

ارزش

-1

مواد و روش ها

get()

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

جزئیات مربوط به گروه مشخص شده را بازیابی می کند.

مولفه های

  • شناسه گروه

    عدد

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (group: TabGroup)=>void

برمی گرداند

  • Promise< TabGroup >

    Chrome 90+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

move()

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

گروه و تمام برگه های آن را در پنجره خود یا به پنجره جدید منتقل می کند.

مولفه های

  • شناسه گروه

    عدد

    شناسه گروه برای جابجایی

  • moveProperties

    هدف - شی

    • فهرست مطالب

      عدد

      موقعیتی که باید گروه را به آن جابجا کرد. برای قرار دادن گروه در انتهای پنجره -1 استفاده کنید.

    • شناسه پنجره

      شماره اختیاری

      پنجره انتقال گروه به. پیش‌فرض پنجره‌ای است که گروه در حال حاضر در آن قرار دارد. توجه داشته باشید که گروه‌ها را فقط می‌توان به و از پنجره‌های دارای ویندوز منتقل کرد windows.WindowType "normal" .

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (group?: TabGroup)=>void

    • گروه

      TabGroup اختیاری است

      جزئیات درباره گروه منتقل شده

برمی گرداند

  • Promise< TabGroup |undefined>

    Chrome 90+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

query()

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

تمام گروه‌هایی را که دارای ویژگی‌های مشخص شده‌اند، یا همه گروه‌ها را در صورتی که هیچ خاصیتی مشخص نشده است، دریافت می‌کند.

مولفه های

  • queryInfo

    هدف - شی

    • فرو ریخت

      بولی اختیاری

      این که آیا گروه ها فرو می ریزند.

    • رنگ

      رنگ اختیاری

      رنگ گروه ها

    • عنوان

      رشته اختیاری

      عناوین گروه را با یک الگو مطابقت دهید.

    • شناسه پنجره

      شماره اختیاری

      شناسه پنجره والد یا windows.WINDOW_ID_CURRENT برای پنجره فعلی .

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (result: TabGroup[])=>void

برمی گرداند

  • Promise< TabGroup []>

    Chrome 90+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

update()

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

ویژگی های یک گروه را اصلاح می کند. ویژگی هایی که در updateProperties مشخص نشده اند، اصلاح نمی شوند.

مولفه های

  • شناسه گروه

    عدد

    شناسه گروه برای تغییر.

  • updateProperties

    هدف - شی

    • فرو ریخت

      بولی اختیاری

      این که آیا گروه باید فروپاشی شود یا خیر.

    • رنگ

      رنگ اختیاری

      رنگ گروه.

    • عنوان

      رشته اختیاری

      عنوان گروه.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (group?: TabGroup)=>void

    • گروه

      TabGroup اختیاری است

      جزئیات درباره گروه به روز شده

برمی گرداند

  • Promise< TabGroup |undefined>

    Chrome 90+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.

مناسبت ها

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