chrome.tabGroups

ब्यौरा

ब्राउज़र के टैब ग्रुपिंग सिस्टम से इंटरैक्ट करने के लिए, chrome.tabGroups एपीआई का इस्तेमाल करें. इस एपीआई का इस्तेमाल करके, ब्राउज़र में टैब ग्रुप में बदलाव किया जा सकता है. साथ ही, उनके क्रम में बदलाव भी किया जा सकता है. टैब को ग्रुप में बांटने और अनग्रुप करने के लिए, chrome.tabs API का इस्तेमाल करें. इसके अलावा, ग्रुप में मौजूद टैब के बारे में क्वेरी करने के लिए भी ऐसा किया जा सकता है.

अनुमतियां

tabGroups

उपलब्धता

Chrome 89 और उसके बाद के वर्शन संगीत वीडियो 3+

टाइप

Color

ग्रुप का रंग.

Enum

"स्लेटी"

"नीला"

"लाल"

"पीला"

"हरा"

"गुलाबी"

"बैंगनी"

"सायन"

"नारंगी"

TabGroup

प्रॉपर्टी

  • छोटा किया गया

    बूलियन

    ग्रुप को छोटा किया गया है या नहीं. छोटा ग्रुप, वह ग्रुप होता है जिसके टैब छिपे रहते हैं.

  • रंग

    रंग

    ग्रुप का रंग.

  • आईडी

    संख्या

    ग्रुप का आईडी. ग्रुप आईडी, ब्राउज़र सेशन में यूनीक होते हैं.

  • title

    स्ट्रिंग ज़रूरी नहीं

    ग्रुप का नाम.

  • windowId

    संख्या

    उस विंडो का आईडी जिसमें ग्रुप शामिल है.

प्रॉपर्टी

TAB_GROUP_ID_NONE

यह आईडी, किसी ग्रुप का न होने का पता लगाता है.

मान

-1

तरीके

get()

प्रॉमिस 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

चुने गए ग्रुप के बारे में जानकारी हासिल करता है.

पैरामीटर

  • groupId

    संख्या

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है: 

    (group: TabGroup) => void

रिटर्न

  • प्रॉमिस<TabGroup>

    Chrome 90 और उसके बाद के वर्शन

    मेनिफ़ेस्ट 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 और उसके बाद के वर्शन

    मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

query()

प्रॉमिस 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

जिन ग्रुप में तय की गई प्रॉपर्टी हैं उन सभी को शामिल करता है. अगर कोई प्रॉपर्टी नहीं दी गई है, तो सभी ग्रुप पर लागू होता है.

पैरामीटर

  • queryInfo

    ऑब्जेक्ट

    • छोटा किया गया

      बूलियन ज़रूरी नहीं

      ग्रुप छोटे किए गए हैं या नहीं.

    • रंग

      रंग ज़रूरी नहीं

      ग्रुप का रंग.

    • title

      स्ट्रिंग ज़रूरी नहीं

      किसी पैटर्न के हिसाब से ग्रुप के टाइटल का मिलान करें.

    • windowId

      नंबर वैकल्पिक

      पैरंट विंडो का आईडी या मौजूदा विंडो के लिए, windows.WINDOW_ID_CURRENT.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है: 

    (result: TabGroup[]) => void

रिटर्न

  • प्रॉमिस<TabGroup[]>

    Chrome 90 और उसके बाद के वर्शन

    मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

update()

प्रॉमिस 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

किसी ग्रुप की प्रॉपर्टी में बदलाव करता है. जिन प्रॉपर्टी की जानकारी updateProperties में नहीं दी गई है उनमें बदलाव नहीं किया गया है.

पैरामीटर

  • groupId

    संख्या

    बदलाव करने के लिए ग्रुप का आईडी.

  • updateProperties

    ऑब्जेक्ट

    • छोटा किया गया

      बूलियन ज़रूरी नहीं

      ग्रुप को छोटा करना है या नहीं.

    • रंग

      रंग ज़रूरी नहीं

      ग्रुप का रंग.

    • title

      स्ट्रिंग ज़रूरी नहीं

      ग्रुप का शीर्षक.

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

    callback पैरामीटर ऐसा दिखता है: 

    (group?: TabGroup) => void

    • समूह

      TabGroup ज़रूरी नहीं

      अपडेट किए गए ग्रुप के बारे में जानकारी.

रिटर्न

  • वादा<TabGroup | तय नहीं है>

    Chrome 90 और उसके बाद के वर्शन

    मेनिफ़ेस्ट 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