Skip to content

Middleware for setting the NEL HTTP response header

License

Notifications You must be signed in to change notification settings

nexwork-percy/network-error-logging

 
 

Repository files navigation

Network Error Logging

npm version dependencies Status Actions Status Coverage Status FOSSA Status

This is Express middleware to set the NEL HTTP response header. You can read more about it here.

To use:

const NEL = require('network-error-logging')

// ...

app.use(NEL({
  report_to: 'endpoint-1', // REQUIRED to register. OPTIONAL if intention is to remove a previous registration. defined in the Report-To header
  max_age: 31_536_000, // REQUIRED. seconds
  include_subdomains: true, // OPTIONAL
  success_fraction: 0.5, // OPTIONAL. sampling rate
  failure_fraction: 0.5, // OPTIONAL. sampling rate
  request_headers: ["If-None-Match"], // OPTIONAL. request headers whose names and values are included in the network error reports
  response_headers: ["ETag"] // OPTIONAL. response headers whose names and values are included in the network error reports
}))

For further documentation on each field, see https://w3c.github.io/network-error-logging/#nel-response-header.

This header is best set with a previously defined Report-To group. This module is a great way to do that.

https://report-uri.com/ is a great reporting platform for monitoring CSP, NEL, etc. error logs.

License

FOSSA Status

About

Middleware for setting the NEL HTTP response header

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 57.4%
  • TypeScript 42.6%