@future-widget-lab/safe-ops
Version:
A set of helper functions for performing operations safely, preventing runtime errors from disrupting your application.
24 lines (23 loc) • 1.23 kB
TypeScript
import type { ErrorReport, OnError } from '../../types/errors.type';
import type { Predicate } from '../../types/find.type';
/**
* @description
* Use this helper determine whether all the members of an array satisfy the specified test.
*
* This function behaves similarly to `Array.prototype.every`, but with added error handling:
* - If the predicate throws an error for any element, the error is handled via the onError callback.
* - Collects errors in an array and returns it in the report.
* - Allows for custom error handling through the onError option.
*
* @param {Array<TInput>} collection The array of items to test.
* @param {Predicate<TInput>} predicate A function that tests each element of the array. Called once for each item in the array.
* @param {{ onError?: OnError<TInput> }} options An optional object for error handling.
*
* @returns {{ result: boolean; errors: Array<ErrorReport<TInput>> }} A report which contains the result of the test and the errors that occurred.
*/
export declare const safeEveryWithErrors: <TInput>(collection: Array<TInput>, predicate: Predicate<TInput>, options?: {
onError?: OnError<TInput>;
}) => {
result: boolean;
errors: Array<ErrorReport<TInput>>;
};