Security News
JavaScript Leaders Demand Oracle Release the JavaScript Trademark
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
The 'onetime' npm package is designed to ensure a function can only be called once. It is useful for initialization routines, event handlers, or any other situation where a function should only execute a single time and subsequent calls should either return the result of the first call or throw an error.
Ensuring a function is only called once
This feature allows you to wrap a function with 'onetime' to ensure it can only be executed once. Subsequent calls to the function will have no effect.
const onetime = require('onetime');
const initialize = onetime(() => {
console.log('Initialization complete.');
});
initialize(); // 'Initialization complete.'
initialize(); // No output, function not called again
Throwing an error on subsequent calls
This feature allows you to configure 'onetime' to throw an error if the function is attempted to be called more than once, which can be useful for debugging.
const onetime = require('onetime');
const doOnce = onetime(() => {
console.log('Done once.');
}, {throw: true});
doOnce(); // 'Done once.'
try {
doOnce(); // Throws an Error because the function was already called.
} catch (e) {
console.error(e.message); // 'Function can only be called once.'
}
Checking if a function has been called
This feature provides a way to check if the onetime-wrapped function has been called, which can be useful for conditional logic based on whether the initialization or setup has already been performed.
const onetime = require('onetime');
const onceFn = onetime(() => {});
console.log(onetime.called(onceFn)); // false
onceFn();
console.log(onetime.called(onceFn)); // true
The 'once' package is similar to 'onetime' in that it ensures a function can only be called once. The main difference is in the API and additional features that 'once' might provide, such as the ability to clear the once wrapper and allow the function to be called again.
Provided by the popular Lodash library, 'lodash.once' is a function that ensures a given function can only be called once. It is similar to 'onetime' but comes as part of the larger Lodash utility library, which might be preferable if you are already using Lodash in your project.
Ensure a function is only called once
When called multiple times it will return the return value from the first call.
Unlike the module once, this one isn't naughty and extending Function.prototype
.
npm install onetime
import onetime from 'onetime';
let index = 0;
const foo = onetime(() => ++index);
foo(); //=> 1
foo(); //=> 1
foo(); //=> 1
onetime.callCount(foo); //=> 3
import onetime from 'onetime';
const foo = onetime(() => {}, {throw: true});
foo();
foo();
//=> Error: Function `foo` can only be called once
Returns a function that only calls fn
once.
Type: Function
The function that should only be called once.
Type: object
Type: boolean
Default: false
Throw an error when called more than once.
Returns a number representing how many times fn
has been called.
Note: It throws an error if you pass in a function that is not wrapped by onetime
.
import onetime from 'onetime';
const foo = onetime(() => {});
foo();
foo();
foo();
console.log(onetime.callCount(foo));
//=> 3
Type: Function
The function to get call count from.
FAQs
Ensure a function is only called once
The npm package onetime receives a total of 57,572,236 weekly downloads. As such, onetime popularity was classified as popular.
We found that onetime demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In an open letter, JavaScript community leaders urge Oracle to give up the JavaScript trademark, arguing that it has been effectively abandoned through nonuse.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.