chrome.app.runtime

ब्यौरा

ऐप्लिकेशन की लाइफ़साइकल को मैनेज करने के लिए, chrome.app.runtime एपीआई का इस्तेमाल करें. ऐप्लिकेशन रनटाइम, ऐप्लिकेशन इंस्टॉल करने की प्रोसेस को मैनेज करता है. साथ ही, इवेंट पेज को कंट्रोल करता है और ऐप्लिकेशन को कभी भी बंद कर सकता है.

टाइप

EmbedRequest

प्रॉपर्टी

  • डेटा

    ज़रूरी नहीं

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

  • embedderId

    स्ट्रिंग

  • अनुमति देना

    void

    embedderId को इस ऐप्लिकेशन को <appview> एलिमेंट में एम्बेड करने की अनुमति देता है. url से पता चलता है कि कौनसा कॉन्टेंट एम्बेड करना है.

    allow फ़ंक्शन इस तरह दिखता है: 

    (url: string) => {...}

    • url

      स्ट्रिंग

  • अस्वीकार करें

    void

    embedderId को इस ऐप्लिकेशन को <appview> एलिमेंट में एम्बेड करने से रोकता है.

    deny फ़ंक्शन इस तरह दिखता है: 

    () => {...}

LaunchData

प्रॉपर्टी

  • आईडी

    string ज़रूरी नहीं

    उस फ़ाइल या यूआरएल हैंडलर का आईडी जिससे ऐप्लिकेशन को शुरू किया जा रहा है. हैंडलर आईडी, मेनिफ़ेस्ट में file_handlers और/या url_handlers डिक्शनरी में टॉप-लेवल की कुंजियां होती हैं.

  • isKioskSession

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

    ऐप्लिकेशन को ChromeOS कीऑस्क सेशन में लॉन्च किया जा रहा है या नहीं.

  • isPublicSession

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

    Chrome 47+

    ऐप्लिकेशन को Chrome OS के सार्वजनिक सेशन में लॉन्च किया जा रहा है या नहीं.

  • आइटम

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

    file_handlers मेनिफ़ेस्ट कुंजी में, मैच होने वाले फ़ाइल हैंडलर से ट्रिगर किए गए onLaunched इवेंट के लिए फ़ाइल एंट्री.

  • referrerUrl

    string ज़रूरी नहीं

    url_handlers मेनिफ़ेस्ट कुंजी में, मैच होने वाले यूआरएल हैंडलर से ट्रिगर हुए onLaunched इवेंट के लिए रेफ़रल यूआरएल.

  • सोर्स

    LaunchSource ज़रूरी नहीं

    ऐप्लिकेशन को कहां से लॉन्च किया गया है.

  • url

    string ज़रूरी नहीं

    onLaunched इवेंट का यूआरएल, url_handlers मेनिफ़ेस्ट कुंजी में मौजूद यूआरएल हैंडलर से ट्रिगर होता है.

LaunchItem

प्रॉपर्टी

  • एंट्री

    प्रवेश

    आइटम के लिए एंट्री.

  • टाइप

    string ज़रूरी नहीं

    फ़ाइल का एमआईएमई टाइप.

LaunchSource

ऐप्लिकेशन लॉन्च करने के सोर्स की सूची. इसे components/services/app_service/public/mojom/types.mojom में AppLaunchSource और extensions/browser/api/app_runtime/app_runtime_api.cc में GetLaunchSourceEnum() के साथ सिंक करके रखा जाना चाहिए. ध्यान दें कि एन्यूमरेशन का इस्तेमाल, यूएमए हिस्टोग्राम में किया जाता है. इसलिए, एंट्री का क्रम नहीं बदला जाना चाहिए या उन्हें हटाया नहीं जाना चाहिए.

Enum

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

"sparky"

इवेंट

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब कोई ऐप्लिकेशन इस ऐप्लिकेशन को एम्बेड करने का अनुरोध करता है. यह इवेंट सिर्फ़ dev चैनल पर उपलब्ध होता है. इसके लिए, --enable-app-view फ़्लैग का इस्तेमाल करना ज़रूरी है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (request: EmbedRequest) => void

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (launchData?: LaunchData) => void

    • launchData

      LaunchData ज़रूरी नहीं

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

यह इवेंट, Chrome के स्टार्टअप पर उन ऐप्लिकेशन के लिए ट्रिगर होता है जो Chrome के पिछली बार बंद होने के समय चल रहे थे.इसके अलावा, यह तब ट्रिगर होता है, जब ऐप्लिकेशन को अन्य वजहों से उनकी पिछली स्थिति से रीस्टार्ट करने का अनुरोध किया गया हो. उदाहरण के लिए, जब उपयोगकर्ता किसी ऐप्लिकेशन की सेव की गई फ़ाइलों का ऐक्सेस वापस ले लेता है, तो रनटाइम ऐप्लिकेशन को रीस्टार्ट कर देगा. ऐसी स्थितियों में, अगर ऐप्लिकेशन में onRestarted हैंडलर नहीं है, तो उन्हें onLaunched इवेंट भेजा जाएगा.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void