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 de l'événement et peut arrêter l'application à tout moment.

Types

ActionData

Chrome (version 54 ou ultérieure)

Propriétés

  • actionType

    "new_note"

ActionType

Chrome 54 ou version ultérieure

Une application peut être lancée en vue d'une action spécifique, par exemple pour créer une note. Le type d'action avec laquelle l'application a été lancée est disponible dans le champ actionData de l'instance LaunchData.

Valeur

EmbedRequest

Propriétés

  • données

    tout facultatif

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

  • embedderId

    chaîne

  • allow

    vide

    Autorise embedderId à intégrer cette application dans une <appview> . url spécifie le contenu à intégrer.

    La fonction allow se présente comme suit: 

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

    • url

      chaîne

  • deny

    vide

    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 (version 54 ou ultérieure)

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

  • id

    chaîne facultatif

    ID du gestionnaire de fichier ou d'URL avec lequel l'application est appelée. Les ID de gestionnaire sont les clés de premier niveau des 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 (version 47 ou ultérieure)

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

  • éléments

    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

    chaîne facultatif

    URL du référent pour l'événement onLaunched déclenché par un gestionnaire d'URL correspondant dans la clé manifeste url_handlers.

  • source

    LaunchSource facultatif

    Il s'agit de l'endroit depuis lequel l'application est lancée.

  • url

    chaîne 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

    Enregistrement de l'article.

  • type

    chaîne facultatif

    Type MIME du fichier.

LaunchSource

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

Énumération

"untracked"

"restart"

"command_line"

"about_page"

"management_api"

"ephemeral_app"

"chrome_internal"

"installed_notification"

"app_home_page"

"focus_mode"

"sparky"

Événements

onEmbedRequested

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

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

Paramètres

  • rappel

    fonction

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

    (request: EmbedRequest) => void

onLaunched

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

Déclenché lorsqu'une application est lancée à partir du lanceur d'applications.

Paramètres

  • rappel

    fonction

    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 en cours d'exécution lors de la dernière fermeture de Chrome, ou lorsque des applications ont été invitées à redémarrer depuis leur état précédent pour d'autres raisons (par exemple, lorsque l'utilisateur révoque l'accès aux fichiers conservés d'une application, l'environnement d'exécution redémarre l'application). Dans ces situations, si les applications ne disposent pas d'un gestionnaire onRestarted, un événement onLaunched leur est envoyé à la place.

Paramètres

  • rappel

    fonction

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

    () => void