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 YesIE Full support 7
Full support 7
Full support 5
Notes
Notes Implemented via ActiveXObject
Opera Full support YesSafari Full support 1.2WebView Android Full support YesChrome Android Full support 18Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

Veja também