What Are Fastify.js Lifecycle Hooks and How to Use Them?

Introduction to Fastify.js Lifecycle Hooks

Fastify.js, the high-performance Node.js-based web framework, stands out with its modularity and speed. One of Fastify.js's most powerful features, which offers developers advanced API and flexibility, is the lifecycle hook mechanism. Fastify.js lifecycle hooks allow you to interfere with your application logic throughout the process from receiving a request to sending a response. In this article, we will thoroughly discuss what Fastify.js lifecycle hooks are, why they are used, and how they are applied with examples.

Basics of Fastify.js Lifecycle Hooks

Fastify.js lifecycle hooks provide the ability to fine-tune HTTP requests. Each hook gets triggered at different stages of the request. For example, the onRequest hook captures incoming requests, while with preHandler you can add custom controls just before the handler. These hooks are ideal for managing tasks such as logging, authentication, validation, and many other functions in a centralized and repeatable way. The most frequently used Fastify.js lifecycle hooks are:

• onRequest: Triggered when the request reaches the server.
• preParsing: Runs before the body is parsed for the first time.
• preValidation: Engages before the data reaches the handler.
• preHandler: Processed immediately before the router handler.
• preSerialization: Called before the response is serialized.
• onSend: Engages before the response is sent.
• onResponse: Runs after the response is sent.

Examples of Using Fastify.js Lifecycle Hooks

Let's immediately see how to define and use Fastify.js lifecycle hooks. With a simple example, let's add the onRequest and preHandler hooks:

const fastify = require('fastify')();

// onRequest hook: Runs on every incoming request
fastify.addHook('onRequest', async (request, reply) => {
  console.log('I saw an incoming request:', request.raw.url);
});

// preHandler hook: Let's check the user before the handler
fastify.addHook('preHandler', async (request, reply) => {
  if(!request.headers['authorization']) {
    reply.code(401).send({ error: 'Unauthorized access!' });
  }
});

fastify.get('/', async (request, reply) => {
  return { message: 'Hello Fastify!' };
});

fastify.listen({ port: 3000 }, err => {
  if (err) throw err;
  console.log('Server is running on port 3000');
});

In the code above, thanks to Fastify.js lifecycle hooks, we ensured logging for all requests and prevented unauthorized access to the API. Every hook supports async, and you can change the application's behavior in the hooked functions.

Conclusion: Easy Management with Fastify.js Lifecycle Hooks

Fastify.js lifecycle hooks are one of the most effective ways to provide flexibility and centralized control in modern web applications. They can be actively used to avoid code repetition for common needs such as API security, logging, and data validation. For more information about Fastify.js lifecycle hooks, you can check out the official Fastify documentation.