github-pages-deploy-action/node_modules/onetime/readme.md

66 lines
998 B
Markdown
Raw Normal View History

2020-01-28 13:07:56 +08:00
# onetime [![Build Status](https://travis-ci.org/sindresorhus/onetime.svg?branch=master)](https://travis-ci.org/sindresorhus/onetime)
> Ensure a function is only called once
When called multiple times it will return the return value from the first call.
2020-03-07 11:45:40 +08:00
*Unlike the module [once](https://github.com/isaacs/once), this one isn't naughty extending `Function.prototype`.*
2020-01-28 13:07:56 +08:00
## Install
```
2020-03-07 11:45:40 +08:00
$ npm install --save onetime
2020-01-28 13:07:56 +08:00
```
## Usage
```js
let i = 0;
2020-03-07 11:45:40 +08:00
const foo = onetime(() => i++);
2020-01-28 13:07:56 +08:00
foo(); //=> 0
foo(); //=> 0
foo(); //=> 0
```
```js
const foo = onetime(() => {}, {throw: true});
foo();
foo();
//=> Error: Function `foo` can only be called once
```
## API
### onetime(fn, [options])
Returns a function that only calls `fn` once.
#### fn
Type: `Function`
Function that should only be called once.
#### options
Type: `Object`
##### throw
Type: `boolean`<br>
Default: `false`
Throw an error when called more than once.
## License
MIT © [Sindre Sorhus](https://sindresorhus.com)