class-action

Class Action

This is a simple library for creating composable functions. It helps to create methods or functions that may need to be modified later without introducing performance issues from multiple code compilation.

A class action is simply an object with a local action method and an optional list of reaction objects which are also ClassAction instances. Not only can reactions be added or removed later and nested to any depth, but the classes can be extended and composed freely to achieve whatever effect we want. We have used class-action as the primary abstraction for implementing a transparent and extensible reactivity system in element-action.

Installation

npm i class-action

Usage

import { ClassAction } from "class-action";
class MyClassAction extends ClassAction {
    constructor(value, ...reactions) {
        super(...reactions);
        this.value = value;
    }
    doAction(context) {
        context.value = (context.value || 0) + this.value;
    }
}

const myClassAction = new MyClassAction(5, new MyClassAction(2), new MyClassAction(7));
const myContext = { };
myClassAction.act(myContext);
console.log(myContext);   // prints 14
myClassAction.act(myContext);
console.log(myContext);   // prints 28
myClassAction.reactions.splice(0, 1);
myClassAction.act(myContext);
console.log(myContext.value);   // prints 40

Documentation

This library exports a single class with a very simple API which can be picked up in a few minutes here.

Contributing

Help improve Class-action by contributing to this project. You can contribute in many ways. See the contributing guidelines. You can also show your support by sponsoring us.

Thank you for contributing.

Sponsors

...