#augment-object

Augment selectively an object.

Object

const src = {
    a1 : 1,
    a2 : 2,
    b  : 3,
    c  : 4
};
const dst = {
    a1 : 7,
    a2 : 8
};
console.log(
    augmentObject(
        {
            filter : (name) => name[0] !== 'a'
        },
        dst,
        src
    )
); // { a1 : 7, a2 : 8, b : 3, c : 4 }

Classes

Augment selectively the prototype of a class.

Sometimes you have a class definition from other library and you need some methods of this class but there is no mixins neither multiple inheritance in JS:

class BaseClassFromMyLib {
    action()
    {
        // do action
    }
    log()
    {
        // log messages
    }
}
class ExternalClass {
    scan()
    {
        // scan files and show logs
    }
    log()
    {
        // log messages
    }
}
class MyLibClass extends BaseClassFromMyLib {
    scan()
    {
        // scan files
    }
}

In this case, we need scan (and its dependences) from ExternalClass but log (and other methods) from our base class.

Any of other libs for merging/assigning properties in npm will overwrite log from base class. So augmentObject and augmentClass was created for merging properties selectively.

class MyLibClass extends BaseClassFromMyLib {
    // Other methods
}
augmentClass(
    {
        // You can use a filter function to say when to overwrite.
        // filter : (name, dstClassProto, srcClassProto) => {
        //    // return `true` if property `name` must be overwrite.
        // }
    }, 
    MyLibClass, 
    ExternalClass/*,
    OtherClass,
    MoreOtherClass,
    etc,
    */
);

If you need call overwritten method, super.log() in example, then you need a mixin and augmentClass will not be useful.