chrome.app.runtime

Descripción

Usa la API de chrome.app.runtime para administrar el ciclo de vida de la app. El tiempo de ejecución de la app administra la instalación de la app, controla la página del evento y puede cerrarla 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 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

    cadena

  • allow

    void

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

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

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

    • url

      cadena

  • deny

    void

    Impide que embedderId incorpore esta app en un elemento <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. El valor es nulo si la app no se inició con un intent de acción específico.

  • id

    string opcional

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

  • isKioskSession

    booleano opcional

    Indica si la app se inicia en una sesión de kiosco del Sistema operativo Chrome.

  • isPublicSession

    booleano opcional

    Chrome 47 y versiones posteriores

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

  • items

    LaunchItem[] opcional

    Las entradas de archivo del evento onLaunched activadas por un controlador de archivos coincidente en la clave de manifiesto file_handlers.

  • referrerUrl

    string opcional

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

  • source

    LaunchSource opcional

    El lugar desde el que se inicia la app

  • url

    string 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 elemento.

  • Tipo

    string opcional

    Es el tipo de 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 UMA, por lo que las entradas no se deben reordenar ni quitar.

Enum

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"management_api"

"chrome_internal"

"context_menu"

"intent_url"

"app_home_page"

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

    la 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

    la 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

    la función

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

    () => void