Trace

Examples
Documentation
FAQ

Examples

basic.js
timers.js
http.js

trace
clarify


    const crypto = require('crypto');
    const fs = require('fs');

    fs.readFile(__filename, function () {
      crypto.randomBytes(256, function () {
        process.nextTick(function () {
          throw new Error('custom error');
        });
      });
    });

$ node --stack_trace_limit=100 -r trace -r clarify wired.js


    /trace/showcases/basic.js:7
          throw new Error('custom error');
          ^

    Error: custom error
        at /trace/showcases/basic.js:7:13
        at InternalFieldObject.ondone (/trace/showcases/basic.js:6:13)
        at /trace/showcases/basic.js:5:10
        at Object.<anonymous> (/trace/showcases/basic.js:4:4)

Documentation

To activate trace simply add require('trace') to the beginning of your program. clarify works similarly.


      require('trace');
      require('clarify');

      const crypto = require('crypto');
      const fs = require('fs');

      fs.readFile(__filename, function () {
        crypto.randomBytes(256, function () {
          process.nextTick(function () {
            throw new Error('custom error');
          });
        });
      });

Recent node versions also supports the -r flag, which does the same thing.

Error.stackTraceLimit

To set the number of lines (call sites) in the stack trace set this value. This can be any number (default 10) or Infinity.


    Error.stackTraceLimit = 100

This is a build in v8 feature (https://github.com/v8/v8/wiki/Stack-Trace-API) that can also be set using the --stack_trace_limit=100 flag.