browser.management

ब्यौरा

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

अनुमतियां

management

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

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

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

टाइप

ExtensionDisabledReason

Chrome 44+ browser.* Chrome 148 के बाद से

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

Enum

"unknown"

"permissions_increase"

ExtensionInfo

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

प्रॉपर्टी

• appLaunchUrl

  string ज़रूरी नहीं

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

• availableLaunchTypes

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

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

• ब्यौरा

  स्ट्रिंग

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

• disabledReason

  ExtensionDisabledReason ज़रूरी नहीं

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

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

  बूलियन

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

• homepageUrl

  string ज़रूरी नहीं

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

• hostPermissions

  string[]

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

• आइकॉन

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

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

• आईडी

  स्ट्रिंग

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

• installType

  ExtensionInstallType

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

• isApp

  बूलियन

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

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

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

• launchType

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

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

• mayDisable

  बूलियन

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

• mayEnable

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

  Chrome 62+ browser.* Chrome 148 से

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

• नाम

  स्ट्रिंग

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

• offlineEnabled

  बूलियन

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

• optionsUrl

  स्ट्रिंग

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

• अनुमतियां

  string[]

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

• shortName

  स्ट्रिंग

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

• टाइप

  ExtensionType

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

• updateUrl

  string ज़रूरी नहीं

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

• वर्शन

  स्ट्रिंग

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

• versionName

  string ज़रूरी नहीं

  Chrome 50+ browser.*, Chrome 148 से

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

ExtensionInstallType

Chrome 44+ browser.* Chrome 148 के बाद से

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

Enum

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

Chrome 44+ browser.* Chrome 148 के बाद से

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

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+ browser.* Chrome 148 से

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

प्रॉपर्टी

• showConfirmDialog

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

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

तरीके

createAppShortcut()

browser.management.createAppShortcut(
  id: string,
): Promise<void>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

generateAppForLink()

browser.management.generateAppForLink(
  url: string,
  title: string,
): Promise<ExtensionInfo>

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

पैरामीटर

• url

  स्ट्रिंग

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

• title

  स्ट्रिंग

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

रिटर्न

• Promise<ExtensionInfo>

  Chrome 88+ browser.* Chrome 148 से

get()

browser.management.get(
  id: string,
): Promise<ExtensionInfo>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

रिटर्न

• Promise<ExtensionInfo>

  Chrome 88+ browser.* Chrome 148 से

getAll()

browser.management.getAll(): Promise<ExtensionInfo[]>

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

रिटर्न

• Promise<ExtensionInfo[]>

  Chrome 88+ browser.* Chrome 148 से

getPermissionWarningsById()

browser.management.getPermissionWarningsById(
  id: string,
): Promise<string[]>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

रिटर्न

• Promise<string[]>

  Chrome 88+ browser.* Chrome 148 से

getPermissionWarningsByManifest()

browser.management.getPermissionWarningsByManifest(
  manifestStr: string,
): Promise<string[]>

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

पैरामीटर

• manifestStr

  स्ट्रिंग

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

रिटर्न

• Promise<string[]>

  Chrome 88+ browser.* Chrome 148 से

getSelf()

browser.management.getSelf(): Promise<ExtensionInfo>

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

रिटर्न

• Promise<ExtensionInfo>

  Chrome 88+ browser.* Chrome 148 से

installReplacementWebApp()

Chrome 77+ Chrome 148 से browser.*

browser.management.installReplacementWebApp(): Promise<void>

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

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

launchApp()

browser.management.launchApp(
  id: string,
): Promise<void>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

setEnabled()

browser.management.setEnabled(
  id: string,
  enabled: boolean,
): Promise<void>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

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

  बूलियन

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

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

setLaunchType()

browser.management.setLaunchType(
  id: string,
  launchType: LaunchType,
): Promise<void>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

• launchType

  LaunchType

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

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

uninstall()

browser.management.uninstall(
  id: string,
  options?: UninstallOptions,
): Promise<void>

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

पैरामीटर

• आईडी

  स्ट्रिंग

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

• विकल्प

  UninstallOptions ज़रूरी नहीं

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

uninstallSelf()

browser.management.uninstallSelf(
  options?: UninstallOptions,
): Promise<void>

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

पैरामीटर

• विकल्प

  UninstallOptions ज़रूरी नहीं

रिटर्न

• वादा<शून्य>

  Chrome 88+ browser.* Chrome 148 से

इवेंट

onDisabled

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

यह इवेंट तब ट्रिगर होता है, जब कोई ऐप्लिकेशन या एक्सटेंशन बंद किया जाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (info: ExtensionInfo) => void

  • जानकारी

    ExtensionInfo

onEnabled

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

यह इवेंट तब ट्रिगर होता है, जब कोई ऐप्लिकेशन या एक्सटेंशन चालू किया जाता है.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (info: ExtensionInfo) => void

  • जानकारी

    ExtensionInfo

onInstalled

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (info: ExtensionInfo) => void

  • जानकारी

    ExtensionInfo

onUninstalled

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

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

पैरामीटर

• कॉलबैक

  फ़ंक्शन

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

  (id: string) => void

  • आईडी

    स्ट्रिंग