handler-builder

Sort of like overloading, but more dynamic. Allows you to create a single handler function from a bunch of more special purpose ones. TypeScript definitions are built in.

Installation

$ npm install --save handler-builder

Example

A good use of this could be to handle Redux actions. There are two ways to do it, depending on what you like to do.

Option 1 is to use a plain JavaScript object:

import HandlerBuilder, { defaultHandlerSymbol } from 'handler-picker';

let reducerBuilder = new HandlerBuilder<string>(
  // how to decide what a call is for
  (state, action) => action.type,
  // what to do in the default case
  (state, action) => state
);

// build a function which will call the correct reducer
let todoReducer = reducerBuilder.build({
  ADD_TODO(state, action) {
    return [...state, {id: action.id, text: action.text, completed: action.completed}];
  },

  REMOVE_TODO(state, action) {
    return state.filter((todo) => todo.id !== action.id);
  },

  // this can give an instance specific default
  // overriding the default passed to the constructor, if supplied
  [defaultHandlerSymbol](state, action) {
    return state;
  }
});

// todoReducer is a reducer function
let newState = todoReducer(state, action);

Option 2 is to use the decorators on a class:

import HandlerBuilder, { handler, defaultHandler } from 'handler-picker';

let reducerBuilder = new HandlerBuilder<string>(
  // how to decide what a call is for
  (state, action) => action.type,
  // what to do in the default case
  (state, action) => state
);

// define a class with handlers in it
class TodoReducers {
  @handler('ADD_TODO')
  addTodo(state, action) {
    return [...state, {id: action.id, text: action.text, completed: action.completed}];
  }

  @handler('REMOVE_TODO')
  removeTodo(state, action) {
    return state.filter((todo) => todo.id !== action.id);
  }

  // this can give an instance specific default
  // overriding the default passed to the constructor, if supplied
  @defaultHandler
  defaultHandler(state, action) {
    return state;
  }
}

// build a function which will call the correct method on TodoReducers
let todoReducer = reducerBuilder.build(new TodoReducers());

// todoReducer is a reducer function
let newState = todoReducer(state, action);

API

HandlerBuilder class

This is the main class.

constructor(selector, defaultValue)

Constructor. The selector parameter is a function which takes the same arguments as the resulting handler function, and returns a value that descriminates which handler to call.

The defaultParameter value says what to do in the event that a matching handler is not found. If no value was provided, and there is no method marked with defaultHandler, then an exception is thrown. If a value is provided, that value is returned. If a function is provided, then the function is called with the arguments supplied to the resulting handler function, and the value returned is what is returned to the caller.

build(target)

Returns a handler function which decides which handler method on the target to call, calls it, and returns the result.

Decorators

@handler(key)

Marks the method as handling the specified descriminator value. I.e., when the handler function is called, it calls the selector function passed to the constructor, and if the value returned is the same as key, then this method is called with the same arguments.

@defaultHandler

Marks the method as handling the case where no other matching handler is found. This will take precedence over any defaultValue passed to the constructor.

Misc

defaultHandlerSymbol

When using the plain JavaScript object method, store the default handler under this key.