Code Monkey home page Code Monkey logo

fastify-response-time's Introduction

fastify-response-time

Build Status Coverage Status Known Vulnerabilities

Add X-Response-Time header at each request for Fastify. The unit used is milliseconds.

Add Server-Timing header, that could be used to pass timing server to client (useful to debug). You could find some documentation at W3C Server-Timing documentation.

You need to use Fastify version 0.31 or newer, the hook used (onSend) was added in this version

If you need older Fastify version, use version 1.0.1 of this plugin

Install

npm install --save fastify-response-time

Usage

Add it to you project with register and you are done!

// Register the plugin
fastify.register(require("fastify-response-time"));

// Define a new route in hapijs notation
fastify.route({
  method: "GET",
  url: "/header-hapi",
  handler: (request, reply) => {
    reply.send();
  }
});

// Define a new route in express notation
fastify.get("/header-express", (request, reply) => {
  reply.send();
});

// Add server timing information
fastify.get("/header-express", (request, reply) => {
  reply.setServerTiming("cache", 5.3, "Cache read");
  reply.send();
});

Both examples responds with:

< HTTP/1.1 200 OK
< Content-Type: application/json
< Content-Length: 17
< X-Response-Time: 0.08
< Date: Fri, 15 Sep 2017 21:14:33 GMT
< Connection: keep-alive
<

Options

This plugin allow you to specify options:

  • header can be used to change default header name to something else (X-Response-Time by default)
  • digits to specify the number of digits in the response (2 by default, so 1.03)

reply.setServerTiming usage

reply.setServerTiming( name , duration , description ) => boolean

With:

  • name: [mandatory] the name of the measure, and must be unique. Any already existing value will not be replaced
  • duration: [optional] the duration, that must be an integer or float. If not needed, pass 0 or null
  • description: [optional] the description is needed. It must be a string
  • return true if the measure is added the the list that will be send with the request, false is the name already exists

The response will be:

< HTTP/1.1 200 OK
< Content-Type: application/json
< Content-Length: 17
< X-Response-Time: 0.08
< Server-Timing: cache;dur=5.3;desc="Cache read"
< Date: Fri, 15 Sep 2017 21:14:33 GMT
< Connection: keep-alive
<

fastify-response-time's People

Contributors

lolo32 avatar millette avatar rdehouss avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.