chrome.webRequest

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.webRequest para observar e analisar o tráfego e interceptar, bloquear ou modificar solicitações em andamento.

Permissões

webRequest

Manifesto

É necessário declarar a permissão "webRequest" no manifesto da extensão para usar a API de solicitação da Web, além das permissões de host necessárias. Para interceptar uma solicitação de sub-recurso, a extensão precisa ter acesso ao URL solicitado e ao iniciador. Exemplo:

{
  "name": "My extension",
  ...
  "permissions": [
    "webRequest"
  ],
  "host_permissions": [
    "*://*.google.com/*"
  ],
  ...
}

A partir do Chrome 108, é possível fornecer credenciais de forma assíncrona para eventos onAuthRequired se você usar as permissões "webRequest" e "webRequestAuthProvider".

Ciclo de vida das solicitações

A API Web Request define um conjunto de eventos que seguem o ciclo de vida de uma solicitação da Web. É possível usar esses eventos para observar e analisar o tráfego. Alguns eventos síncronos permitem interceptar, bloquear ou modificar uma solicitação.

O ciclo de vida do evento para solicitações bem-sucedidas é ilustrado aqui, seguido pelas definições de evento:

Ciclo de vida de uma solicitação da Web do ponto de vista da API webrequest

onBeforeRequest (opcionalmente síncrono)
É acionado quando uma solicitação está prestes a ocorrer. Esse evento é enviado antes de qualquer conexão TCP ser feita e pode ser usado para cancelar ou redirecionar solicitações.
onBeforeSendHeaders (opcionalmente síncrono)
É acionado quando uma solicitação está prestes a ocorrer e os cabeçalhos iniciais foram preparados. O evento permite que as extensões adicionem, modifiquem e excluam cabeçalhos da solicitação (*). O evento onBeforeSendHeaders é transmitido para todos os assinantes, então diferentes assinantes podem tentar modificar a solicitação. Consulte a seção Detalhes da implementação para saber como isso é processado. Esse evento pode ser usado para cancelar a solicitação.
onSendHeaders
É acionado depois que todas as extensões têm a chance de modificar os cabeçalhos da solicitação e apresenta a versão final (*). O evento é acionado antes que os cabeçalhos sejam enviados para a rede. Esse evento é informativo e processado de forma assíncrona. Não é possível modificar ou cancelar a solicitação.
onHeadersReceived (opcionalmente síncrono)
É acionado sempre que um cabeçalho de resposta HTTP(S) é recebido. Devido a redirecionamentos e solicitações de autenticação, isso pode acontecer várias vezes por solicitação. Esse evento permite que as extensões adicionem, modifiquem e excluam cabeçalhos de resposta, como os cabeçalhos Content-Type recebidos. As diretivas de armazenamento em cache são processadas antes que esse evento seja acionado. Portanto, modificar cabeçalhos como Cache-Control não influencia o cache do navegador. Ele também permite cancelar ou redirecionar a solicitação.
onAuthRequired (opcionalmente síncrono)
É acionado quando uma solicitação exige a autenticação do usuário. Esse evento pode ser processado de forma síncrona para fornecer credenciais de autenticação. As extensões podem fornecer credenciais inválidas. Tome cuidado para não entrar em um loop infinito fornecendo repetidamente credenciais inválidas. Isso também pode ser usado para cancelar a solicitação.
onBeforeRedirect
É acionado quando um redirecionamento está prestes a ser executado. Um redirecionamento pode ser acionado por um código de resposta HTTP ou por uma extensão. Este evento é informativo e processado de forma assíncrona. Não é possível modificar ou cancelar a solicitação.
onResponseStarted
É acionado quando o primeiro byte do corpo da resposta é recebido. Para solicitações HTTP, isso significa que a linha de status e os cabeçalhos de resposta estão disponíveis. Esse evento é informativo e processado de forma assíncrona. Não é possível modificar ou cancelar o pedido.
onCompleted
É acionado quando uma solicitação é processada com sucesso.
onErrorOccurred
É acionado quando uma solicitação não pode ser processada.

A API de solicitação da web garante que, para cada solicitação, onCompleted ou onErrorOccurred seja disparado como o evento final, com uma exceção: se uma solicitação for redirecionada para um URL data://, onBeforeRedirect será o último evento informado.

