class-wrapper

{class}

The main goal of this library is to automate some construction routines, that a developer is usually writing by himself, and to provide more flexibility to create new classes. This library supplies:

• ClassBuilder - is the main wrapper that realizes the inheritance, data encapsulation, stores the default values and in result it returns a class. This builder is useful to define custom pre-construction routines by setting the class constructor template.
• Class - is a ClassBuilder with already predefined construction routines. The resulting behavior of how the objects are constructing is similar to the behaviour in C++ - all parent constructors are executing first, starting from the root parent constructor, only then the constructor of the class will be executed. With this there is no need to always explicitly call the parent constructor in each constructor function and pass there all the arguments. The constructor function can contain only the effective code that is needed for a new class.
• Interface - is a simple builder of interfaces, that will be passed into Class under property Implements. It allows to extend some parent interface.

Defined class properties are treated as default values for a new instance and they are isolated between instances. For example, if some class has a simple object in properties (Object or Array), then each instance will have its own copy of that object.

Requirements

• ES6 classes
• Spread operator (...)
• Function.prototype.bind
• Array.prototype.forEach
• Array.prototype.some

If this library is planned to be used on some environments which are not passing the requirements, then please use v1.x (even transpilers will not help).

Installation

$ npm install class-wrapper --save

Then just import the required component, for example Class.

import {Class} from 'class-wrapper';

or

const {Class} = require('class-wrapper/dest/class-wrapper.amd');

Usage examples

Example can be found in example.js.

To see it in live, create an empty folder and copy example.js file there. Install class-wrapper package:

npm i class-wrapper

and run the example

node example.js

Links

• wiki
• API
• Run unit tests
• Code coverage report