UNPKG

@future-widget-lab/safe-ops

Version:

A set of helper functions for performing operations safely, preventing runtime errors from disrupting your application.

23 lines (22 loc) 1.18 kB
import type { ErrorReport, OnError } from '../../types/errors.type'; import type { Reducer } from '../../types/reduce.type'; /** * @description * Use this helper to create an accumulated result given an array and an initial value. * - If the reducer 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 to reduce. * @param {Reducer<TInput, TOutput>} reducer A function that processes each element. * @param {TOutput} initialValue The initial value for the accumulator. * @param {{ onError?: OnError<TInput> }} options Optional error handling configuration. * * @returns {{ result: TOutput; errors: Array<ErrorReport<TInput>> }} An object containing the accumulated result and any errors encountered. */ export declare const safeReduceWithErrors: <TInput, TOutput>(collection: Array<TInput>, reducer: Reducer<TInput, TOutput>, initialValue: TOutput, options?: { onError?: OnError<TInput>; }) => { result: TOutput; errors: Array<ErrorReport<TInput>>; };