chrome.app.runtime

Descrição

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

Tipos

ActionData

Chrome 54 ou mais recente

Propriedades

  • actionType

ActionType

Chrome 54 ou mais recente

Um app pode ser iniciado com uma ação específica em mente, por exemplo, para criar uma nota. O tipo de ação com que o app foi iniciado está disponível no campo actionData da instância LaunchData.

Valor

EmbedRequest

Propriedades

  • dados

    Qualquer opção opcional

    O desenvolvedor opcional especifica dados que o app a ser incorporado pode usar ao tomar uma decisão de incorporação.

  • embedderId

    string

  • allow

    void

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

    A função allow tem esta aparência: 

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

    • url

      string

  • deny

    void

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

    A função deny tem esta aparência: 

    ()=> {...}

LaunchData

Propriedades

  • actionData

    ActionData opcional

    Chrome 54 ou mais recente

    Contém dados que especificam o ActionType com que o app foi iniciado. Esse valor será nulo se o app não tiver sido iniciado com uma intent de ação específica.

  • id

    string opcional

    O ID do arquivo ou gerenciador de URL 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 do manifesto.

  • isKioskSession

    booleano opcional

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

  • isPublicSession

    booleano opcional

    Chrome 47 ou mais recente

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

  • items

    LaunchItem[] opcional

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

  • referrerUrl

    string opcional

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

  • source

    LaunchSource opcional

    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 para o item.

  • Tipo

    string opcional

    O tipo MIME do arquivo.

LaunchSource

Enumeração de origens de inicialização do app. Ela deve ser mantida em sincronia com o AppLaunchSource em componentes/services/app_service/public/mojom/types.mojom e GetLaunchSourceEnum() em extensions/browser/api/app_runtime/app_runtime_api.cc. A enumeração é usada em um histograma UMA. Portanto, as entradas não devem ser reordenadas ou removidas.

Tipo enumerado

"app_launcher"

"new_tab_page"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"about_page"

"extensions_page"

"management_api"

"chrome_internal"

"context_menu"

"intent_url"

"app_home_page"

"focus_mode"

Eventos

onEmbedRequested

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

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

Parâmetros

onLaunched

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

Disparado quando um app é iniciado da tela de início.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (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 desligado pela última vez ou quando os apps foram solicitados a reiniciar a partir do estado anterior por outros motivos (por exemplo, quando o usuário revoga o acesso a arquivos retidos de um app, o tempo de execução reinicia o app). Nessas situações, se os apps não tiverem um gerenciador onRestarted, eles receberão um evento onLaunched.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    ()=>void