A fastify plugin to close the server gracefully on SIGINT and SIGTERM signals.

• Install
• Usage
  • Default
  • Custom close timeout
  • Custom hooks
  • Plugin options
    • onSignal(signal)
    • onClose()
    • onTimeout(timeout)
    • onError(error)
• License

$ npm i @dnlup/fastify-traps

If you are using fastify 3, use the version 1 of the plugin:

$ npm i @dnlup/fastify-traps@1

const fastify = require('fastify')()
const traps = require('@dnlup/fastify-traps')

fastify.register(traps)

fastify.get('/', (request, reply) => {
  reply.send({ ok: true })
})

fastify.listen(3000)

The plugin will use the instance logger to print out some pieces of information like the signal received and if it could close the fastify instance successfully.

By default, the plugin will wait 30 seconds for the server to close. After that, it will exit the process with code 1.

You can change the value of the timeout.

const fastify = require('fastify')()
const traps = require('@dnlup/fastify-traps')

fastify.register(traps, {
  timeout: 1000 // wait 1 second before forcing exiting
})

fastify.listen(3000)

The plugin allows registering custom, synchronous functions to override the default hooks.

The context of a hook is bound to the fastify instance, so you can use this to refer to it.

const fastify = require('fastify')()
const traps = require('@dnlup/fastify-traps')

fastify.register(traps, {
  onSignal(signal) {
    this.log.debug(`Received signal ${signal}`)
  },
  onClose() {
    this.log.info('Server closed')
  },
  onTimeout(timeout) {
    this.log.error(`Forcing close after ${timeout} ms`)
  },
  onError(error) {
    this.log.error(`Uh oh: ${error.message}`)
  }
})

fastify.listen(3000)

• timeout <number>: number of milliseconds to wait for the server to close
• onSignal <function>: on signal custom hook
• onClose <function>: on signal custom hook
• onTimeout <function>: on signal custom hook
• onError <function>: on signal custom hook
• strict <boolean>: error if a SIGINT or SIGTERM handler is already registered. Default: true.

As said previously, the hooks' context is bound to the fastify instance, so you can use this to refer to it.

• signal <string>: the signal received

The plugin will call this hook when it received a SIGINT or SIGTERM signal.

The plugin will call this hook when the server is closed.

• timeout <number>: the number of milliseconds of the timeout

The plugin will call this hook when the timeout for waiting for the server to close has expired.

• error <Error|*>: the error that occurred while closing the server

The plugin will call this hook when there is an error when closing the server.

ISC