chrome.devtools.network

Descrição

Use a API chrome.devtools.network para recuperar as informações sobre solicitações de rede mostradas pelas Ferramentas para desenvolvedores no painel "Rede".

As informações das 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 HAR v1.2.

Em termos de HAR, o método chrome.devtools.network.getHAR() retorna o registro HAR inteiro, enquanto o evento chrome.devtools.network.onRequestFinished fornece a entrada HAR como argumento para a chamada de retorno do evento.

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

Se a janela de Ferramentas para desenvolvedores for aberta depois que a página for carregada, talvez algumas solicitações não estejam na matriz de entradas retornadas por getHAR(). Atualize a página para receber todas as solicitações. Em geral, a lista de solicitações retornadas por getHAR() precisa corresponder àquela 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 o uso dessa API.

"devtools_page"

Exemplos

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

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

Para testar essa API, instale os exemplos da API DevTools no 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 tem esta aparência:

  (callback: function)=> {...}

  • callback

    função

    O parâmetro callback tem esta aparência:

    (content: string,encoding: string)=>void

    • conteúdo

      string

      Conteúdo do corpo da resposta (possivelmente codificado).

    • Codificação

      string

      Vai ser vazio se o conteúdo não estiver codificado. Caso contrário, codifica o nome. Atualmente, apenas a codificação de base64 é suportada.

Métodos

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

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

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (harLog: object)=>void

  • harLog

    objeto

    Um registro HAR. Consulte a especificação HAR para mais detalhes.

Eventos

onNavigated

chrome.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 tem esta aparência:

  (url: string)=>void

  • url

    string

onRequestFinished

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

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

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (request: Request)=>void

  • request

    Solicitação