Skip to content

some

predicates
Source Code | Documentation

See also: hooks/iff hooks/iffElse predicates/every predicates/not

Returns a predicate that is true when any of the given predicates is true (logical OR). Supports both sync and async predicates. Short-circuits on the first true result. Undefined predicates in the list are skipped.

ts
  import { 
some
} from 'feathers-utils/predicates';

Example

ts
import { iff, some, isProvider } from 'feathers-utils/predicates'

app.service('users').hooks({
  before: { all: [iff(some(isProvider('rest'), isProvider('socketio')), rateLimitHook())] }
})

Hooks for predicates

HookDescription
iff

Conditionally executes a series of hooks when the predicate is truthy. The predicate can be a boolean value or a sync/async function. Supports an .else(...) chain for the falsy branch. Also exported as when.

iffElse

Executes one array of hooks when the predicate is truthy, or another array when it is falsy. The predicate can be a boolean or a sync/async function. Unlike iff, both branches are provided upfront without chaining.

skippable

Wraps a hook so it can be conditionally skipped based on a predicate. When the predicate returns true, the wrapped hook is skipped entirely. Commonly used with shouldSkip and addSkip for runtime hook control.

throwIf

Throws a BadRequest error when the given predicate function returns true. The predicate receives the hook context and can be async. Useful for validating conditions before proceeding with a request.

unless

Executes a series of hooks when the predicate is falsy --- the inverse of iff. The predicate can be a boolean or a sync/async function. Useful for applying hooks to all contexts except those matching a condition.

Type declaration

Show Type Declarations
ts
/**
 * Returns a predicate that is `true` when **any** of the given predicates is `true` (logical OR).
 * Supports both sync and async predicates. Short-circuits on the first `true` result.
 * Undefined predicates in the list are skipped.
 *
 * @example
 * ```ts
 *
 *
 * app.service('users').hooks({
 *   before: { all: [iff(some(isProvider('rest'), isProvider('socketio')), rateLimitHook())] }
 * })
 * ```
 *
 * @see https://utils.feathersjs.com/predicates/some.html
 */
export declare const some: <H extends HookContext = HookContext>(
  ...predicates: (PredicateFn<H> | undefined)[]
) => PredicateFn<H>
ArgumentTypeDescription
predicates(PredicateFn<H> | undefined)[]

Released under the MIT License.