chrome.app.runtime

ब्यौरा

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

टाइप

EmbedRequest

प्रॉपर्टी

  • डेटा

    कोई भी ज़रूरी नहीं है

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

  • embedderId

    स्ट्रिंग

  • अनुमति देना

    अमान्य

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

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

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

    • url

      स्ट्रिंग

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

    अमान्य

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

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

    () => {...}

LaunchData

प्रॉपर्टी

  • आईडी

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

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

  • isKioskSession

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

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

  • isPublicSession

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

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

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

  • आइटम

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

    file_handlers मेनिफ़ेस्ट बटन में मौजूद मैच करने वाले फ़ाइल हैंडलर से ट्रिगर किए गए onLaunched इवेंट की फ़ाइल एंट्री.

  • referrerUrl

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

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

  • source

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

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

  • url

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

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

LaunchItem

प्रॉपर्टी

  • एंट्री

    प्रवेश

    आइटम की एंट्री.

  • टाइप

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

    फ़ाइल का MIME टाइप.

LaunchSource

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

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,
)

जब कोई ऐप्लिकेशन, इस ऐप्लिकेशन को एम्बेड करने का अनुरोध करता है, तब यह इवेंट ट्रिगर होता है. यह इवेंट सिर्फ़ --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