chrome.management

ब्यौरा

chrome.management एपीआई, इंस्टॉल और इस्तेमाल किए जा रहे एक्सटेंशन/ऐप्लिकेशन की सूची को मैनेज करने के तरीके उपलब्ध कराता है. यह उन एक्सटेंशन के लिए खास तौर पर काम का होता है जो पहले से मौजूद 'नया टैब' पेज को ओवरराइड करते हैं.

अनुमतियां

management

मेनिफ़ेस्ट

management API का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "मैनेजमेंट" अनुमति के बारे में एलान करना होगा. उदाहरण के लिए:

{
  "name": "My extension",
  ...
  "permissions": [
    "management"
  ],
  ...
}

management.getPermissionWarningsByManifest, management.uninstallSelf, और management.getSelf को मैनेजमेंट की अनुमति की ज़रूरत नहीं है.

टाइप

ExtensionDisabledReason

Chrome 44 और इसके बाद के वर्शन

आइटम के बंद होने की वजह.

Enum

ExtensionInfo

इंस्टॉल किए गए एक्सटेंशन, ऐप्लिकेशन या थीम की जानकारी.

प्रॉपर्टी

  • appLaunchUrl

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

    लॉन्च यूआरएल (सिर्फ़ ऐप्लिकेशन के लिए मौजूद होता है).

  • availableLaunchTypes

    LaunchType[] ज़रूरी नहीं

    फ़िलहाल, ये लॉन्च के टाइप (सिर्फ़ ऐप्लिकेशन के लिए मौजूद हैं).

  • ब्यौरा

    स्ट्रिंग

    इस एक्सटेंशन, ऐप्लिकेशन या थीम का ब्यौरा.

  • disabledReason

    ExtensionDisabledReason ज़रूरी नहीं

    आइटम के बंद होने की वजह.

  • चालू किया गया

    boolean

    फ़िलहाल, यह चालू है या बंद है.

  • homepageUrl

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

    इस एक्सटेंशन, ऐप्लिकेशन या थीम के होम पेज का यूआरएल.

  • hostPermissions

    स्ट्रिंग[]

    यह फ़ंक्शन, होस्ट के हिसाब से अनुमतियों की सूची दिखाता है.

  • आइकन

    IconInfo[] ज़रूरी नहीं है

    आइकॉन की जानकारी की सूची. ध्यान दें कि यह सिर्फ़ मेनिफ़ेस्ट में किए गए एलान को दिखाता है. इस यूआरएल पर मौजूद असल इमेज, तय की गई इमेज से बड़ी या छोटी हो सकती है. इसलिए, आप इन इमेज के लिए img टैग पर चौड़ाई और ऊंचाई वाले एट्रिब्यूट का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, आइकॉन पर मेनिफ़ेस्ट का दस्तावेज़ देखें.

  • id

    स्ट्रिंग

    एक्सटेंशन का यूनीक आइडेंटिफ़ायर.

  • installType

    ExtensionInstallType

    एक्सटेंशन को इंस्टॉल करने का तरीका.

  • isApp

    boolean

    अब सेवा में नहीं है

    कृपया management.ExtensionInfo.type का इस्तेमाल करें.

    अगर यह ऐप्लिकेशन है, तो 'सही है' पर सेट करें.

  • launchType

    LaunchType ज़रूरी नहीं

    ऐप्लिकेशन को लॉन्च करने का टाइप (सिर्फ़ ऐप्लिकेशन के लिए मौजूद है).

  • mayDisable

    boolean

    क्या उपयोगकर्ता इस एक्सटेंशन को बंद कर सकता है या अनइंस्टॉल कर सकता है.

  • mayEnable

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

    Chrome 62 और इसके बाद के वर्शन

    यह एक्सटेंशन, उपयोगकर्ता के पास चालू किया जा सकता है या नहीं. यह सिर्फ़ उन एक्सटेंशन के लिए दिखता है जो चालू नहीं हैं.

  • नाम

    स्ट्रिंग

    इस एक्सटेंशन, ऐप्लिकेशन या थीम का नाम.

  • offlineEnabled

    boolean

    क्या एक्सटेंशन, ऐप्लिकेशन या थीम यह एलान करती है कि वह ऑफ़लाइन काम करता है.

  • optionsUrl

    स्ट्रिंग

    अगर आइटम के विकल्प पेज का यूआरएल हो, तो उसका यूआरएल.

  • अनुमतियां

    स्ट्रिंग[]

    एपीआई के आधार पर अनुमतियों की सूची दिखाता है.

  • shortName

    स्ट्रिंग

    इस एक्सटेंशन, ऐप्लिकेशन या थीम के नाम का छोटा वर्शन.

  • टाइप

    ExtensionType

    इस एक्सटेंशन, ऐप्लिकेशन या थीम का टाइप.

  • updateUrl

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

    इस एक्सटेंशन, ऐप्लिकेशन या थीम का अपडेट यूआरएल.

  • वर्शन

    स्ट्रिंग

    इस एक्सटेंशन, ऐप्लिकेशन या थीम का वर्शन.

  • versionName

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

    Chrome 50 और इसके बाद के वर्शन

    इस एक्सटेंशन, ऐप्लिकेशन या थीम का वर्शन नाम, अगर मेनिफ़ेस्ट में बताया गया हो.

