chrome.app.runtime

Descrição

Use a API chrome.app.runtime para gerenciar o ciclo de vida do app. O tempo de execução do aplicativo gerencia a instalação do aplicativo, controla a página de eventos e pode encerrar o aplicativo 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 dentro do campo actionData da instância LaunchData.

Valor

EmbedRequest

Propriedades

  • dados

    Qualquer opcional

    O desenvolvedor opcional especificou dados 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 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 o qual o aplicativo está sendo invocado. Os IDs do 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 aplicativo está sendo iniciado em uma sessão de quiosque do Chrome OS.

  • isPublicSession

    booleano opcional

    Chrome 47 ou versão mais recente

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

  • Tipo

    string opcional

    O tipo MIME do arquivo.

LaunchSource

Enumeração de origens de inicialização do app. Isso precisa ser mantido sincronizado com AppLaunchSource em components/services/app_service/public/mojom/types.mojom e GetLaunchSourceEnum() em extensions/browser/api/app_runtime/app_runtime_api.cc. Observe que a enumeração é usada em um histograma UMA, então as entradas não devem ser reordenadas ou removidas.

Tipo enumerado

"app_launcher"

"new_tab_page"

"load_and_launch"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"extensions_page"

"management_api"

"chrome_internal"

"context_menu"

"intent_url"

"app_home_page"

"focus_mode"
(link em inglês)

Eventos

onEmbedRequested

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

Disparado quando um app incorporado solicita a incorporação. Este 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 na 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 navegador foi encerrado pela última vez ou quando os apps foram solicitados para reiniciar do estado anterior por outros motivos. Por exemplo, quando o usuário revoga o acesso aos 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