* Observe que a API de solicitação da web apresenta uma abstração da pilha de rede para a extensão. Internamente, uma solicitação de URL pode ser dividida em várias solicitações HTTP (por exemplo, para buscar intervalos de bytes individuais de um arquivo grande) ou pode ser processada pela pilha de rede sem se comunicar com a rede. Por esse motivo, a API não fornece os cabeçalhos HTTP finais que são enviados para a rede. Por exemplo, todos os cabeçalhos relacionados ao armazenamento em cache são invisíveis para a extensão.

Os cabeçalhos a seguir não são fornecidos para o evento onBeforeSendHeaders. Não há garantia de que essa lista esteja completa ou estável.

  • Autorização
  • Cache-Control
  • Conexão
  • Content-Length
  • Host
  • If-Modified-Since
  • If-None-Match
  • If-Range
  • Partial-Data
  • Pragma
  • Proxy-Authorization
  • Proxy-Connection
  • Transfer-Encoding

A partir do Chrome 79, as modificações no cabeçalho da solicitação afetam as verificações de compartilhamento de recursos entre origens (CORS). Se os cabeçalhos modificados para solicitações entre origens não atenderem aos critérios, uma simulação de CORS será enviada para perguntar ao servidor se esses cabeçalhos podem ser aceitos. Se você realmente precisar modificar cabeçalhos de uma forma que viole o protocolo CORS, especifique 'extraHeaders' em opt_extraInfoSpec. Por outro lado, as modificações no cabeçalho de resposta não funcionam para enganar as verificações de CORS. Se você precisar enganar o protocolo CORS, também precisará especificar 'extraHeaders' para as modificações de resposta.

A partir do Chrome 79, a API webRequest não intercepta solicitações e respostas de simulação de CORS por padrão. Uma simulação de CORS para um URL de solicitação fica visível para uma extensão se houver um listener com 'extraHeaders' especificado em opt_extraInfoSpec para o URL de solicitação. O onBeforeRequest também pode usar 'extraHeaders' do Chrome 79.

A partir do Chrome 79, o cabeçalho de solicitação a seguir não é fornecido e não pode ser modificado ou removido sem especificar 'extraHeaders' em opt_extraInfoSpec:

  • Origem

A partir do Chrome 72, se você precisar modificar as respostas antes que o bloqueio de leitura entre origens (CORB, na sigla em inglês) as bloqueie, especifique 'extraHeaders' em opt_extraInfoSpec.

A partir do Chrome 72, os seguintes cabeçalhos de solicitação não são fornecidos e não podem ser modificados ou removidos sem especificar 'extraHeaders' em opt_extraInfoSpec:

  • Accept-Language
  • Accept-Encoding
  • Referenciador
  • Cookie

A partir do Chrome 72, o cabeçalho de resposta Set-Cookie não é fornecido e não pode ser modificado ou removido sem especificar 'extraHeaders' em opt_extraInfoSpec.

A partir do Chrome 89, o cabeçalho de resposta X-Frame-Options não pode ser modificado ou removido sem especificar 'extraHeaders' em opt_extraInfoSpec.

A API webRequest só expõe as solicitações que a extensão tem permissão para ver, de acordo com as permissões de host. Além disso, somente os seguintes esquemas são acessíveis: http://, https://, ftp://, file://, ws:// (desde o Chrome 58), wss:// (desde o Chrome 58), urn: (desde o Chrome 91) ou chrome-extension://. Além disso, até mesmo algumas solicitações com URLs que usam um dos esquemas acima são ocultadas. Isso inclui chrome-extension://other_extension_id em que other_extension_id não é o ID da extensão para processar a solicitação, https://www.google.com/chrome e outras solicitações sensíveis essenciais para a funcionalidade do navegador. Além disso, as XMLHttpRequests síncronas da sua extensão ficam ocultas dos manipuladores de eventos de bloqueio para evitar deadlocks. Para alguns dos esquemas compatíveis, o conjunto de eventos disponíveis pode ser limitado devido à natureza do protocolo correspondente. Por exemplo, para o esquema file:, somente onBeforeRequest, onResponseStarted, onCompleted e onErrorOccurred podem ser enviados.

A partir do Chrome 58, a API webRequest é compatível com a interceptação da solicitação de handshake do WebSocket. Como o handshake é feito por meio de uma solicitação de upgrade de HTTP, o fluxo dele se encaixa no modelo webRequest orientado a HTTP. A API não intercepta:

  • Mensagens individuais enviadas por uma conexão WebSocket estabelecida.
  • WebSocket encerrando conexão.

Os redirecionamentos não são compatíveis com solicitações do WebSocket.

A partir do Chrome 72, uma extensão só poderá interceptar uma solicitação se tiver permissões de host para o URL solicitado e o iniciador da solicitação.

