es-toolkit/dist/set/some.js

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

//#region src/set/some.ts
/**
* Tests whether at least one element in a Set satisfies the provided predicate function.
*
* This function iterates through the elements of the Set and checks if the predicate function
* returns true for at least one element. It returns true if any element satisfies the predicate,
* and false otherwise.
*
* @template T - The type of elements in the Set.
* @param set - The Set to test.
* @param doesMatch - A predicate function that tests each element.
* @returns true if at least one element satisfies the predicate, false otherwise.
*
* @example
* const set = new Set([1, 2, 3]);
* const result = some(set, (value) => value > 2);
* // result will be: true
*
* const result2 = some(set, (value) => value > 5);
* // result2 will be: false
*/
function some(set, doesMatch) {
	for (const value of set) if (doesMatch(value, value, set)) return true;
	return false;
}
//#endregion
exports.some = some;