chrome.app.runtime

Descripción

Usa la API de chrome.app.runtime para administrar el ciclo de vida de la app. El entorno de ejecución de la app administra la instalación de la app, controla la página del evento y puede cerrar la app en cualquier momento.

Tipos

ActionData

Chrome 54 y versiones posteriores

Propiedades

  • actionType

ActionType

Chrome 54 y versiones posteriores

Se puede iniciar una app con una acción específica en mente, por ejemplo, para crear una nota nueva. El tipo de acción con la que se inició la app está disponible en el campo actionData de la instancia de LaunchData.

Valor

EmbedRequest

Propiedades

  • datos

    Cualquier opcional

    El desarrollador opcional especificó los datos que la app que se incorporará puede usar cuando tome una decisión sobre la incorporación.

  • embedderId

    string

  • allow

    void

    Permite que embedderId incorpore esta app en una <appview> . El url especifica el contenido que se incorporará.

    La función allow se ve de la siguiente manera: 

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

    • url

      string

  • deny

    void

    Impide que embedderId incorpore esta app en una <appview> .

    La función deny se ve de la siguiente manera: 

    () => {...}

LaunchData

Propiedades

  • actionData

    ActionData opcional

    Chrome 54 y versiones posteriores

    Contiene datos que especifican los ActionType con los que se inició esta app. Es nulo si la app no se inició con un intent de acción específica.

  • id

    cadena opcional

    El ID del archivo o del controlador de URL con el que se invoca la app. Los IDs de controlador son las claves de nivel superior en los diccionarios file_handlers o url_handlers del manifiesto.

  • isKioskSession

    booleano opcional

    Indica si la app se inicia en una sesión de kiosco de ChromeOS.

  • isPublicSession

    booleano opcional

    Chrome 47 y versiones posteriores

    Indica si la app se inicia en una sesión pública de ChromeOS.

  • elementos

    LaunchItem[] opcional

    Las entradas de archivo para el evento onLaunched activado por un controlador de archivos coincidente en la clave de manifiesto file_handlers

  • referrerUrl

    cadena opcional

    La URL de referencia del evento onLaunched activado por un controlador de URL coincidente en la clave de manifiesto url_handlers

  • source

    LaunchSource opcional

    Es el lugar desde el que se inicia la app.

  • url

    cadena opcional

    Es la URL del evento onLaunched activado por un controlador de URL coincidente en la clave de manifiesto url_handlers.

LaunchItem

Propiedades

  • entry.

    Entrada

    Entrada del artículo.

  • tipo

    string opcional

    Es el tipo MIME del archivo.

LaunchSource

Enumeración de las fuentes de inicio de la app. Se debe mantener sincronizado con AppLaunchSource en components/services/app_service/public/mojom/types.mojom y GetLaunchSourceEnum() en extensions/browser/api/app_runtime/app_runtime_api.cc. Ten en cuenta que la enumeración se usa en el histograma de UMA, por lo que las entradas no deben reordenarse ni quitarse.

Enum

"app_launcher"

"new_tab_page"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"ephemeral_app"

"background"

"kiosk"

"context_menu"

"arc"

"app_home_page"

"sparky"

Eventos

onEmbedRequested

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

Se activa cuando una app de incorporación solicita incorporar esta app. Este evento solo está disponible en el canal para desarrolladores con la marca --enable-app-view.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (request: EmbedRequest) => void

onLaunched

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

Se activa cuando se inicia una app desde el selector.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (launchData?: LaunchData) => void

onRestarted

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

Se activa al iniciar Chrome en las aplicaciones que se estaban ejecutando la última vez que se cerró Chrome o cuando se solicita que las aplicaciones se reinicien desde su estado anterior por otros motivos (p.ej., cuando el usuario revoca el acceso a los archivos retenidos de una aplicación, el tiempo de ejecución reiniciará la aplicación). En estas situaciones, si las apps no tienen un controlador onRestarted, se les enviará un evento onLaunched en su lugar.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    () => void