A partir do Chrome 96, a API webRequest é compatível com a interceptação da solicitação de handshake do WebTransport por HTTP/3. Como o handshake é feito por meio de uma solicitação HTTP CONNECT, o fluxo dele se encaixa no modelo webRequest orientado a HTTP. Observações:

  • Depois que a sessão é estabelecida, as extensões não podem observar ou intervir nela usando a API webRequest.
  • A modificação de cabeçalhos da solicitação HTTP em onBeforeSendHeaders é ignorada.
  • Redirecionamentos e autenticações não são aceitos no WebTransport por HTTP/3.

Conceitos

Como as seções a seguir explicam, os eventos na API de solicitação da web usam IDs de solicitação, e você pode especificar filtros e informações extras ao registrar listeners de eventos.

IDs de solicitação

Cada solicitação é identificada por um ID. Esse ID é exclusivo em uma sessão do navegador e no contexto de uma extensão. Ele permanece constante durante o ciclo de vida de uma solicitação e pode ser usado para corresponder eventos da mesma solicitação. Várias solicitações HTTP são mapeadas para uma solicitação da Web em caso de redirecionamento ou autenticação HTTP.

Como registrar listeners de eventos

Para registrar um listener de eventos para uma solicitação da Web, use uma variação da função addListener() comum. Além de especificar uma função de callback, é necessário especificar um argumento de filtro e, se quiser, um argumento de informações extras opcional.

Os três argumentos para o addListener() da API de solicitação da Web têm as seguintes definições:

var callback = function(details) {...};
var filter = {...};
var opt_extraInfoSpec = [...];

Veja um exemplo de como detectar o evento onBeforeRequest:

chrome.webRequest.onBeforeRequest.addListener(
    callback, filter, opt_extraInfoSpec);

Cada chamada addListener() usa uma função de callback obrigatória como o primeiro parâmetro. Essa função de callback recebe um dicionário com informações sobre a solicitação de URL atual. As informações nesse dicionário dependem do tipo de evento específico, bem como do conteúdo de opt_extraInfoSpec.

Se a matriz opcional opt_extraInfoSpec contiver a string 'blocking' (permitida apenas para eventos específicos), a função de callback será processada de forma síncrona. Isso significa que a solicitação é bloqueada até que a função de callback seja retornada. Nesse caso, o callback pode retornar um webRequest.BlockingResponse que determina o ciclo de vida da solicitação. Dependendo do contexto, essa resposta permite cancelar ou redirecionar uma solicitação (onBeforeRequest), cancelar uma solicitação ou modificar cabeçalhos (onBeforeSendHeaders, onHeadersReceived) e cancelar uma solicitação ou fornecer credenciais de autenticação (onAuthRequired).

Se a matriz opcional opt_extraInfoSpec contiver a string 'asyncBlocking' (permitida apenas para onAuthRequired), a extensão poderá gerar o webRequest.BlockingResponse de forma assíncrona.

O filter do webRequest.RequestFilter permite limitar as solicitações para que os eventos sejam acionados em várias dimensões:

URLs
Padrões de URL, como *://www.google.com/foo*bar.
Tipos
Tipos de solicitação, como main_frame (um documento carregado para um frame de nível superior), sub_frame (um documento carregado para um frame incorporado) e image (uma imagem em um site). Consulte webRequest.RequestFilter.
Guia ID
O identificador de uma guia.
ID da janela
O identificador de uma janela.

Dependendo do tipo de evento, é possível especificar strings em opt_extraInfoSpec para solicitar mais informações sobre a solicitação. Isso é usado para fornecer informações detalhadas sobre os dados da solicitação apenas se solicitado explicitamente.

Detalhes da implementação

Vários detalhes de implementação podem ser importantes para entender ao desenvolver uma extensão que usa a API de solicitação da web:

web_accessible_resources

Quando uma extensão usa APIs webRequest para redirecionar uma solicitação de recurso público para um recurso que não é acessível pela Web, ela é bloqueada e resulta em um erro. O mesmo vale se o recurso que não é acessível pela Web pertencer à extensão de redirecionamento. Para declarar recursos para uso com as APIs declarativeWebRequest, a matriz "web_accessible_resources" precisa ser declarada e preenchida no manifesto, conforme documentado aqui.

Resolução de conflitos

