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 de eventos y puede cerrar la app en cualquier momento.

Tipos

EmbedRequest

Propiedades

  • datos

    any optional

    Son datos opcionales especificados por el desarrollador que la app que se incorporará puede usar cuando tome una decisión de incorporación.

  • embedderId

    string

  • allow

    void

    Permite que embedderId incorpore esta app en un elemento <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 un elemento <appview>.

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

    () => {...}

LaunchData

Propiedades

  • id

    string opcional

    Es el ID del controlador de archivos o URLs con el que se invoca la app. Los IDs de controladores 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

    Son las entradas de archivo para el evento onLaunched que activa un controlador de archivos coincidente en la clave de manifiesto file_handlers.

  • referrerUrl

    string opcional

    Es la URL de referencia del evento onLaunched que activa un controlador de URLs coincidente en la clave de manifiesto url_handlers.

  • source

    LaunchSource opcional

    Desde dónde se inicia la app.

  • url

    string opcional

    Es la URL del evento onLaunched que activa un controlador de URLs coincidente en la clave de manifiesto url_handlers.

LaunchItem

Propiedades

  • entry.

    Entrada

    Es la entrada del elemento.

  • tipo

    string opcional

    Es el tipo de MIME del archivo.

LaunchSource

Es la enumeración de las fuentes de inicio de la app. Esto 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 se deben reordenar ni quitar.

Enum

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

"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 cuando se inicia Chrome para las apps que se estaban ejecutando cuando se cerró Chrome por última vez o cuando se solicitó que se reiniciaran las apps desde su estado anterior por otros motivos (p.ej., cuando el usuario revoca el acceso a los archivos retenidos de una app, el entorno de ejecución reiniciará la app). En estas situaciones, si las apps no tienen un controlador de onRestarted, se les enviará un evento onLaunched.

Parámetros

  • callback

    función

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

    () => void