Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Interactive debug console
CSS JavaScript Handlebars Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
images
lib
templates
test
.gitignore
.travis.yml
LICENSE
Makefile
README.md
index.js
package.json

README.md

tv Logo

Interactive debug console plugin for hapi

Build Status

The debug console is a simple web page in which developers can subscribe to a debug id (or * for all), and then include that debug id as an extra query parameter with each request. The server will use WebSocket to stream the subscribed request logs to the web page in real-time. To enable the debug console in a hapi application, install tv and require it using either the 'composer' configuration or with the 'plugin' interface. Below is an example of incuding tv using the 'plugin' interface:

var Hapi = require('hapi');

var server = new Hapi.Server();
var options = {
  webSocketPort: 3000,
  debugEndpoint: '/debug/console',
  queryKey: 'debug'
};

server.plugin.require('./tv', options, function (err) {

  if (!err) {
    server.start();
  }
});

Debug

The debug console is a simple web page in which developers can subscribe to a debug id, and then include that debug id as an extra query parameter in each request. The server will use WebSockets to stream the subscribed request logs to the web page in real-time. In applications using multiple server instances, only one server can enable the debug interface using the default port. Below are the options available to be passed into the tv plugin:

  • websocketPort - the port used by the WebSocket connection. Defaults to 3000.
  • debugEndpoint - the debug console request path added to the server routes. Defaults to '/debug/console'.
  • queryKey - the name or the request query parameter used to mark requests being debugged. Defaults to debug.
Something went wrong with that request. Please try again.