Na implementação atual da API de solicitação da web, uma solicitação é considerada cancelada se pelo menos uma extensão instruir o cancelamento. Se uma extensão cancelar uma solicitação, todas as extensões serão notificadas por um evento onErrorOccurred. Apenas uma extensão pode redirecionar uma solicitação ou modificar um cabeçalho por vez. Se mais de uma extensão tentar modificar a solicitação, a extensão instalada mais recentemente vai prevalecer, e todas as outras serão ignoradas. Uma extensão não é notificada se a instrução para modificar ou redirecionar for ignorada.

Armazenamento em cache

O Chrome usa dois caches: um cache em disco e um cache em memória muito rápido. O ciclo de vida de um cache em memória está vinculado ao ciclo de vida de um processo de renderização, que corresponde aproximadamente a uma guia. As solicitações respondidas pelo cache em memória são invisíveis para a API de solicitação da Web. Se um manipulador de solicitações mudar o comportamento (por exemplo, o comportamento de acordo com o qual as solicitações são bloqueadas), uma simples atualização de página pode não respeitar essa mudança. Para garantir que a mudança de comportamento seja aplicada, chame handlerBehaviorChanged() para limpar o cache em memória. Mas não faça isso com frequência. Limpar o cache é uma operação muito cara. Não é necessário chamar handlerBehaviorChanged() depois de registrar ou cancelar o registro de um listener de eventos.

Carimbos de data/hora

A propriedade timestamp dos eventos de solicitação da Web só tem garantia de consistência interna. A comparação de um evento com outro vai fornecer o deslocamento correto entre eles, mas a comparação com o horário atual dentro da extensão (por exemplo, usando (new Date()).getTime()) pode gerar resultados inesperados.

Tratamento de erros

Se você tentar registrar um evento com argumentos inválidos, um erro de JavaScript será gerado, e o manipulador de eventos não será registrado. Se um erro for gerado enquanto um evento é processado ou se um manipulador de eventos retornar uma resposta de bloqueio inválida, uma mensagem de erro será registrada no console da extensão, e o manipulador será ignorado para essa solicitação.

Exemplos

O exemplo a seguir ilustra como bloquear todas as solicitações para www.evil.com:

chrome.webRequest.onBeforeRequest.addListener(
  function(details) {
    return {cancel: details.url.indexOf("://www.evil.com/") != -1};
  },
  {urls: ["<all_urls>"]},
  ["blocking"]
);

Como essa função usa um manipulador de eventos de bloqueio, ela requer a permissão "webRequest" e "webRequestBlocking" no arquivo de manifesto.

O exemplo a seguir alcança o mesmo objetivo de maneira mais eficiente, porque as solicitações que não são direcionadas a www.evil.com não precisam ser transmitidas para a extensão:

chrome.webRequest.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]
);

O exemplo a seguir ilustra como excluir o cabeçalho User-Agent de todas as solicitações:

chrome.webRequest.onBeforeSendHeaders.addListener(
  function(details) {
    for (var i = 0; i < details.requestHeaders.length; ++i) {
      if (details.requestHeaders[i].name === 'User-Agent') {
        details.requestHeaders.splice(i, 1);
        break;
      }
    }
    return {requestHeaders: details.requestHeaders};
  },
  {urls: ["<all_urls>"]},
  ["blocking", "requestHeaders"]
);

Para testar a API chrome.webRequest, instale o exemplo de webRequest do repositório chrome-extension-samples.

Tipos

BlockingResponse

Retorna o valor para manipuladores de eventos que têm o extraInfoSpec "blocking" aplicado. Permite que o manipulador de eventos modifique as solicitações de rede.

Propriedades

  • authCredentials

    objeto optional

    Usado apenas como resposta ao evento onAuthRequired. Se definido, a solicitação é feita usando as credenciais fornecidas.

    • senha

      string

    • nome de usuário

      string

  • cancelar

    booleano opcional

    Se for verdadeiro, a solicitação será cancelada. Isso impede que a solicitação seja enviada. Isso pode ser usado como uma resposta aos eventos onBeforeRequest, onBeforeSendHeaders, onHeadersReceived e onAuthRequired.

  • redirectUrl

    string opcional

    Usado apenas como resposta aos eventos onBeforeRequest e onHeadersReceived. Se definido, a solicitação original não será enviada/concluída e será redirecionada para o URL fornecido. Redirecionamentos para esquemas não HTTP, como data:, são permitidos. Os redirecionamentos iniciados por uma ação de redirecionamento usam o método de solicitação original, com uma exceção: se o redirecionamento for iniciado no estágio onHeadersReceived, ele será emitido usando o método GET. Os redirecionamentos de URLs com esquemas ws:// e wss:// são ignorados.

  • requestHeaders

    HttpHeaders opcional

    Usado apenas como resposta ao evento onBeforeSendHeaders. Se definido, a solicitação será feita com esses cabeçalhos da solicitação.

  • responseHeaders

    HttpHeaders opcional

    Usado apenas como resposta ao evento onHeadersReceived. Se definido, presume-se que o servidor tenha respondido com esses cabeçalhos de resposta. Retorne responseHeaders apenas se você realmente quiser modificar os cabeçalhos para limitar o número de conflitos (somente uma extensão pode modificar responseHeaders para cada solicitação).

