chrome.app.runtime

ब्यौरा

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

टाइप

ActionData

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

प्रॉपर्टी

  • actionType

    "new_note"

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[] ज़रूरी नहीं

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

  • 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

"ट्रैक नहीं किया गया"

&quot;app_launcher&quot;

"new_tab_page"

"फिर से लोड करें"

"फिर से शुरू करें"

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

"url_handler"

"system_tray"

"about_page"

"कीबोर्ड"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

"बैकग्राउंड"

"किओस्क"

"chrome_internal"

"test"

&quot;installed_notification&quot;

&quot;context_menu&quot;

"आर्क"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;

"स्पार्की"

इवेंट

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