Skip to content

feathersjs-ecosystem/feathers-debugger-service

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Feathers Debugger Service

Debugger service for Feathers Debugger.

Intro

Feathers debugger service exposes (/feathers-debugger) endpoint that can be used.

Installation

Install package with:

yarn add feathers-debugger-service

Register Service

Register the service in app.js or services/index.js.

// app.js
const debuggerService = require('feathers-debugger-service');

const app = express(feathers());
app.configure(services);
app.hooks(hooks);

// enable it only on development
if (process.env.NODE_ENV !== 'production') {
  // the service comes with default options predefined,
  // you can override it if you wish to, see Options below
  app.configure(debuggerService());
}

Add trace() to Hooks

If you want to trace all requests, add it to app.hooks. You can also add it manually to only certain services you want to trace.

// app.hooks.js
const { trace } = require('feathers-debugger-service');
module.exports = {
  before: {
    all: [
      trace(),  // < ----- in before "all" (first item)
      // ...
    ],
  },
  // ...
  finally: {
    all: [
      trace() // < ------- in finally "all" (last item) MUST be included!
    ],
  },
};

Options

Service configuration options

app.configure(debuggerService({
  /**
   * Expire item in storage after 900 seconds (15 min)
   */
  expireAfterSeconds: 900,
  /**
   * Set filename if you want to persist data (uses feathers-nedb)
   */
  filename: 'nedb.db',
  /**
   * If you want to expose UI on publicUrl and debug without chrome extension
   */
  ui: false,
  /**
   * Set custom url for debugger, used only if ui is `true`
   */
  publicUrl: '/debugger'
}))
// hooks
trace({
  captureParams: true,  // captures hook.params, default is false (optional)
  captureResult: true,  // captures hook.result, default is false (optional)
  captureQuery: true // captures hook.params.query, default is false (optional)
})

Deploy to npm

Manually bump package.json, then push with exact version:

git commit -m "Release 1.3.6"