CKTIS / JavaScript
Headers — HTTP hlavičky
Headers ukladá HTTP hlavičky pre Fetch a umožňuje ich čítať, pridávať, nahrádzať a odstraňovať, ako aj objektom iterovať.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 rozhranie Fetch, nie súčasť ECMAScriptu. Konštruktor prijíma objekt, dvojice alebo iný objekt Headers. V názvoch sa nerozlišujú veľké a malé písmená. Zo začiatku a konca hodnoty Fetch odstraňuje iba bajty bielych znakov HTTP: vodorovný tabulátor (0x09), posun na nový riadok (0x0A), návrat vozíka (0x0D) a medzeru (0x20). Nedeliteľná medzera (U+00A0) na začiatku alebo na konci hodnoty je povolená a zostáva zachovaná.
append() pridá hodnotu; set() nahradí všetky hodnoty daného názvu. get() spojí hodnoty pomocou , a ak žiadna hodnota nie je k dispozícii, vráti null. has() kontroluje, či názov existuje; delete() ho odstráni. Objekt je iterovateľný.
Neplatné názvy alebo hodnoty spôsobia TypeError. Pre hlavičky požiadaviek a odpovedí platia obmedzenia; úspešná zmena samostatného objektu Headers nezaručuje odoslanie hlavičky.
Prí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ýsledok
alpha, beta gamma false null
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.