Skip to content

poppinlp/fastify-referrer-policy

Repository files navigation

fastify-referrer-policy

Build Status Code coverage Code style Dependency Status Dev Dependency Status NPM version NPM downloads NPM license

Fastify plugin to set the Referrer-Policy HTTP header

Why?

You may know referrer-policy as a referrer-policy middleware used in helmet. And you could use it as a middleware in fastify also. So why i made this plugin?

You may find the reason in benchmark result and wish you like it. :)

Difference

This plugin has passed all referrer-policy test cases. And no difference in options.

Install

Via npm:

npm i fastify-referrer-policy

Via yarn:

yarn add fastify-referrer-policy

Usage

const fastify = require('fastify');
const fastifyReferrerPolicy = require('fastify-referrer-policy');

const app = fastify();
app.register(fastifyReferrerPolicy);

app.listen(3000, err => {
  if (err) throw err;
});

Options

This plugin has the same options as the middleware in helmet.

policy {string}

Set Referrer-Policy to this value if it's a valid one. Default is no-referrer. Will use default value for any invalid input. Valid list:

  • no-referrer
  • no-referrer-when-downgrade
  • same-origin
  • origin
  • strict-origin
  • origin-when-cross-origin
  • strict-origin-when-cross-origin
  • unsafe-url

You could read the spec for more information.

Changelog

  • 0.3.0
    • Fix can't set empty string
    • Update test case
  • 0.2.0
    • Add test case
    • Add code coverage
    • Add benchmarks
  • 0.1.0:
    • Init version

About

Fastify plugin to set the Referrer-Policy HTTP header

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published