ExtensionInstallType

Chrome 44 और इसके बाद के वर्शन

एक्सटेंशन को इंस्टॉल करने का तरीका. admin में से एक: एडमिन नीति की वजह से एक्सटेंशन इंस्टॉल किया गया था, development: एक्सटेंशन को डेवलपर मोड में अनपैक किया गया था, normal: एक्सटेंशन को सामान्य रूप से .crx फ़ाइल के ज़रिए इंस्टॉल किया गया था, sideload: मशीन पर किसी दूसरे सॉफ़्टवेयर से एक्सटेंशन इंस्टॉल किया गया था, other: एक्सटेंशन को दूसरे तरीकों से इंस्टॉल किया गया था.

Enum

ExtensionType

Chrome 44 और इसके बाद के वर्शन

इस एक्सटेंशन, ऐप्लिकेशन या थीम का टाइप.

Enum

"packaged_app"

"login_screen_extension"

IconInfo

किसी एक्सटेंशन, ऐप्लिकेशन या थीम से जुड़े आइकॉन के बारे में जानकारी.

प्रॉपर्टी

  • साइज़

    नंबर

    आइकॉन की चौड़ाई और ऊंचाई को दिखाने वाली संख्या. ऐसी वैल्यू में 128, 48, 24, और 16 शामिल हो सकते हैं. हालांकि, इनमें और भी वैल्यू शामिल हो सकती हैं.

  • यूआरएल

    स्ट्रिंग

    इस आइकॉन इमेज का यूआरएल. आइकॉन का ग्रेस्केल वर्शन दिखाने के लिए, यूआरएल में ?grayscale=true जोड़ें. उदाहरण के लिए, किसी एक्सटेंशन के बंद होने का पता लगाने के लिए.

LaunchType

ऐप्लिकेशन लॉन्च करने के सभी संभावित तरीके ये हैं.

Enum

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88+

एक्सटेंशन को अनइंस्टॉल करने की प्रक्रिया को मैनेज करने के विकल्प.

प्रॉपर्टी

  • showConfirmDialog

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

    अनइंस्टॉल करने की पुष्टि करने वाला डायलॉग उपयोगकर्ता को बताया जाना चाहिए या नहीं, यह पता चलना चाहिए. खुद से अनइंस्टॉल करने के लिए, डिफ़ॉल्ट तौर पर 'गलत' पर सेट होता है. अगर कोई एक्सटेंशन किसी दूसरे एक्सटेंशन को अनइंस्टॉल करता है, तो इस पैरामीटर को अनदेखा कर दिया जाता है. साथ ही, डायलॉग हमेशा दिखाया जाता है.

