Advanced Routes

If you need to implement a route that uses an HTTP method other than GET, you can use an advanced route definition.

import joystick from '@joystick.js/node';

joystick.app({
  routes: {
    '/': {
      method: 'GET',
      handler: (req = {}, res = {}) => {
        return res.status(200).send('Howdy');
      }
    },
  },
});

Instead of assigning a callback function to your route, assign an object. On that object, specify either a single method option as a string (can be one of OPTIONS, HEAD, CONNECT, GET, POST, PUT, DELETE, or PATCH), or, to support multiple methods on a single route a methods option, set to an array of HTTP methods as strings.

Your route's callback should be assigned to the handler property. The behavior here is identical to a basic route definition.

Route Middleware

If you need to run route-specific middleware, advanced route definitions support the addition of a middleware array containing standard Express middleware functions.

import joystick from '@joystick.js/node';
import custom_middleware from 'middleware-package';

joystick.app({
  routes: {
    '/': {
      methods: ['POST', 'PUT'],
      middleware: [
        custom_middleware,
        (req = {}, res = {}, next = {}) => {
          if (!req.body) {
            return res.redirect('/404');
          }
         
          next();
        }
      ],
      handler: (req = {}, res = {}) => {
        return res.status(200).send('Howdy');
      }
    },
  },
});

API Reference

Route Definition API

{
  [route_path: string]: {
    method: string,
    methods: array[string],
    middleware: array[function],
    handler: (req: object, res: object) => void,
  }
}

Parameters