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

    "new_note"

ActionType

Chrome 54 ou superior

Um app pode ser iniciado com uma ação específica em mente, por exemplo, para criar uma nova 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

    opcional

    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 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

    Impedindo 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. O 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 gerenciador de arquivos ou 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 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 superior

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

  • itens

    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 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 do app. Isso precisa ser mantido em sincronia 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 UMA, então as entradas não podem ser reordenadas ou removidas.

Enumeração

"reload"

"system_tray"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"app_home_page"

(link em inglês)

"sparky"

Eventos

onEmbedRequested

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

É acionado quando um app de incorporação solicita a incorporação desse app. Esse evento só está disponível no canal de desenvolvimento com a flag --enable-app-view.

Parâmetros

  • callback

    função

    O parâmetro callback tem este formato: 

    (request: EmbedRequest) => void

onLaunched

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

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

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 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, um evento onLaunched será enviado.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    () => void