NeXTSTEP Programming Mastermind
    Have ideas to improve npm?Join in the discussion! »

    extend-bases
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.3 • Public • Published

    extend-bases: A simple library for multiple inheritance in JavaScript.

    This library can be used to achieve multiple inheritance in JavaScript, but it sets itself apart from other libraries for multiple inheritance because it isolates the base classes and prevents the properties and methods from colliding, while still allowing easy access to the properties and methods of the base classes.

    Installation

    Simply run:

    npm add extend-bases
    

    Or:

    yarn add extend-bases
    

    To import:

    import {bases, defineProperties, isInstanceOf} from "extend-bases";

    Or:

    const {bases, defineProperties, isInstanceOf} = require("extend-bases");

    Getting started

    To inherit from multiple bases simply extend from bases(Class1, Class2, ...). In the constructor pass the instances of the classes to the super constructor.

    Then you can access the base properties and methods directly from this., the first class with that property or method will be given precedence.

    To access a particular base use this.bases[index].

    Replace all instances of v instanceof Class with isInstanceOf(v, Class), it’s just that simple.

    For more details

    • Read the Handy manual, it’s very simple & small and gives enough information to get started.
    • Then read the Documentation. it’s not too big and easy to go through.
    • Then, if you have enough time or are interested, read the tests and source code of the project.

    Implementation details

    This library uses Proxies, so sadly no IE11 support, but otherwise this library also imports es-shims for Reflect.ownKeys(ES6 but used very often and an es-shim exists for it) and Array.prototype.flatMap(ES2019, very new), which were found to be the bottlenecks, for some browsers.

    This library uses proxies for easy access in the class instances, and it merges the prototypes of the base classes, but for isolation of base classes it creates a new function wrapping the method call. It’s just best to look at the source code for this.

    TypeScript support

    The library is by default written in TypeScript, which you all should be using if you aren’t, for great code completion. The details of the TypeScript definitions are a bit fiddly, so it’s best not to worry about them, they work, or you can just look at the source code.

    Contributing

    Feel free to open a pull request, fix bugs, or read the source code. It’s all up to you.

    Install

    npm i extend-bases

    DownloadsWeekly Downloads

    1

    Version

    1.0.3

    License

    MIT

    Unpacked Size

    41.2 kB

    Total Files

    12

    Last publish

    Collaborators

    • avatar