improbable-eng/js-browser-headers

Name: js-browser-headers

Owner: Improbable Engineering

Description: Compatibility Layer for the Headers class

Created: 2017-02-28 10:33:15.0

Updated: 2018-05-07 10:28:03.0

Pushed: 2017-12-03 14:10:01.0

Homepage:

Size: 40

Language: TypeScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

browser-headers

Compatibility Layer for the Headers class

The Headers class defined in the fetch spec has been implemented slightly differently across browser vendors at the time of writing (Feb 2017).

This package intends to provide a wrapper for the Headers class to ensure a consistent API and provides headers parsing from CLRF-delimited strings.

This package is written in TypeScript, but is designed to be used just as easily by JavaScript projects.

Installation

via npm:

m install browser-headers

Browser Support

This library is tested against Chrome, Safari, Firefox, Opera, Edge, IE 10 and IE 9.

API

rt BrowserHeaders from 'browser-headers';

t headers = new BrowserHeaders({
ontent-type": "application/json",
y-header": ["value-one","value-two"]


ers.forEach((key, values) => {
nsole.log(key, values);


utput:
content-type", ["application/json"]
my-header", ["value-one","value-two"]

The BrowserHeaders class has the following methods:

constructor(init: Headers | {[key: string]: string|string[]} | Map | string | BrowserHeaders, options: {splitValues: boolean}): string[]

init can be one of:

• An instance of Headers
• A CLRF-delimited string (e.g. key-a: one\r\nkey-b: two)
• An instance of BrowserHeaders
• An object consisting of string->(string|string[]) (e.g. {"key-a":["one","two"],"key-b":"three"})
• A Map<string, string|string[]>

The constructor takes an additional optional options parameter of { splitValues: boolean = false }, where splitValues defines whether the header values should be split by comma (,) into separate strings - this is useful to unify the .append functionality of Headers implementations (see the warning at the end of this README). splitValues should be used with caution and defaults to false because it might split what is actually a single logical value that contained a ,.

.get(key: string): string[]

Returns all of the values for that header key as an array

.forEach(callback: (key: string, values: string[]) => void): void

Invokes the provided callback with each key and it's associated values as an array

.set(key: string, values: string|string[]): void

Overwrites the key with the value(s) specified.

.append(key: string, values: string|string[]): void

Appends the value(s) to specified key.

.delete(key: string, value: string): void

If the value is specified:

Removes the specified `value` from the `key` if it is present.

Otherwise:

Removes all values for the `key` if it is present.

.has(key: string, value?: string): boolean

If the value is specified:

Returns true if the `key` contains the corresponding `value`.

Otherwise:

Returns true if the `key` has at least one value.

.appendFromString(str: string): void

Appends the headers defined in the provided CLRF-delimited string (e.g. key-a: one\r\nkey-b: two)

.toHeaders(): Headers

Returns an instance of the browser's Headers class. This will throw an exception if the current browser does not have the Headers class.

Warning about .append in native Headers

The .append function of the Headers class differs significantly between browsers.

Some browsers concatenate the values with ", " or just "," and others actually maintain the individual values such that they can return later return an array. There is a constructor option (see above: splitValues) that can be enabled to attempt to parse these concatenated strings back into individual values.

t headers = new Headers();
ers.append("key-A", "one");
ers.append("key-A", "two");
t keyA = headers.get("key-A"); // or .getAll depending on the browser 
ole.log(typeof keyA);
ole.log(keyA);

utput in Edge 14:
tring
ne, two

utput in Safari 10:
tring
ne,two

utput in Chrome 56:
bject
"one", "two"]