chrome.devtools.network

Descrição

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

Manifesto

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

"devtools_page"

Consulte o resumo das APIs das Ferramentas para Desenvolvedores para uma introdução geral ao uso dessas APIs.

Visão geral

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

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

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 das Ferramentas para Desenvolvedores for aberta após o carregamento da página, algumas solicitações poderão estar ausentes na matriz de entradas retornadas por getHAR(). Recarregue a página para receber todas as solicitações. Em geral, a lista de solicitações retornadas por getHAR() precisa corresponder à exibida no painel Network.

Exemplos

O código a seguir registra URLs de todas as imagens maiores que 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 de API das Ferramentas para Desenvolvedores 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

    Promessa

    Retorna o conteúdo do corpo da resposta.

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

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

    • callback

      função opcional

      O parâmetro callback tem esta aparência: 

      (response: object) => void

      • resposta

        objeto

        Chrome 151 e versões mais recentes

        Um objeto que contém o corpo da resposta e a codificação dele.

        • conteúdo

          string

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

        • encoding

          string

          Vazio se o conteúdo não estiver codificado, caso contrário, o nome da codificação. Atualmente, apenas a codificação de base64 é suportada.

    • retorna

      Promise<object>

      Chrome 151 e versões mais recentes

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

      As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Métodos

getHAR()

Promessa 
chrome.devtools.network.getHAR(
  callback?: function,
): Promise<object>

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

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (harLog: object) => void

    • harLog

      objeto

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

Retorna

  • Promise<object>

    Chrome 151 e versões mais recentes

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

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onNavigated

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

Acionado 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,
)

Acionado 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