chrome.app.runtime

Description

Utilisez l'API chrome.app.runtime pour gérer le cycle de vie de l'application. L'environnement d'exécution de l'application gère l'installation des applications, contrôle la page d'événement et peut arrêter l'application à tout moment.

Types

ActionData

Chrome 54 et versions ultérieures

Propriétés

  • actionType

    "new_note"

ActionType

Chrome 54 et versions ultérieures

Vous pouvez lancer une application en pensant à une action spécifique (par exemple, pour créer une note). Le type d'action avec lequel l'application a été lancée est disponible dans le champ actionData de l'instance LaunchData.

Valeur

"new_note"

EmbedRequest

Propriétés

  • données

    Toute valeur facultatif

    Données facultatives spécifiées par le développeur que l'application à intégrer peut utiliser lorsqu'elle prend une décision d'intégration.

  • embedderId

    chaîne

  • allow

    void

    Permet à embedderId d'intégrer cette appli dans un élément <appview>. url spécifie le contenu à intégrer.

    La fonction allow se présente comme suit : 

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

    • url

      chaîne

  • deny

    void

    Empêche embedderId d'intégrer cette application dans un élément <appview>.

    La fonction deny se présente comme suit : 

    ()=> {...}

LaunchData

Propriétés

  • actionData

    ActionData facultatif

    Chrome 54 et versions ultérieures

    Contient des données qui spécifient la ActionType avec laquelle cette application a été lancée. La valeur est nulle si l'application n'a pas été lancée avec un intent d'action spécifique.

  • id

    string facultatif

    ID du fichier ou du gestionnaire d'URL avec lequel l'application est appelée. Les ID de gestionnaire correspondent aux clés de premier niveau dans les dictionnaires file_handlers et/ou url_handlers du fichier manifeste.

  • isKioskSession

    Booléen facultatif

    Indique si l'application est lancée dans une session kiosque Chrome OS.

  • isPublicSession

    Booléen facultatif

    Chrome 47 ou version ultérieure

    Indique si l'application est lancée dans une session publique Chrome OS.

  • items

    LaunchItem[] facultatif

    Entrées de fichier pour l'événement onLaunched déclenché par un gestionnaire de fichiers correspondant dans la clé du fichier manifeste file_handlers.

  • referrerUrl

    string facultatif

    URL de provenance de l'événement onLaunched déclenché par un gestionnaire d'URL correspondant dans la clé du fichier manifeste url_handlers.

  • source

    LaunchSource facultatif

    Provenance du lancement de l'application.

  • url

    string facultatif

    URL de l'événement onLaunched déclenché par un gestionnaire d'URL correspondant dans la clé du fichier manifeste url_handlers.

LaunchItem

Propriétés

  • entry

    Entrée

    Entrée de l'élément.

  • Type

    string facultatif

    Type MIME du fichier.

LaunchSource

Énumération des sources de lancement d'applications. Il doit être synchronisé avec AppLaunchSource dans composants/services/app_service/public/mojom/types.mojom et avec GetLaunchSourceEnum() dans extensions/browser/api/app_runtime/app_runtime_api.cc. Notez que l'énumération est utilisée dans l'histogramme UMA. Les entrées ne doivent donc pas être réorganisées ni supprimées.

Enum

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

Événements

onEmbedRequested

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

Déclenché lorsqu'une application d'intégration demande l'intégration de cette application. Cet événement n'est disponible que sur la version en développement avec l'indicateur --enable-app-view.

Paramètres

onLaunched

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

Déclenché lorsqu'une application est lancée depuis le lanceur d'applications

Paramètres

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    (launchData?: LaunchData)=>void

onRestarted

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

Déclenché au démarrage de Chrome pour les applications qui étaient en cours d'exécution lorsque Chrome s'est arrêté pour la dernière fois, ou lorsque le redémarrage de l'application à partir de son état précédent a été demandé pour d'autres raisons (par exemple, lorsque l'utilisateur révoque l'accès aux fichiers conservés d'une application, l'exécution redémarre l'application). Dans ce cas, si les applications n'ont pas de gestionnaire onRestarted, elles reçoivent un événement onLaunched à la place.

Paramètres

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    ()=>void