FormDataItem

Chrome 66 ou mais recente

Contém dados transmitidos nos dados do formulário. Para o formulário urlencoded, ele é armazenado como string se os dados forem uma string utf-8 e como ArrayBuffer, caso contrário. Para form-data, é ArrayBuffer. Se form-data representar o upload de um arquivo, será uma string com o nome do arquivo, se ele for fornecido.

Enumeração

ArrayBuffer

string

HttpHeaders

Uma matriz de cabeçalhos HTTP. Cada cabeçalho é representado como um dicionário que contém as chaves name e value ou binaryValue.

Tipo

object[]

Propriedades

  • binaryValue

    number[] opcional

    Valor do cabeçalho HTTP se ele não puder ser representado por UTF-8, armazenado como valores de byte individuais (0..255).

  • nome

    string

    Nome do cabeçalho HTTP.

  • valor

    string opcional

    Valor do cabeçalho HTTP se ele puder ser representado por UTF-8.

IgnoredActionType

Chrome 70 ou mais recente

Enumeração

"redirect"

"request_headers"

"response_headers"

"auth_credentials"

OnAuthRequiredOptions

Chrome 44+

Enumeração

"responseHeaders"
Especifica que os cabeçalhos de resposta precisam ser incluídos no evento.

"blocking"
Especifica que a solicitação é bloqueada até que a função de callback retorne.

"asyncBlocking"
Especifica que a função de callback é processada de forma assíncrona.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

OnBeforeRedirectOptions

Chrome 44+

Enumeração

"responseHeaders"
Especifica que os cabeçalhos de resposta precisam ser incluídos no evento.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

OnBeforeRequestOptions

Chrome 44+

Enumeração

"blocking"
Especifica que a solicitação é bloqueada até que a função de callback retorne.

"requestBody"
Especifica que o corpo da solicitação precisa ser incluído no evento.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

OnBeforeSendHeadersOptions

Chrome 44+

Enumeração

"requestHeaders"
Especifica que o cabeçalho da solicitação precisa ser incluído no evento.

"blocking"
Especifica que a solicitação é bloqueada até que a função de callback retorne.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

OnCompletedOptions

Chrome 44+

Enumeração

"responseHeaders"
Especifica que os cabeçalhos de resposta precisam ser incluídos no evento.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

OnErrorOccurredOptions

Chrome 79+

Valor

"extraHeaders"

OnHeadersReceivedOptions

Chrome 44+

Enumeração

"blocking"
Especifica que a solicitação é bloqueada até que a função de callback retorne.

"responseHeaders"
Especifica que os cabeçalhos de resposta precisam ser incluídos no evento.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

"securityInfo"
Especifica que o SecurityInfo precisa ser incluído no evento.

"securityInfoRawDer"
Especifica que o SecurityInfo com bytes brutos de certificados precisa ser incluído no evento.

OnResponseStartedOptions

Chrome 44+

Enumeração

"responseHeaders"
Especifica que os cabeçalhos de resposta precisam ser incluídos no evento.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

OnSendHeadersOptions

Chrome 44+

Enumeração

"requestHeaders"
Especifica que o cabeçalho da solicitação precisa ser incluído no evento.

"extraHeaders"
Especifica que os cabeçalhos podem violar o compartilhamento de recursos entre origens (CORS).

RequestFilter

Um objeto que descreve os filtros a serem aplicados aos eventos webRequest.

Propriedades

  • tabId

    número optional

  • tipos

    ResourceType[] opcional

    Uma lista de tipos de solicitação. As solicitações que não corresponderem a nenhum dos tipos serão filtradas.

  • urls

    string[]

    Uma lista de URLs ou padrões de URL. As solicitações que não corresponderem a nenhum dos URLs serão filtradas.

  • windowId

    número optional

ResourceType

Chrome 44+

Enumeração

"main_frame"
Especifica o recurso como o frame principal.

"sub_frame"
Especifica o recurso como um subframe.

"stylesheet"
Especifica o recurso como uma folha de estilo.

