chrome.app.runtime

कंपनी का ब्यौरा

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

टाइप

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 के साथ लॉन्च किया गया था. अगर ऐप्लिकेशन को किसी खास कार्रवाई के मकसद से लॉन्च नहीं किया गया है, तो यह अमान्य होता है.

  • आईडी

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

    उस फ़ाइल या यूआरएल हैंडलर का आईडी जिससे ऐप्लिकेशन शुरू किया जा रहा है. हैंडलर आईडी, मेनिफ़ेस्ट के 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 में, AppLaunchSource के साथ सिंक करके रखा जाना चाहिए. साथ ही, एक्सटेंशन/ब्राउज़र/api/app_runtime/app_runtime_api.cc) में GetlaunchSourceEnum() का इस्तेमाल होना चाहिए. ध्यान दें कि यूएमए हिस्टोग्राम में इन्यूमरेशन का इस्तेमाल किया जाता है, इसलिए एंट्री को फिर से क्रम में नहीं लगाया जाना चाहिए या उन्हें हटाया नहीं जाना चाहिए.

Enum

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"chrome_internal"

"test"

"context_menu"

"intent_url"

"app_home_page"

"focus_mode"

इवेंट

onEmbedRequested

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

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

पैरामीटर

  • कॉलबैक

    function

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

    (request: EmbedRequest) => void

onLaunched

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

लॉन्चर से किसी ऐप्लिकेशन को लॉन्च किए जाने पर ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    function

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

    (launchData?: LaunchData) => void

    • launchData

      LaunchData ज़रूरी नहीं

onRestarted

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

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

पैरामीटर

  • कॉलबैक

    function

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

    () => void