@patrtorg/libero-doloribus-omnis

2.1.15 • Public • Published

@patrtorg/libero-doloribus-omnis

Tests npm version npm downloads

Generates UUID for ExpressJS requests. Add an id property to the Request object.

Install

npm install --save @patrtorg/libero-doloribus-omnis

Basic Usage

import express from 'express';
import expressRequestId from '@patrtorg/libero-doloribus-omnis';
const PORT = 3000;
app.use(expressRequestId());

app.get('/', function (req, res, next) {
  console.log('Res id: %s', res.get('X-Request-Id'));
  return res.send(req.id);
});

app.listen(PORT, function() {
  console.log('Listening on port %d', PORT);
});

// curl localhost:3000
// Res id: e462be8c-5641-4b37-99c1-b0f16b859d2a
// e462be8c-5641-4b37-99c1-b0f16b859d2a

Custom Options Usage

import express from 'express';
import expressRequestId, { Options } from '@patrtorg/libero-doloribus-omnis';
const PORT = 3000;
const options: Options = {
  headerName: 'pizza-id',
  setHeader: false,
  generator: () => `pizza_${Math.random()}`;
};
app.use(expressRequestId(options));

app.get('/', function (req, res, next) {
  console.log('Res id: %s', res.get('pizza-id'));
  return res.send(req.id);
});

app.listen(PORT, function() {
  console.log('Listening on port %d', PORT);
});

// curl localhost:3000
// Response id: undefined
// pizza_0.36206992526026704

Options

Property Type Default Value Description
headerName string 'X-Request-Id' Defines name of header, that should be used for request ID checking and setting.
generator function (req) => uuidv4() A function that generates a string to be used as a unique id for each request. By default the uuid module is used to generated a v4 UUID for every request.
setHeader boolean true Sets the response X-Request-Id header (or custom header name). If false response header will not be set.

Package Sidebar

Install

npm i @patrtorg/libero-doloribus-omnis

Weekly Downloads

4,435

Version

2.1.15

License

MIT

Unpacked Size

11.8 kB

Total Files

16

Last publish

Collaborators

  • minhtran645176