"script"
Especifica o recurso como um script.

"image"
Especifica o recurso como uma imagem.

"font"
Especifica o recurso como uma fonte.

"object"
Especifica o recurso como um objeto.

"xmlhttprequest"
Especifica o recurso como um XMLHttpRequest.

"ping"
Especifica o recurso como um ping.

"csp_report"
Especifica o recurso como um relatório de Política de Segurança de Conteúdo (CSP).

"media"
Especifica o recurso como um objeto de mídia.

"websocket"
Especifica o recurso como um WebSocket.

"webbundle"
Especifica o recurso como um WebBundle.

"other"
Especifica o recurso como um tipo não incluído nos tipos listados.

SecurityInfo

Chrome 144 ou mais recente

Propriedades

  • certificados

    object[]

    Uma lista de certificados

    • impressão digital

      objeto

      Impressões digitais do certificado.

      • sha256

        string

        Impressão digital sha256 do certificado.

    • rawDER

      ArrayBuffer opcional

      Bytes brutos do certificado de servidor codificado em DER

  • estado

    string

    Estado da conexão. Uma das opções: seguro, não seguro, corrompido.

UploadData

Contém dados enviados em uma solicitação de URL.

Propriedades

  • bytes

    any optional

    Um ArrayBuffer com uma cópia dos dados.

  • arquivo

    string opcional

    Uma string com o caminho e o nome do arquivo.

Propriedades

MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES

O número máximo de vezes que handlerBehaviorChanged pode ser chamado por intervalo sustentado de 10 minutos. handlerBehaviorChanged é uma chamada de função cara que não deve ser chamada com frequência.

Valor

20

Métodos

handlerBehaviorChanged()

Promessa
chrome.webRequest.handlerBehaviorChanged(
  callback?: function,
)
: Promise<void>

Precisa ser chamado quando o comportamento dos gerenciadores webRequest mudar para evitar o processamento incorreto devido ao armazenamento em cache. Essa chamada de função é cara. Não o chame com frequência.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a:

    () => void

Retorna

  • Promessa<void>

    Chrome 116+

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

Eventos

onActionIgnored

Chrome 70 ou mais recente
chrome.webRequest.onActionIgnored.addListener(
  callback: function,
)

Disparado quando a modificação proposta por uma extensão em uma solicitação de rede é ignorada. Isso acontece em caso de conflitos com outras extensões.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => void

    • detalhes

      objeto

      • A ação proposta que foi ignorada.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

onAuthRequired

chrome.webRequest.onAuthRequired.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnAuthRequiredOptions[],
)

Acionado quando uma falha de autenticação é recebida. O listener tem três opções: fornecer credenciais de autenticação, cancelar a solicitação e mostrar a página de erro ou não realizar nenhuma ação no desafio. Se as credenciais do usuário forem inválidas, esse método poderá ser chamado várias vezes para a mesma solicitação. Apenas um dos modos 'blocking' ou 'asyncBlocking' precisa ser especificado no parâmetro extraInfoSpec.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object, asyncCallback?: function) => BlockingResponse | undefined

    • detalhes

      objeto

      • challenger

        objeto

        O servidor que solicita a autenticação.

        • host

          string

        • porta

          número

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • isProxy

        booleano

        Verdadeiro para Proxy-Authenticate, falso para WWW-Authenticate.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • realm

        string opcional

        O realm de autenticação fornecido pelo servidor, se houver.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • responseHeaders

        HttpHeaders opcional

        Os cabeçalhos de resposta HTTP que foram recebidos com essa resposta.

      • planejar

        string

        O esquema de autenticação, por exemplo, Basic ou Digest.

      • statusCode

        número

        Chrome 43+

        Código de status HTTP padrão retornado pelo servidor.

      • statusLine

        string

        Linha de status HTTP da resposta ou a string "HTTP/0.9 200 OK" para respostas HTTP/0.9 (ou seja, respostas que não têm uma linha de status) ou uma string vazia se não houver cabeçalhos.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

    • asyncCallback

      função optional

      Chrome 58 ou mais recente

      O parâmetro asyncCallback é semelhante a:

      (response: BlockingResponse) => void

    • retorna

      BlockingResponse | undefined

      Se "blocking" for especificado no parâmetro "extraInfoSpec", o listener de eventos vai retornar um objeto desse tipo.

  • filtro
  • extraInfoSpec

onBeforeRedirect

chrome.webRequest.onBeforeRedirect.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnBeforeRedirectOptions[],
)

