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 cerrar la app en cualquier momento.

Tipos

ActionData

Chrome 54 y versiones posteriores

Propiedades

  • actionType

    "new_note"

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 dentro del campo actionData de la instancia de LaunchData.

Valor

"new_note"

EmbedRequest

Propiedades

  • datos

    cualquier opcional

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

  • embedderId

    cadena

  • allow

    void

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

    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 el ActionType con el que se inició esta app. Este valor es nulo si la app no se inició con un intent de acción específico.

  • 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 de los diccionarios file_handlers o url_handlers del manifiesto.

  • isKioskSession

    booleano opcional

    Si la aplicación 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.

  • items

    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

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

  • source

    LaunchSource opcional

    Desde dónde se inicia la app

  • url

    cadena opcional

    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

    cadena opcional

    Es el tipo de MIME del archivo.

LaunchSource

Enumeración de las fuentes de inicio de la app. Esto debe mantenerse sincronizado con AppLaunchSource en componentes/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 la UMA, de modo que las entradas no se deben reordenar ni quitar.

Enum

"app_launcher"

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"chrome_internal"

"installed_notification":

"context_menu"

"intent_url"

"app_home_page"

"focus_mode"

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 para apps que se estaban ejecutando cuando Chrome se cerró por última vez o cuando se solicitó reiniciar las apps desde su estado anterior por otras razones (por ejemplo, cuando el usuario revoca el acceso a los archivos retenidos de una app, el tiempo de ejecución reiniciará la app). En estas situaciones, si las apps no tienen un controlador onRestarted, recibirán un evento onLaunched en su lugar.

Parámetros

  • callback

    la función

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

    ()=>void