Headers: set() method
The set() method sets a name to a single value. All existing values with the same name are overwritten.
Syntax
set(name, value)Parameters
name
The header name, a string, case-insensitive. A non-string is converted to a string first.
value
The header value, a string. A non-string is converted to a string first. Leading and trailing whitespace (spaces, tabs, carriage returns, line feeds) is removed: ' v ' is stored as 'v'.
Return value
None (undefined).
Exceptions
TypeError
Invalid name: Invalid header name: "坏 名字". A name can only consist of letters, digits, and the symbols !#$%&'*+-.^_`|~, and can't be empty.
The value contains NUL, carriage return, or line feed in the middle: Header value cannot contain NUL, CR or LF.
Examples
const h = new Headers();
h.append('Accept', 'a');
h.append('Accept', 'b');
h.set('accept', 'c');
console.log(h.get('Accept'));Result: Prints c. Not verified in the simulator.
Differences from the web
Names aren't restricted: names such as Host, Cookie, and Origin can all be set. Browsers forbid or ignore these names when sending a request.
See also
append(): appends instead of overwriting