Disparado quando um redirecionamento iniciado pelo servidor está prestes a ocorrer.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => void

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • fromCache

        booleano

        Indica se essa resposta foi buscada no cache em disco.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • ip

        string opcional

        O endereço IP do servidor para o qual a solicitação foi realmente enviada. Ele pode ser um endereço IPv6 literal.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • redirectUrl

        string

        O novo URL.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • responseHeaders

        HttpHeaders opcional

        Os cabeçalhos de resposta HTTP que foram recebidos com esse redirecionamento.

      • statusCode

        número

        Código de status HTTP padrão retornado pelo servidor.

      • statusLine

        string

        Linha de status HTTP da resposta ou a string "HTTP/0.9 200 OK" para respostas HTTP/0.9 (ou seja, respostas que não têm uma linha de status) ou uma string vazia se não houver cabeçalhos.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

  • filtro
  • extraInfoSpec

onBeforeRequest

chrome.webRequest.onBeforeRequest.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnBeforeRequestOptions[],
)

Disparado quando uma solicitação está prestes a ocorrer.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => BlockingResponse | undefined

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • documentLifecycle
        Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • frameType
        Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestBody

        objeto optional

        Contém os dados do corpo da solicitação HTTP. Fornecido apenas se extraInfoSpec contiver "requestBody".

        • erro

          string opcional

          Erros ao receber dados do corpo da solicitação.

        • formData

          objeto optional

          Se o método de solicitação for POST e o corpo for uma sequência de pares de chave-valor codificados em UTF8, codificados como multipart/form-data ou application/x-www-form-urlencoded, esse dicionário estará presente e, para cada chave, conterá a lista de todos os valores dessa chave. Se os dados forem de outro tipo de mídia ou estiverem corrompidos, o dicionário não estará presente. Um exemplo de valor desse dicionário é {'key': ['value1', 'value2']}.

        • raw

          UploadData[] opcional

          Se o método de solicitação for PUT ou POST e o corpo ainda não tiver sido analisado em formData, os elementos do corpo da solicitação não analisados serão incluídos nessa matriz.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

    • retorna

      BlockingResponse | undefined

      Se "blocking" for especificado no parâmetro "extraInfoSpec", o listener de eventos vai retornar um objeto desse tipo.

  • filtro
  • extraInfoSpec

onBeforeSendHeaders

chrome.webRequest.onBeforeSendHeaders.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnBeforeSendHeadersOptions[],
)

Acionado antes de enviar uma solicitação HTTP, quando os cabeçalhos da solicitação estão disponíveis. Isso pode ocorrer depois que uma conexão TCP é feita com o servidor, mas antes que qualquer dado HTTP seja enviado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => BlockingResponse | undefined

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestHeaders

        HttpHeaders opcional

        Os cabeçalhos da solicitação HTTP que serão enviados com essa solicitação.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

    • retorna

      BlockingResponse | undefined

      Se "blocking" for especificado no parâmetro "extraInfoSpec", o listener de eventos vai retornar um objeto desse tipo.

  • filtro
  • extraInfoSpec

onCompleted

chrome.webRequest.onCompleted.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnCompletedOptions[],
)

Acionado quando uma solicitação é concluída.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => void

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • fromCache

        booleano

        Indica se essa resposta foi buscada no cache em disco.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • ip

        string opcional

        O endereço IP do servidor para o qual a solicitação foi realmente enviada. Ele pode ser um endereço IPv6 literal.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • responseHeaders

        HttpHeaders opcional

        Os cabeçalhos de resposta HTTP que foram recebidos com essa resposta.

      • statusCode

        número

        Código de status HTTP padrão retornado pelo servidor.

      • statusLine

        string

        Linha de status HTTP da resposta ou a string "HTTP/0.9 200 OK" para respostas HTTP/0.9 (ou seja, respostas que não têm uma linha de status) ou uma string vazia se não houver cabeçalhos.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

  • filtro
  • extraInfoSpec

    OnCompletedOptions[] opcional

onErrorOccurred

chrome.webRequest.onErrorOccurred.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnErrorOccurredOptions[],
)

Acionado quando ocorre um erro.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => void

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação. Esse valor não estará presente se a solicitação for uma navegação de um frame.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • erro

        string

        A descrição do erro. Não há garantia de que essa string vai permanecer compatível com versões anteriores entre as versões. Não analise nem aja com base no conteúdo dele.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • fromCache

        booleano

        Indica se essa resposta foi buscada no cache em disco.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • ip

        string opcional

        O endereço IP do servidor para o qual a solicitação foi realmente enviada. Ele pode ser um endereço IPv6 literal.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

  • filtro
  • extraInfoSpec

