XMLHttpRequest.setRequestHeader()

 

O método setRequestHeader() de XMLHttpRequest define o valor do cabeçalho de uma requisição HTTP. Ao usar setRequestHeader(), você deve chamá-lo depois de chamar o método open(), mas antes de chamar o método send(). Se esse método é chamado muitas vezes com o mesmo cabeçalho, os valores são somados em um único cabeçalho de requisição HTTP.

A cada vez que você chama setRequestHeader() depois de ter chamado-o pelo menos uma vez, o texto especificado é somado ao final do conteúdo do cabeçalho existente.

Se nenhum cabeçalho Accept foi definido usando este método, um cabeçalho Accept com o tipo "*/*" é enviado com a requisição quando send() é chamado.

Por razões de segurança, alguns cabeçalhos só podem ser controlados pelo agente do usuário. Esses cabeçalhos incluem o cabeçalho forbidden header names e o cabeçalho forbidden response header names.

Observação: Para seu campos personalizados, você pode encontrar uma exceção "not allowed by Access-Control-Allow-Headers in preflight response" quando você envia requisições através de domínios. Neste caso, você precisa definir o cabeçalho Access-Control-Allow-Headers no seu cabeçalho de resposta no lado do servidor.

Sintaxe

XMLHttpRequest.setRequestHeader(header, value)

Parâmetros

header
O nome do cabeçalho cujo valor está para ser definido.
value
O valor a ser definido como o corpo do cabeçalho.

Valor de retorno

undefined.

Especificações

Especificação Status Comentário
XMLHttpRequest
The definition of 'setRequestHeader()' in that specification.
Padrão em tempo real WHATWG living standard

Compatibilidade com navegadores

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
setRequestHeaderChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 5Opera Full support 8Safari Full support 1.2WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0

Legend

Full support  
Full support

Veja também