forked from projectmoon/tenebrous-dicebot
70 lines
1.2 KiB
Markdown
70 lines
1.2 KiB
Markdown
|
# mimic-fn [](https://travis-ci.org/sindresorhus/mimic-fn)
|
||
|
|
|
||
|
|
> Make a function mimic another one
|
||
|
|
|
||
|
|
Useful when you wrap a function in another function and like to preserve the original name and other properties.
|
||
|
|
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```
|
||
|
|
$ npm install mimic-fn
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```js
|
||
|
|
const mimicFn = require('mimic-fn');
|
||
|
|
|
||
|
|
function foo() {}
|
||
|
|
foo.unicorn = '🦄';
|
||
|
|
|
||
|
|
function wrapper() {
|
||
|
|
return foo();
|
||
|
|
}
|
||
|
|
|
||
|
|
console.log(wrapper.name);
|
||
|
|
//=> 'wrapper'
|
||
|
|
|
||
|
|
mimicFn(wrapper, foo);
|
||
|
|
|
||
|
|
console.log(wrapper.name);
|
||
|
|
//=> 'foo'
|
||
|
|
|
||
|
|
console.log(wrapper.unicorn);
|
||
|
|
//=> '🦄'
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## API
|
||
|
|
|
||
|
|
It will copy over the properties `name`, `length`, `displayName`, and any custom properties you may have set.
|
||
|
|
|
||
|
|
### mimicFn(to, from)
|
||
|
|
|
||
|
|
Modifies the `to` function and returns it.
|
||
|
|
|
||
|
|
#### to
|
||
|
|
|
||
|
|
Type: `Function`
|
||
|
|
|
||
|
|
Mimicking function.
|
||
|
|
|
||
|
|
#### from
|
||
|
|
|
||
|
|
Type: `Function`
|
||
|
|
|
||
|
|
Function to mimic.
|
||
|
|
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [rename-fn](https://github.com/sindresorhus/rename-fn) - Rename a function
|
||
|
|
- [keep-func-props](https://github.com/ehmicky/keep-func-props) - Wrap a function without changing its name, length and other properties
|
||
|
|
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT © [Sindre Sorhus](https://sindresorhus.com)
|