" class="reference-link">wrapme

Functions to wrap other functions and fields/methods and to change/enhance their behavior, functionality or usage.
Can be used for Aspect-oriented programming.

Features

• Wrap a single function/field/method (by wrap) or several fields and methods at once (by intercept).
• Wrap only field’s get operation (get option) or set operation (set option), or both (by default).
• Provide special getter and/or setter for wrapped field if it is necessary.
• Call original function/method or field’s operation before (use before or listen option),
  after (use after option) and/or inside handler (use run() or runApply()).
• Totally control calling of original function/method or field’s operation inside handler:
  call depending on condition, filter/validate/convert passed arguments and/or provide another arguments.
• Return result of original function/method or field’s operation, or any other value from handler.
• Save necessary data between handler calls.
• Restore original fields/methods when it is needed.
• Does not have dependencies and can be used in ECMAScript 5+ environment.
• Small size.

import { intercept } from 'wrapme';
const api = {
    sum(...numList) {
        let result = 0;
        for (let value of numList) {
            result += value;
        }
        return result;
    },
    // Other methods
    // ...
};
// Logging
const log = [];
function logger(callData) {
    log.push({
        name: callData.field,
        args: callData.arg,
        result: callData.result,
        callNum: callData.number,
        time: new Date().getTime()
    });
}
const unwrap = intercept(api, 'sum', logger, {listen: true});
api.sum(1, 2, 3, 4);   // Returns 10, adds item to log
api.sum(1, -1, 2, -2, 3);   // Returns 3, adds item to log
// Restore original method
unwrap();

See more examples below.

Table of contents

• Installation
• Usage
• Examples
• API
• Related projects
• Inspiration
• Contributing
• License

Installation ↑

Node

npm install wrapme

AMD,