chrome.management

ब्यौरा

chrome.management एपीआई, इंस्टॉल किए गए ऐप्लिकेशन और एक्सटेंशन को मैनेज करने के तरीके उपलब्ध कराता है.

अनुमतियां

management

मेनिफ़ेस्ट

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

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

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

टाइप

ExtensionDisabledReason

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

इस वजह से आइटम को बंद किया गया है.

Enum

"unknown"

"permissions_increase"

ExtensionInfo

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

प्रॉपर्टी

  • appLaunchUrl

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

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

  • availableLaunchTypes

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

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

  • ब्यौरा

    स्ट्रिंग

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

  • disabledReason

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

    इस वजह से आइटम को बंद किया गया है.

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

    बूलियन

    फ़िलहाल, यह सुविधा चालू है या बंद है.

  • homepageUrl

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

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

  • hostPermissions

    string[]

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

  • आइकॉन

    IconInfo[] optional

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

  • आईडी

    स्ट्रिंग

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

  • installType

    ExtensionInstallType

    एक्सटेंशन कैसे इंस्टॉल किया गया.

  • isApp

    बूलियन

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

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

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

  • launchType

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

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

  • mayDisable

    बूलियन

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

  • mayEnable

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

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

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

  • नाम

    स्ट्रिंग

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

  • offlineEnabled

    बूलियन

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

  • optionsUrl

    स्ट्रिंग

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

  • अनुमतियां

    string[]

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

  • shortName

    स्ट्रिंग

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

  • टाइप

    ExtensionType

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

  • updateUrl

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

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

  • वर्शन

    स्ट्रिंग

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

  • versionName

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

    Chrome 50+

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

ExtensionInstallType

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

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

Enum

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

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

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

Enum

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

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

प्रॉपर्टी

  • साइज़

    संख्या

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

  • url

    स्ट्रिंग

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

LaunchType

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

Enum

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 या इसके बाद का वर्शन

एक्सटेंशन को अनइंस्टॉल करने के तरीके के विकल्प.

प्रॉपर्टी

  • showConfirmDialog

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

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

तरीके

createAppShortcut()

प्रॉमिस 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

    Chrome 88 या इसके बाद का वर्शन

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

प्रॉमिस 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

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

पैरामीटर

  • url

    स्ट्रिंग

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

  • title

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (result: ExtensionInfo) => void

रिटर्न

  • Promise<ExtensionInfo>

    Chrome 88 या इसके बाद का वर्शन

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

get()

प्रॉमिस 
chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (result: ExtensionInfo) => void

रिटर्न

  • Promise<ExtensionInfo>

    Chrome 88 या इसके बाद का वर्शन

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

getAll()

प्रॉमिस 
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

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

पैरामीटर

  • कॉलबैक

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

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

    (result: ExtensionInfo[]) => void

रिटर्न

  • Promise<ExtensionInfo[]>

    Chrome 88 या इसके बाद का वर्शन

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

getPermissionWarningsById()

प्रॉमिस 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

रिटर्न

  • Promise<string[]>

    Chrome 88 या इसके बाद का वर्शन

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

getPermissionWarningsByManifest()

प्रॉमिस 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

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

पैरामीटर

  • manifestStr

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

रिटर्न

  • Promise<string[]>

    Chrome 88 या इसके बाद का वर्शन

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

getSelf()

प्रॉमिस 
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

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

पैरामीटर

  • कॉलबैक

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

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

    (result: ExtensionInfo) => void

रिटर्न

  • Promise<ExtensionInfo>

    Chrome 88 या इसके बाद का वर्शन

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

installReplacementWebApp()

Promise Chrome 77 या इसके बाद के वर्शन 
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

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

पैरामीटर

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

    Chrome 88 या इसके बाद का वर्शन

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

launchApp()

प्रॉमिस 
chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

    Chrome 88 या इसके बाद का वर्शन

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

setEnabled()

प्रॉमिस 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

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

    बूलियन

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

    Chrome 88 या इसके बाद का वर्शन

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

setLaunchType()

प्रॉमिस 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • launchType

    LaunchType

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

    Chrome 88 या इसके बाद का वर्शन

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

uninstall()

प्रॉमिस 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • विकल्प

    UninstallOptions optional

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

    Chrome 88 या इसके बाद का वर्शन

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

uninstallSelf()

प्रॉमिस 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

पैरामीटर

  • विकल्प

    UninstallOptions optional

  • कॉलबैक

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

    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

    • आईडी

      स्ट्रिंग