chrome.app.runtime

Descrição

Use a API chrome.app.runtime para gerenciar o ciclo de vida do app. O ambiente de execução do app gerencia a instalação do app, controla a página de eventos e pode encerrar o app a qualquer momento.

Tipos

EmbedRequest

Propriedades

  • dados

    any optional

    Dados opcionais especificados pelo desenvolvedor que o app a ser incorporado pode usar ao tomar uma decisão de incorporação.

  • embedderId

    string

  • allow

    void

    Permite que embedderId incorpore este app em um elemento <appview>. O url especifica o conteúdo a ser incorporado.

    A função allow é semelhante a: 

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

    • url

      string

  • deny

    void

    Impede que o embedderId incorpore este app em um elemento <appview>.

    A função deny é semelhante a: 

    () => {...}

LaunchData

Propriedades

  • ID

    string opcional

    O ID do gerenciador de arquivos ou URLs com que o app está sendo invocado. Os IDs de gerenciador são as chaves de nível superior nos dicionários file_handlers e/ou url_handlers no manifesto.

  • isKioskSession

    booleano opcional

    Se o app está sendo iniciado em uma sessão de quiosque do ChromeOS.

  • isPublicSession

    booleano opcional

    Chrome 47+

    Se o app está sendo iniciado em uma sessão pública do ChromeOS.

  • itens

    LaunchItem[] opcional

    As entradas de arquivo para o evento onLaunched acionado por um gerenciador de arquivos correspondente na chave de manifesto file_handlers.

  • referrerUrl

    string opcional

    O URL de referência do evento onLaunched acionado por um gerenciador de URL correspondente na chave de manifesto url_handlers.

  • source

    LaunchSource opcional

    De onde o app é iniciado.

  • url

    string opcional

    O URL do evento onLaunched acionado por um gerenciador de URL correspondente na chave de manifesto url_handlers.

LaunchItem

Propriedades

  • entry

    Entrada

    Entrada do item.

  • tipo

    string opcional

    O tipo MIME do arquivo.

LaunchSource

Enumeração de origens de inicialização de apps. Isso precisa ser sincronizado com AppLaunchSource em components/services/app_service/public/mojom/types.mojom e GetLaunchSourceEnum() em extensions/browser/api/app_runtime/app_runtime_api.cc. A enumeração é usada no histograma da UMA, então as entradas não podem ser reordenadas ou removidas.

Enumeração

"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,
)

Disparado quando um app de incorporação solicita a incorporação deste app. Esse evento só está disponível no canal de desenvolvedor com a flag --enable-app-view.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (request: EmbedRequest) => void

onLaunched

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

Disparado quando um app é iniciado no acesso rápido.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (launchData?: LaunchData) => void

onRestarted

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

Disparado na inicialização do Chrome para apps que estavam em execução quando o Chrome foi encerrado pela última vez ou quando os apps foram solicitados a reiniciar do estado anterior por outros motivos (por exemplo, quando o usuário revoga o acesso aos arquivos retidos de um app, o ambiente de execução reinicia o app). Nessas situações, se os apps não tiverem um gerenciador onRestarted, eles vão receber um evento onLaunched.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    () => void