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.
Nota: 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
BCD tables only load in the browser