तरीके

createAppShortcut()

वादा 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

किसी ऐप्लिकेशन के शॉर्टकट बनाने के लिए, विकल्प दिखाएं. Mac पर, सिर्फ़ पैकेज ऐप्लिकेशन शॉर्टकट बनाए जा सकते हैं.

पैरामीटर

  • id

    स्ट्रिंग

    यह management.ExtensionInfo के किसी ऐप्लिकेशन आइटम का आईडी होना चाहिए.

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

वादा 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

यूआरएल के लिए ऐप्लिकेशन जनरेट करें. जनरेट किया गया बुकमार्क ऐप्लिकेशन दिखाता है.

पैरामीटर

  • यूआरएल

    स्ट्रिंग

    किसी वेब पेज का यूआरएल. यूआरएल की स्कीम सिर्फ़ "http" या "https" हो सकती है.

  • title

    स्ट्रिंग

    जनरेट किए गए ऐप्लिकेशन का टाइटल.

  • कॉलबैक

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

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

    (result: ExtensionInfo)=>void

रिटर्न

  • Promise<ExtensionInfo>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

get()

वादा 
chrome.management.get(
  id: string,
  callback?: function,
)

इंस्टॉल किए गए उस एक्सटेंशन, ऐप्लिकेशन या थीम के बारे में जानकारी दिखाता है जिसका आईडी दिया गया है.

पैरामीटर

  • id

    स्ट्रिंग

    management.ExtensionInfo के किसी आइटम का आईडी.

  • कॉलबैक

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

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

    (result: ExtensionInfo)=>void

रिटर्न

  • Promise<ExtensionInfo>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

getAll()

वादा 
chrome.management.getAll(
  callback?: function,
)

इंस्टॉल किए गए एक्सटेंशन और ऐप्लिकेशन की जानकारी की सूची दिखाता है.

पैरामीटर

  • कॉलबैक

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

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

    (result: ExtensionInfo[])=>void

रिटर्न

  • Promise<ExtensionInfo[]>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

getPermissionWarningsById()

वादा 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

किसी एक्सटेंशन आईडी के लिए, अनुमति से जुड़ी चेतावनियों की सूची दिखाता है.

पैरामीटर

  • id

    स्ट्रिंग

    पहले से इंस्टॉल किए गए किसी एक्सटेंशन का आईडी.

  • कॉलबैक

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

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

    (permissionWarnings: string[])=>void

    • permissionWarnings

      स्ट्रिंग[]

रिटर्न

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

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

getPermissionWarningsByManifest()

वादा 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

दी गई एक्सटेंशन मेनिफ़ेस्ट स्ट्रिंग के लिए, अनुमति से जुड़ी चेतावनियों की सूची दिखाता है. ध्यान दें: इस फ़ंक्शन का इस्तेमाल, मेनिफ़ेस्ट में 'मैनेज करने' की अनुमति का अनुरोध किए बिना किया जा सकता है.

पैरामीटर

  • manifestStr

    स्ट्रिंग

    एक्सटेंशन मेनिफ़ेस्ट JSON स्ट्रिंग.

  • कॉलबैक

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

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

    (permissionWarnings: string[])=>void

    • permissionWarnings

      स्ट्रिंग[]

रिटर्न

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

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

getSelf()

वादा 
chrome.management.getSelf(
  callback?: function,
)

कॉल एक्सटेंशन, ऐप्लिकेशन या थीम के बारे में जानकारी दिखाता है. ध्यान दें: इस फ़ंक्शन का इस्तेमाल, मेनिफ़ेस्ट में 'मैनेज करने' की अनुमति का अनुरोध किए बिना किया जा सकता है.

पैरामीटर

  • कॉलबैक

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

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

    (result: ExtensionInfo)=>void

रिटर्न

  • Promise<ExtensionInfo>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

installReplacementWebApp()

प्रॉमिस Chrome 77 और इसके बाद के वर्शन 
chrome.management.installReplacementWebApp(
  callback?: function,
)

