chrome.app.runtime

ब्यौरा

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

टाइप

ActionData

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

प्रॉपर्टी

  • actionType

ActionType

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

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

मान

"new_note"

EmbedRequest

प्रॉपर्टी

  • डेटा

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

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

  • embedderId

    स्ट्रिंग

  • अनुमति देना

    अमान्य

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

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

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

    • url

      स्ट्रिंग

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

    अमान्य

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

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

    () => {...}

LaunchData

प्रॉपर्टी

  • actionData

    ActionData ज़रूरी नहीं

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

    इसमें वह डेटा होता है जिससे पता चलता है कि इस ऐप्लिकेशन को ActionType के साथ लॉन्च किया गया था. अगर ऐप्लिकेशन को किसी खास ऐक्शन इंटेंट के साथ लॉन्च नहीं किया गया था, तो यह वैल्यू शून्य होगी.

  • आईडी

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

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

  • isKioskSession

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

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

  • isPublicSession

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

    Chrome 47+

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

  • आइटम

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

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

  • referrerUrl

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

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

  • source

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

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

  • url

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

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

LaunchItem

प्रॉपर्टी

  • एंट्री

    प्रवेश

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

  • टाइप

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

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

LaunchSource

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

Enum

"untracked"

"app_launcher"

"new_tab_page"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"background"

"chrome_internal"

"test"

"app_home_page"

"focus_mode"

इवेंट

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