jarradseers/method-missing

Method Missing class for es6+

Method Missing Class

The method missing handler class is simple to use, simply extend it from your es6 class (or base class) and you are able to handle the missing methods.

It defaults to using a method on your class __call(name, args) however you can chage this behaviour.

Method missing also works with singletons and other objects, please see the examples below.

MethodMissing is used in the extends-classes project allowing for the extension of multiple classes.

Usage

Include the MethodMissing class:

const MethodMissing = require('method-missing');

Standard inheritance example:

class Simple extends MethodMissing {

  __call(name, args) {
    console.log(`The method '${name}' was called with:`, args);
  }

}

const simple = new Simple();
simple.nonExistent('Hello!');
// The method 'nonExistent' was called with: [ 'Hello!' ]

Static only example:

class Simple {

  static __call(name, args) {
    console.log(`The method '${name}' was called with:`, args);
  }

}

Simple = MethodMissing.static(Simple);

// Call the static method.
Simple.nonExistentStatic(1, 2, 3);
// The method 'nonExistentStatic' was called with: [ 1, 2, 3 ]

Complete example:

class Simple extends MethodMissing {

  iExist(str) {
    console.log(`I do exist ${str}.`);
  }

  __call(name, args) {
    console.log(`The method '${name}' was called with:`, args);
  }

  static __call(name, args) {
    console.log(`The method '${name}' was called with:`, args);
  }

}

Simple = MethodMissing.static(Simple);

const simple = new Simple();

simple.nonExistent('hello');
simple.iExist('world');
Simple.nonExistentStatic('hey');
// The method 'nonExistent' was called with: [ 'hello' ]
// I do exist world.
// The method 'nonExistentStatic' was called with: [ 'hey' ]

Used on an object:

const object = MethodMissing.static({
  one: function() {
    console.log('hey there');
  }
}, (name, args) => {
  console.log(`Sorry, method '${name}' doesn't exist.`, args);
});

object.one();
object.two();

// hey there
// Sorry, method 'two' doesn't exist. []

Check out the test folder for more!

Installation

$ npm install method-missing

Features

• Capture missing methods in your class.
• Simple, fast, light-weight with no external dependencies.
• Easy to use in existing projects (particularly if you already extend es6 classes from a base class).
• Written in ES6+ for node.js 6+.
• Clean solution to method missing.

Options

Changing the __call method (if you must, just be careful with this).

class Test extends MethodMissing {

  constructor() {
    super('missing');
  }

  missing(name, args) {
    console.log(`The method '${name}' was called with:`, args);
  }

  static missing(name, args) {
    console.log(`The method '${name}' was called with:`, args);
  }

}

Test = MethodMissing.static(Test, 'missing');

const test = new Test();

test.nonExistent('hello');
test.nonExistentStatic('world');
// The method 'nonExistent' was called with: [ 'hello' ]
// The method 'nonExistentStatic' was called with: [ 'world' ]

Tests

From the package

$ npm test

License

MIT