chrome.app.runtime

ब्यौरा

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

टाइप

ActionData

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

प्रॉपर्टी

  • actionType

    "new_note"

ActionType

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

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

वैल्यू

"new_note"

EmbedRequest

प्रॉपर्टी

  • डेटा

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

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

  • embedderId

    स्ट्रिंग

  • अनुमति देना

    void

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

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

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

    • यूआरएल

      स्ट्रिंग

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

    void

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

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

    ()=> {...}

LaunchData

प्रॉपर्टी

  • actionData

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

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

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

  • id

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

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

  • isKioskSession

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

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

  • isPublicSession

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

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

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

  • items

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

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

  • referrerUrl

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

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

  • source

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

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

  • यूआरएल

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

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

LaunchItem

प्रॉपर्टी

  • एंट्री

    प्रवेश

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

  • टाइप

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

    फ़ाइल का MIME प्रकार.

LaunchSource

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

Enum

"new_tab_page"

"load_and_launch"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"chrome_internal"

"intent_url"

"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