some()
some<
T>(collection,predicate):boolean
some<
T>(collection,predicate):boolean
Checks if predicate returns truthy for any element of collection.
Use array.some() or Object.values().some() directly instead.
Type Parameters
T: T
The type of elements in the array, or the object type.
Parameters
Overload 1:
collection: T[]
The collection to iterate over.
predicate: (value, index, array) => boolean
The function invoked per iteration.
Overload 2:
collection: T
The collection to iterate over.
predicate: (value, key, object) => boolean
The function invoked per iteration.
Returns: boolean
true if any element passes the predicate check, else false.
See Also
Since
2.0.0
Also known as
any (Ramda) · some (Lodash, es-toolkit, Effect) · ❌ (Remeda, Radashi, Modern Dash, Antfu)
Example
const numbers = [1, 2, 3, 4, 5];
// ❌ Deprecated approach
const hasEven = some(numbers, n => n % 2 === 0);
console.log(hasEven); // true
// ✅ Recommended approach (for arrays)
const hasEvenNative = numbers.some(n => n % 2 === 0);
console.log(hasEvenNative); // true
// ✅ Recommended approach (for objects)
const obj = { a: 1, b: 2, c: 3 };
const hasEvenObj = Object.values(obj).some(n => n % 2 === 0);
console.log(hasEvenObj); // true
How it works?
Checks if any element passes the predicate.
Deprecated: Use array.some() directly.
Native Equivalent
// ❌ some(arr, fn)
// ✅ arr.some(fn)
Use Cases
Check if any item matches 📌
Check if at least one element satisfies a condition.
const users = [{ admin: false }, { admin: true }, { admin: false }];
users.some(u => u.admin);
// => true
Validate at least one selection
Ensure at least one option is selected.
const options = [{ selected: false }, { selected: false }];
options.some(o => o.selected);
// => false (no selection)
Check for errors
Determine if any validation errors exist.
const fields = [{ error: null }, { error: "Required" }, { error: null }];
fields.some(f => f.error !== null);
// => true
Check if user has a required role
Verify that a user holds at least one of the required roles for access control. Fundamental pattern for role-based authorization in any application.
const userRoles = ["editor", "viewer"];
const requiredRoles = ["admin", "editor"];
const hasAccess = some(requiredRoles, (role) => userRoles.includes(role));
// => true (user has "editor")