Express Tutorial

This tutorial shows how to use and extend the Express server.

NOTE: A body-parser middleware is used by default to decode both JSON and urlencoded data.


You can retrieve the Express server and all other related instances via the core class injected into all methods.

  • app - The Express express() instance
  • session - The Express session
  • ws - The Express WebSocket
  • httpServer - The http.Server instance


You can use the provided methods to set up routes:

const {route, routeAuthenticated} = core.make('osjs/express');

const respond = (req, res) => res.json({result: 'pong'});

// Regular route
route('GET', '/ping', respond);

// Same as above, except requires user to be authenticated
routeAuthenticated('GET', '/ping', respond);

// Same as above, but also requires user to belong to given groups
routeAuthenticated('GET', '/ping', respond, ['admin']);

NOTE: If you want to add routes in the index.js distro file, use the .on('init') event on the core instance.


You can access the session via req.session.


See Application tutorial on how to attach your applications to the server.

results matching ""

    No results matching ""