hable
Awaitable hooks for Node.js
Last updated a year ago by pi0 .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install hable 
SYNC missed versions from official npm registry.

Hable

CircleCI Codecov npm npm size

Awaitable hooks for Node.js

Install

Using yarn:

yarn add hable

Using npm:

npm install hable

Usage

Extend your base class from Hable:

import Hookable from 'hable'

export default class Foo extends Hookable {
  constructor() {
    // Call to parent to initialize
    super()
    // Initialize Hookable with custom logger
    // super(consola)
  }

  async someFunction() {
    // Call and wait for `hook1` hooks (if any) sequential
    await this.callHook('hook1')

    // Call and wait for `hook2` hooks (if any) in parallel
    await this.callHookParallel('hook2')
  }
}

Inside plugins, register for any hook:

const lib = newFooLib()

// Register a handler for `hook2`
lib.hook('hook2', async () => { /* ... */ })

// Register multiply handlers at once
lib.hookObj({
  hook1: async () => { /* ... */ },
  hook2: [ /* can be also an array */ ]
})

Hookable class

constructor(logger)

Custom logger. Default logger is console but you can use your own or consola.

It should be an object implementing following functions:

  • warn
  • error
  • fatal (optional)

hook (name, fn)

Register a handler for a specific hook. fn can be a single function or an array.

addHooks(configHooks)

Flatten and register hooks object.

Example:

hookable.addHooks({
  test: {
    before: () => {},
    after: () => {}
  }
})

This registers test:before and test:after hooks at bulk.

async callHook (name, ...args)

Used by class itself to sequentially call handlers of a specific hook.

deprecateHook (old, name)

Deprecate hook called old in favor of name hook.

deprecateHooks (deprecatedHooks)

Deprecate all hooks from an object (keys are old and values or newer ones).

clearHook (name)

Clear all hooks for a specific hook.

clearHooks ()

Clear all hooks registered in the class.

flatHooks (hooksObj)

Register many hooks using an object.

Credits

Extracted from Nuxt.js hooks system. Original author: Sébastien Chopin.

License

MIT

Current Tags

  • 3.0.0-0                                ...           beta (a year ago)
  • 3.0.0                                ...           latest (a year ago)

18 Versions

  • 3.0.0                                ...           a year ago
  • 2.3.2                                ...           a year ago
  • 2.3.1                                ...           a year ago
  • 3.0.0-0                                ...           a year ago
  • 2.3.0                                ...           a year ago
  • 2.2.1                                ...           a year ago
  • 2.2.0                                ...           a year ago
  • 2.1.0                                ...           a year ago
  • 2.0.1                                ...           a year ago
  • 2.0.0                                ...           a year ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
  • 0.0.7                                ...           3 years ago
  • 0.0.6                                ...           3 years ago
  • 0.0.5                                ...           3 years ago
  • 0.0.4                                ...           3 years ago
  • 0.0.3                                ...           3 years ago
  • 0.0.2                                ...           3 years ago
Maintainers (1)
Downloads
Today 10
This Week 1,128
This Month 14,244
Last Day 1,118
Last Week 6,162
Last Month 29,520
Dependencies (0)
None
Dev Dependencies (12)

Copyright 2014 - 2017 © taobao.org |