feat: deprecateHooks

README.md

@@ -101,7 +101,11 @@ Used by class itself to **sequentially** call handlers of a specific hook.
 
 ### `deprecateHook (old, name)`
 
-Deprecate hook called `old` in flavor of `name` hook.
+Deprecate hook called `old` in favor of `name` hook.
+
+### `deprecateHooks (hooks)`
+
+Deprecate all hooks from an object (keys are old and values or newer ones).
 
 ### `clearHook (name)`
 

lib/hookable.js

@@ -28,6 +28,12 @@ module.exports = class Hookable {
     this._deprecatedHooks[old] = name
   }
 
+  deprecateHooks (deprecations) {
+    Object.entries(deprecations).forEach(([old, name]) => {
+      this.deprecateHook(old, name)
+    })
+  }
+
   addHooks (configHooks) {
     const hooks = flatHooks(configHooks)
     for (const key in hooks) {

test/hookable.test.js

@@ -57,6 +57,19 @@ describe('core: hookable', () => {
     expect(hook._hooks['test:before']).toEqual([expect.any(Function)])
   })
 
+  test('deprecateHooks', () => {
+    const hook = new Hookable()
+    hook.deprecateHooks({
+      'test:hook': 'test:before'
+    })
+
+    hook.hook('test:hook', () => { })
+
+    expect(console.warn).toBeCalledWith('test:hook hook has been deprecated, please use test:before')
+    expect(hook._hooks['test:hook']).toBeUndefined()
+    expect(hook._hooks['test:before']).toEqual([expect.any(Function)])
+  })
+
   test('should call registered hook', async () => {
     const hook = new Hookable()
     hook.hook('test:hook', () => console.log('test:hook called'))