chrome.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 de arquivo HTTP (HAR). A descrição A 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 todo o registro HAR, enquanto O evento chrome.devtools.network.onRequestFinished fornece entrada HAR como argumento para o evento. o retorno de chamada.

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

Se a janela de Ferramentas para desenvolvedores for aberta após o carregamento da página, algumas solicitações podem estar faltando no a matriz de entradas retornadas por getHAR(). Atualize a página para conferir todas as solicitações. Em geral, o a lista de solicitações retornadas 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 URLs de todas as imagens maiores que 40 KB conforme 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 (link em inglês) em chrome-extension-samples repositório de dados.

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

    • encoding

      string

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

Métodos

getHAR()

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

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

  • solicitação

    Solicitação