chrome.tabGroups

ब्यौरा

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

अनुमतियां

tabGroups

उपलब्धता

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

टाइप

Color

ग्रुप का रंग.

Enum

"grey"

"blue"

"red"

"yellow"

"green"

"pink"

"purple"

"cyan"

"orange"

TabGroup

प्रॉपर्टी

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

    बूलियन

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

  • रंग

    रंग

    ग्रुप का रंग.

  • आईडी

    संख्या

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

  • शेयर किया गया

    बूलियन

    मंज़ूरी बाकी है

    ग्रुप शेयर किया गया है या नहीं.

  • title

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

    ग्रुप का टाइटल.

  • windowId

    संख्या

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

प्रॉपर्टी

TAB_GROUP_ID_NONE

वह आईडी जो किसी ग्रुप की मौजूदगी नहीं दिखाता.

मान

-1

तरीके

get()

वादा करना 
chrome.tabGroups.get(
  groupId: number,
  callback?: function,
)

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

पैरामीटर

  • groupId

    संख्या

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (group: TabGroup) => void

रिटर्न

  • Promise<TabGroup>

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

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

move()

वादा करना 
chrome.tabGroups.move(
  groupId: number,
  moveProperties: object,
  callback?: function,
)

ग्रुप और उसके सभी टैब को उसकी विंडो में या नई विंडो में ले जाता है.

पैरामीटर

  • groupId

    संख्या

    जिस ग्रुप को दूसरी जगह ले जाना है उसका आईडी.

  • moveProperties

    ऑब्जेक्ट

    • इंडेक्स

      संख्या

      वह पोज़िशन जहां ग्रुप को ले जाना है. ग्रुप को विंडो के आखिर में ले जाने के लिए, -1 का इस्तेमाल करें.

    • windowId

      number ज़रूरी नहीं

      वह विंडो जिसमें ग्रुप को ले जाना है. यह डिफ़ॉल्ट रूप से उस विंडो पर सेट होता है जिसमें ग्रुप फ़िलहाल मौजूद होता है. ध्यान दें कि ग्रुप को सिर्फ़ windows.WindowType टाइप "normal" वाली विंडो में ले जाया जा सकता है.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (group?: TabGroup) => void

    • समूह

      TabGroup ज़रूरी नहीं

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

रिटर्न

  • Promise<TabGroup | undefined>

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

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

query()

वादा करना 
chrome.tabGroups.query(
  queryInfo: object,
  callback?: function,
)

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

पैरामीटर

  • queryInfo

    ऑब्जेक्ट

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

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

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

    • रंग

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

      ग्रुप का रंग.

    • शेयर किया गया

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

      मंज़ूरी बाकी है

      ग्रुप शेयर किया गया है या नहीं.

    • title

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

      ग्रुप के टाइटल को किसी पैटर्न से मैच करना.

    • windowId

      number ज़रूरी नहीं

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (result: TabGroup[]) => void

रिटर्न

  • Promise<TabGroup[]>

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

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

update()

वादा करना 
chrome.tabGroups.update(
  groupId: number,
  updateProperties: object,
  callback?: function,
)

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

पैरामीटर

  • groupId

    संख्या

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

  • updateProperties

    ऑब्जेक्ट

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

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

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

    • रंग

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

      ग्रुप का रंग.

    • title

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

      ग्रुप का टाइटल.

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (group?: TabGroup) => void

    • समूह

      TabGroup ज़रूरी नहीं

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

रिटर्न

  • Promise<TabGroup | undefined>

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

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

इवेंट

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