GitHub iconEdit on GitHub

Logging Headers

Console-logging Headers

TL;DR: Use a Map if you just need to log a Headers object to the console:

console.log(new Map(request.headers))

Use the spread operator if you need to quickly stringify a Headers object:

let requestHeaders = JSON.stringify([...request.headers])

The Problem

When debugging Worker scripts, we often want to examine the headers on a request or response. A common pitfall is to try to log headers to the developer console via code like this:


or this:

console.log(`Request headers: ${JSON.stringify(request.headers)}`)

Both result in what appears to be an empty object --- the string {} --- even though calling request.headers.has('Your-Header-Name') might return true. This is the same behavior that browsers implement.

The reason this happens is because Headers objects do not store headers in enumerable JavaScript properties, so the developer console and JSON stringifier do not know how to read the names and values of the headers. It's not an empty object per se, but rather an opaque object.

Headers objects are iterable, however, which we can take advantage of to develop a couple quick one-liners for debug-printing headers.

Pass Headers objects through a Map

The first common idiom for making Headers console.log()-friendly is to construct a Map object from the Headers object, and log the Map object.

console.log(new Map(request.headers))

This works because:

  • Map objects can be constructed from iterables, like Headers.

  • The Map object does store its entries in an enumerable JavaScript property, so the developer console can see into it.

Spread Headers into an array

The Map trick works great for simple calls to console.log(), but if we need to actually stringify our headers, we quickly find out that stringifying a Map yields nothing more than [object Map], which isn't very helpful.

The JSON stringifier can't help us, either: even though our Map stores its data in an enumerable property, that property is Symbol-keyed, and JSON.stringify() ignores Symbol-keyed properties --- we end up with an empty {} again.

Instead, we can take advantage of the iterability of the Headers object in a new way by applying the spread operator (...) to it.

let requestHeaders = JSON.stringify([...request.headers], null, 2)
console.log(`Request headers: ${requestHeaders}`)

This results in something like:

Request headers: [
  // ...

While not as elegant as object literal syntax, this is certainly readable and useful for debugging purposes.