some()

some<T>(collection, predicate): boolean

some<T>(collection, predicate): boolean

Checks if predicate returns truthy for any element of collection.

DEPRECATED

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

• Array.some() - MDN
• Browser support - Can I Use
• Object.values() - MDN
• Browser support - Can I Use

---

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.

#some#any#exists#check

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.

#validate#selection#required#form

const options = [{ selected: false }, { selected: false }];
options.some(o => o.selected);
// => false (no selection)

Check for errors

Determine if any validation errors exist.

#check#errors#validation#any

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.

#check#user#role#RBAC#authorization#access#permission

const userRoles = ["editor", "viewer"];
const requiredRoles = ["admin", "editor"];

const hasAccess = some(requiredRoles, (role) => userRoles.includes(role));
// => true (user has "editor")