CKTIS / JavaScript
Headers — HTTP hlavičky
Headers ukládá HTTP hlavičky pro Fetch a umožňuje je číst, přidávat, nahrazovat a mazat, stejně jako objektem iterovat.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 je rozhraní Fetch, nikoli součást ECMAScriptu. Konstruktor přijímá objekt, dvojice nebo jiný objekt Headers. U názvů se nerozlišují velká a malá písmena. Ze začátku a konce hodnoty Fetch odstraňuje pouze bajty bílých znaků HTTP: vodorovný tabulátor (0x09), posun na nový řádek (0x0A), návrat vozíku (0x0D) a mezeru (0x20). Nezlomitelná mezera (U+00A0) je na začátku i na konci hodnoty povolena a zůstává zachována.
append() přidá hodnotu; set() nahradí všechny hodnoty daného názvu. get() spojí hodnoty pomocí , a v případě, že žádná hodnota není k dispozici, vrátí null. has() ověřuje, zda název existuje; delete() jej odstraní. Objekt je iterovatelný.
Neplatné názvy nebo hodnoty způsobí TypeError. Pro hlavičky požadavků a odpovědí platí omezení; úspěšná změna samostatného objektu Headers nezaručuje odeslání hlavičky.
Příklady
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"));Výsledek
alpha, beta gamma false null
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.