chrome.management

ब्यौरा

chrome.management API की मदद से, इंस्टॉल किए गए ऐप्लिकेशन और एक्सटेंशन को मैनेज किया जा सकता है.

अनुमतियां

management

मेनिफ़ेस्ट

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

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

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

टाइप

ExtensionDisabledReason

Chrome 44 और उसके बाद वाले वर्शन के लिए

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

Enum

"जानकारी नहीं है"

"permissions_increase"

ExtensionInfo

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

प्रॉपर्टी

  • appLaunchUrl

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

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

  • availableLaunchTypes

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

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

  • ब्यौरा

    स्ट्रिंग

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

  • disabledReason

    ExtensionDisabledReason ज़रूरी नहीं

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

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

    बूलियन

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

  • homepageUrl

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

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

  • hostPermissions

    स्ट्रिंग[]

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

  • आइकॉन

    IconInfo[] वैकल्पिक

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

  • आईडी

    स्ट्रिंग

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

  • installType

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

  • isApp

    बूलियन

    अब काम नहीं करता

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

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

  • launchType

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

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

  • mayDisable

    बूलियन

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

  • mayEnable

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

    Chrome 62 और उसके बाद वाले वर्शन के लिए

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

  • नाम

    स्ट्रिंग

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

  • offlineEnabled

    बूलियन

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

  • optionsUrl

    स्ट्रिंग

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

  • अनुमतियां

    स्ट्रिंग[]

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

  • छोटा नाम

    स्ट्रिंग

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

  • टाइप

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

  • updateUrl

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

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

  • वर्शन

    स्ट्रिंग

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

  • versionName

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

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

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

ExtensionInstallType

Chrome 44 और उसके बाद वाले वर्शन के लिए

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

Enum

"एडमिन"

"डेवलपमेंट"

"सामान्य"

"साइडलोड"

"अन्य"

ExtensionType

Chrome 44 और उसके बाद वाले वर्शन के लिए

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

Enum

"एक्सटेंशन"

"Host_app"

"packaged_app"

"legacy_packaged_app"

"थीम"

"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

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

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

तरीके

createAppShortcut()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

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

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

पैरामीटर

  • स्ट्रिंग

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

  • स्ट्रिंग

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

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

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

    (result: ExtensionInfo) => void

रिटर्न

  • Promise&lt;ExtensionInfo&gt;

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

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

get()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (result: ExtensionInfo) => void

रिटर्न

  • Promise&lt;ExtensionInfo&gt;

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

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

getAll()

प्रॉमिस
chrome.management.getAll(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

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

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

    (result: ExtensionInfo[]) => void

रिटर्न

  • Promise&lt;ExtensionInfo[]&gt;

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

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

getPermissionWarningsById()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      स्ट्रिंग[]

रिटर्न

  • Promise&lt;string[]&gt;

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

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

getPermissionWarningsByManifest()

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

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

पैरामीटर

  • manifestStr

    स्ट्रिंग

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

  • कॉलबैक

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

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      स्ट्रिंग[]

रिटर्न

  • Promise&lt;string[]&gt;

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

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

getSelf()

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

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

पैरामीटर

  • कॉलबैक

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

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

    (result: ExtensionInfo) => void

रिटर्न

  • Promise&lt;ExtensionInfo&gt;

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

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

installReplacementWebApp()

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

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

पैरामीटर

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

launchApp()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

setEnabled()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

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

    बूलियन

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

setLaunchType()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • launchType

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

uninstall()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

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

  • विकल्प

    UninstallOptions ज़रूरी नहीं

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

uninstallSelf()

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

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

पैरामीटर

  • विकल्प

    UninstallOptions ज़रूरी नहीं

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<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

    • आईडी

      स्ट्रिंग