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 superior

Propriedades

  • actionType

    "nova_nota"

ActionType

Chrome 54 ou superior

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

"nova_nota"

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 a uma <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 este app em um <appview> .

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

    () => {...}

LaunchData

Propriedades

  • actionData

    ActionData opcional

    Chrome 54 ou superior

    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 superior

    Indica 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 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. Ele 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.

Enumeração

"não rastreado"

&quot;app_launcher&quot;

"new_tab_page"

"atualizar"

"reiniciar"

&quot;load_and_launch&quot;

"linha_de_comando"

&quot;file_handler&quot;

"url_handler"

"system_tray"

"about_page"

"teclado"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

"plano de fundo"

"quiosque"

"chrome_internal"

"teste"

&quot;installed_notification&quot;

&quot;context_menu&quot;

"arco"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;
(link em inglês)

"brilhante"

Eventos

onEmbedRequested

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

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

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (request: EmbedRequest) => void

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