browser.devtools.network

Descrição

Use a API chrome.devtools.network para recuperar as informações sobre solicitações de rede exibidas pelas Ferramentas para Desenvolvedores no painel Network.

As informações de solicitações de rede são representadas no formato HTTP Archive (HAR). A descrição do HAR está fora do escopo deste documento. Consulte a especificação do HAR v1.2.

Em termos de HAR, o método browser.devtools.network.getHAR() retorna todo o registro HAR, enquanto o evento browser.devtools.network.onRequestFinished fornece a entrada HAR como um argumento para o callback do evento.

Por motivos de eficiência, o conteúdo da solicitação não é fornecido como parte do HAR. Você pode chamar o método getContent() da solicitação para recuperar o conteúdo.

Se a janela "Ferramentas para desenvolvedores" for aberta depois que a página for carregada, algumas solicitações poderão estar ausentes na matriz de entradas retornadas por getHAR(). Atualize a página para receber todas as solicitações. Em geral, a lista de solicitações retornada por getHAR() precisa corresponder à exibida no painel Network.

Consulte o resumo das APIs do DevTools para uma introdução geral ao uso das APIs das ferramentas para desenvolvedores.

Manifesto

As chaves a seguir precisam ser declaradas no manifesto para usar essa API.

"devtools_page"

Exemplos

O código a seguir registra os URLs de todas as imagens maiores que 40 KB à medida que são carregadas:

browser.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      browser.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

Para testar essa API, instale os exemplos da API devtools do repositório chrome-extension-samples.

Tipos

Request

Representa uma solicitação de rede para um recurso de documento (script, imagem etc.). Consulte a especificação HAR para referência.

Propriedades

  • getContent

    void

    Retorna o conteúdo do corpo da resposta.

    A função getContent é semelhante a: 

    () => {...}

    • retorna

      Promise<object>

      Chrome 151+ browser.* desde o Chrome 152

      Uma função que recebe o corpo da resposta quando a solicitação é concluída.

Métodos

getHAR()

browser.devtools.network.getHAR(): Promise<object>

Retorna o registro HAR que contém todas as solicitações de rede conhecidas.

Retorna

  • Promise<object>

    Chrome 151+ browser.* desde o Chrome 152

    Uma função que recebe o registro HAR quando a solicitação é concluída.

Eventos

onNavigated

browser.devtools.network.onNavigated.addListener(
  callback: function,
)

Disparado quando a janela inspecionada navega para uma nova página.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (url: string) => void

    • url

      string

onRequestFinished

browser.devtools.network.onRequestFinished.addListener(
  callback: function,
)

Disparado quando uma solicitação de rede é concluída e todos os dados dela estão disponíveis.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (request: Request) => void