Provide a way to access raw headers

This would solve…

As outlined at WHATWG/fetch there is often the need in a server environment to access cookie headers.

For example editing Cookie headers:

const h = new Headers;
h.append("Set-Cookie", "a=1; Expires=Wed, 21 Oct 2015 07:28:00 GMT");
h.append("Set-Cookie", "b=1; Expires=Wed, 21 Oct 2015 07:28:00 GMT");

h.get("Set-Cookie")
// a=1; Expires=Wed, 21 Oct 2015 07:28:00 GMT, b=1; Expires=Wed, 21 Oct 2015 07:28:00 GMT

Splitting the combined header value by , will give an invalid result. Instead getAll could be used to retrieve the individual headers.

The implementation should look like…

There are two solutions currently proposed:

1. Node-fetch provides a non-standard Headers.prototype.raw method that returns entries for each (including duplicate) header.
2. Re-introduce Headers.prototype.getAll to return multiple header values.

I have also considered…

1. Not use undici primitives within NodeJS.
2. Attempt to monkey patch undici

Additional context

1. Cloudflare implemented .getAll().
2. Node-fetch .raw() implementation
3. Tracking at WinterCG

[KhafraDev]

Headers.prototype.getSetCookie will solve this use case. I don’t think another solution would be accepted unless something is decided in the wintercg fetch group.

Deno most likely does this just because it’s better for the user; otherwise the array of set-cookie headers wouldn’t be exposed.

[KhafraDev]

The current headers implementation would need an overhaul to support this. It stores headers as strings, rather than arrays (which I believe goes against the spec) and doesn’t concat values when using .get() (as, well, they’re already strings).

I can see adding .getAll(), and like cloudflare, making it only work on set-cookie headers.

edit: Unlike a header list, a Headers object cannot represent more than one Set-Cookie header. In a way this is problematic as unlike all other headers Set-Cookie headers cannot be combined, but since Set-Cookie headers are not exposed to client-side JavaScript this is deemed an acceptable compromise. Implementations could choose the more efficient Headers object representation even for a header list, as long as they also support an associated data structure for Set-Cookie headers.

It looks like undici only needs to store set-cookie headers as arrays and instead allowing .getAll('set-cookie').