मेनिफ़ेस्ट में बताए गए रिप्लेसमेंट_web_app को लॉन्च करता है. अगर पहले से इंस्टॉल नहीं है, तो उपयोगकर्ता को इंस्टॉल करने का निर्देश देता है.

पैरामीटर

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

launchApp()

वादा 
chrome.management.launchApp(
  id: string,
  callback?: function,
)

किसी ऐप्लिकेशन को लॉन्च करता है.

पैरामीटर

  • id

    स्ट्रिंग

    ऐप्लिकेशन का एक्सटेंशन आईडी.

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

setEnabled()

वादा 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
)

किसी ऐप्लिकेशन या एक्सटेंशन को चालू या बंद करता है. ज़्यादातर मामलों में, इस फ़ंक्शन को उपयोगकर्ता के जेस्चर (उदाहरण के लिए, किसी बटन के लिए ऑनक्लिक हैंडलर) के संदर्भ में कॉल किया जाना चाहिए. साथ ही, हो सकता है कि उपयोगकर्ता को गलत इस्तेमाल को रोकने के लिए, पुष्टि करने वाले नेटिव यूज़र इंटरफ़ेस (यूआई) की सुविधा दिखे.

पैरामीटर

  • id

    स्ट्रिंग

    यह management.ExtensionInfo के आइटम का आईडी होना चाहिए.

  • चालू किया गया

    boolean

    यह आइटम चालू होना चाहिए या बंद होना चाहिए.

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

setLaunchType()

वादा 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

ऐप्लिकेशन के लॉन्च का टाइप सेट करें.

पैरामीटर

  • id

    स्ट्रिंग

    यह management.ExtensionInfo के किसी ऐप्लिकेशन आइटम का आईडी होना चाहिए.

  • launchType

    LaunchType

    टारगेट लॉन्च टाइप. हमेशा जांच करें और पक्का करें कि यह लॉन्च टाइप ExtensionInfo.availableLaunchTypes में हो. इसकी वजह यह है कि लॉन्च के उपलब्ध टाइप, अलग-अलग प्लैटफ़ॉर्म और कॉन्फ़िगरेशन के हिसाब से अलग-अलग होते हैं.

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

uninstall()

वादा 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

हाल ही में इंस्टॉल किए गए ऐप्लिकेशन या एक्सटेंशन को अनइंस्टॉल करता है. ध्यान दें: यह फ़ंक्शन मैनेज किए जा रहे एनवायरमेंट में तब काम नहीं करता है, जब उपयोगकर्ता को बताए गए एक्सटेंशन/ऐप्लिकेशन को अनइंस्टॉल करने की अनुमति नहीं होती. अगर अनइंस्टॉल नहीं होता (जैसे, उपयोगकर्ता डायलॉग को रद्द कर देता है), तो प्रॉमिस अस्वीकार कर दिया जाएगा या runtime.lastError सेट के साथ कॉलबैक को कॉल किया जाएगा.

पैरामीटर

  • id

    स्ट्रिंग

    यह management.ExtensionInfo के आइटम का आईडी होना चाहिए.

  • विकल्प

    UninstallOptions ज़रूरी नहीं

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

uninstallSelf()

वादा 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

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

पैरामीटर

  • विकल्प

    UninstallOptions ज़रूरी नहीं

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

    Chrome 88+

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.

इवेंट

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

किसी ऐप्लिकेशन या एक्सटेंशन के बंद होने पर सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (info: ExtensionInfo)=>void

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

किसी ऐप्लिकेशन या एक्सटेंशन के चालू होने पर सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (info: ExtensionInfo)=>void

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

किसी ऐप्लिकेशन या एक्सटेंशन को इंस्टॉल किए जाने पर सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (info: ExtensionInfo)=>void

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

किसी ऐप्लिकेशन या एक्सटेंशन को अनइंस्टॉल किए जाने पर सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (id: string)=>void

    • id

      स्ट्रिंग