onHeadersReceived

chrome.webRequest.onHeadersReceived.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnHeadersReceivedOptions[],
)

Disparado quando os cabeçalhos de resposta HTTP de uma solicitação são recebidos.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => BlockingResponse | undefined

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • responseHeaders

        HttpHeaders opcional

        Os cabeçalhos de resposta HTTP que foram recebidos com essa resposta.

      • securityInfo

        SecurityInfo opcional

        Chrome 144 ou mais recente

        Informações sobre a conexão TLS/QUIC usada para a conexão subjacente. Fornecido apenas se securityInfo for especificado no parâmetro extraInfoSpec.

      • statusCode

        número

        Chrome 43+

        Código de status HTTP padrão retornado pelo servidor.

      • statusLine

        string

        Linha de status HTTP da resposta ou a string "HTTP/0.9 200 OK" para respostas HTTP/0.9 (ou seja, respostas que não têm uma linha de status).

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

    • retorna

      BlockingResponse | undefined

      Se "blocking" for especificado no parâmetro "extraInfoSpec", o listener de eventos vai retornar um objeto desse tipo.

  • filtro
  • extraInfoSpec

onResponseStarted

chrome.webRequest.onResponseStarted.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnResponseStartedOptions[],
)

Acionado quando o primeiro byte do corpo da resposta é recebido. Para solicitações HTTP, isso significa que a linha de status e os cabeçalhos de resposta estão disponíveis.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => void

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • fromCache

        booleano

        Indica se essa resposta foi buscada no cache em disco.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • ip

        string opcional

        O endereço IP do servidor para o qual a solicitação foi realmente enviada. Ele pode ser um endereço IPv6 literal.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • responseHeaders

        HttpHeaders opcional

        Os cabeçalhos de resposta HTTP que foram recebidos com essa resposta.

      • statusCode

        número

        Código de status HTTP padrão retornado pelo servidor.

      • statusLine

        string

        Linha de status HTTP da resposta ou a string "HTTP/0.9 200 OK" para respostas HTTP/0.9 (ou seja, respostas que não têm uma linha de status) ou uma string vazia se não houver cabeçalhos.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

  • filtro
  • extraInfoSpec

onSendHeaders

chrome.webRequest.onSendHeaders.addListener(
  callback: function,
  filter: RequestFilter,
  extraInfoSpec?: OnSendHeadersOptions[],
)

Disparado antes de uma solicitação ser enviada ao servidor. As modificações de callbacks onBeforeSendHeaders anteriores ficam visíveis quando onSendHeaders é disparado.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a:

    (details: object) => void

    • detalhes

      objeto

      • documentId

        string opcional

        Chrome 106+

        O UUID do documento que está fazendo a solicitação.

      • Chrome 106+

        O ciclo de vida em que o documento está.

      • frameId

        número

        O valor 0 indica que a solicitação ocorre no frame principal. Um valor positivo indica o ID de um subframe em que a solicitação ocorre. Se o documento de um (sub)frame for carregado (type é main_frame ou sub_frame), frameId vai indicar o ID desse frame, não o do frame externo. Os IDs de frame são exclusivos em uma guia.

      • Chrome 106+

        O tipo de frame em que a solicitação ocorreu.

      • iniciador

        string opcional

        Chrome 63 ou mais recente

        A origem em que a solicitação foi iniciada. Isso não muda com os redirecionamentos. Se for uma origem opaca, a string "null" será usada.

      • método

        string

        Método HTTP padrão.

      • parentDocumentId

        string opcional

        Chrome 106+

        O UUID do documento pai que possui esse frame. Isso não será definido se não houver um pai.

      • parentFrameId

        número

        ID do frame que envolve o frame que enviou a solicitação. Defina como -1 se não houver um frame pai.

      • requestHeaders

        HttpHeaders opcional

        Os cabeçalhos da solicitação HTTP que foram enviados com essa solicitação.

      • requestId

        string

        O ID da solicitação. Os IDs de solicitação são exclusivos em uma sessão do navegador. Como resultado, eles podem ser usados para relacionar diferentes eventos da mesma solicitação.

      • tabId

        número

        O ID da guia em que a solicitação ocorre. Defina como -1 se a solicitação não estiver relacionada a uma guia.

      • timeStamp

        número

        O momento em que esse indicador é acionado, em milissegundos desde o período.

      • Como o recurso solicitado será usado.

      • url

        string

  • filtro
  • extraInfoSpec