Super light wrapper around async-hooks to collect information about resources created during async operations.
Last updated 4 years ago by thlorenz .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install ah-collector 
SYNC missed versions from official npm registry.


Super light wrapper around async-hooks to collect information about resources created during async operations.

const ActivityCollector = require('ah-collector')

function captureStack(hook, { uid, type, triggerId }, resource) {
  // Predicate to decide if a stack should be captured or not.
  // Capture only inits of the TIMERWRAP but everything of the Timeout.
  return type === 'Timeout' || (type === 'TIMERWRAP' && hook === 'init')

const collector = new ActivityCollector({
    start: process.hrtime()
  , captureStack

setTimeout(ontimeout, 100)

function ontimeout() {


Needs async hooks feature, therefore build from this PR for now.

EPS document

Documentation in progress


npm install ah-collector



Creates an instance of an ActivityCollector


  • $0 Object
    • $0.start Array<Number> start time obtained via process.hrtime()
    • $0.stackCapturer StackCapturer? which is used to decide if a stack should be captured as well as to capture and process it @see thlorenz/ah-stack-capturer The default capturer used doesn't ever capture a stack so this feature is turned off by default. (optional, default defaultStackCapturer)
    • $0.requireInit boolean? when true any activities whose init hook we missed are ignored even if we see before, after and/or destroy hooks. (optional, default false)

Returns ActivityCollector instance of ActivityCollector


Enables the collection of async hooks. Needs to be called as otherwise nothing will be collected.

Returns ActivityCollector activityCollector


Disables the collection of async hooks. Nothing will be collected until activityCollector.enable() is called.

Returns ActivityCollector activityCollector


Clears all currently collected activity.

Returns ActivityCollector activityCollector


Returns an Array of all activities collected so far that are of the specified type(s).


Returns Array activities matching the specified type(s)


A getter that returns a map of all activities collected so far.

Returns Map activities


A getter that returns an Array of all activities collected so far.

Returns Array activities


Processes all stacks that were captured for specific activities This is done in line, i.e. the actual stacks of the activity objects are modified.

Returns ActivityCollector activityCollector


Dumps all so far collected activities to the console. This is useful for diagnostic purposes.

If no arguments are provided, all activities are dumped.


  • opts Object allow tweaking which activities are dumped and how
    • opts.types (Array<String> | String) type(s) to dump
    • opts.stage String the stage to print as the title of the dump
    • opts.depth Number the depth with which the dumped object is dumped

Returns ActivityCollector activityCollector


Dumps all types in the order they were collected including id and trigger id.

Example: FSREQWRAP:id:triggerId


Static getter that denotes the type given to activities whose type is unkown since we missed their init event.



Current Tags

  • 0.0.6                                ...           latest (4 years ago)

6 Versions

  • 0.0.6                                ...           4 years ago
  • 0.0.5                                ...           4 years ago
  • 0.0.4                                ...           4 years ago
  • 0.0.3                                ...           4 years ago
  • 0.0.2                                ...           4 years ago
  • 0.0.1                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 0
Last Month 1
Dependencies (1)
Dev Dependencies (1)
Dependents (2)

Copyright 2014 - 2016 © taobao.org |