Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Headers — cabeçalhos HTTP

Headers armazena cabeçalhos HTTP para Fetch e permite lê-los, acrescentar valores, substituí-los, eliminá-los e percorrer o objeto.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Headers(init?)
headers.append(name, value)
headers.set(name, value)
headers.get(name)
headers.has(name)
headers.delete(name)
for (const [name, value] of headers) { /* ... */ }

Headers é uma interface de Fetch, não de ECMAScript. O construtor aceita um objeto, pares ou outro objeto Headers. Nos nomes, não há distinção entre maiúsculas e minúsculas. No início e no fim de um valor, Fetch remove apenas os bytes de espaço em branco de HTTP: tabulação horizontal (0x09), avanço de linha (0x0A), retorno de carro (0x0D) e espaço (0x20). Um espaço não separável (U+00A0) no início ou no fim do valor é aceite e mantido.

append() acrescenta um valor; set() substitui todos os valores associados a um nome. get() junta os valores com , e devolve null quando não existe nenhum valor. has() verifica se um nome está presente; delete() remove-o. O objeto é iterável.

Nomes ou valores inválidos causam um TypeError. Os cabeçalhos de pedido e de resposta estão sujeitos a restrições; alterar com êxito um objeto Headers autónomo não garante que o cabeçalho seja transmitido.

Exemplos

const headers = new Headers({ "X-Tag": " alpha " });
headers.append("x-tag", "beta");
console.log(headers.get("X-TAG"));
headers.set("x-tag", "gamma");
console.log(headers.get("x-tag"));
headers.delete("x-tag");
console.log(headers.has("x-tag"));
console.log(headers.get("x-tag"));

Resultado

alpha, beta
gamma
false
null

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes