Function transform

  • An alternative to reduce this method transforms object to a new accumulator object which is the result of running each of its own enumerable string keyed properties thru iteratee, with each invocation potentially mutating the accumulator object. If accumulator is not provided, a new object with the same [[Prototype]] will be used. The iteratee is invoked with four arguments: (accumulator, value, key, object). Iteratee functions may exit iteration early by explicitly returning false.

    Type Parameters

    • T

    Parameters

    • object: Collection<T>

      The object to iterate over.

    • iteratee: AccCollectionIteratee<T>

      The function invoked per iteration.

    • accumulator: any

      The custom accumulator value.

    Returns any

    Returns the accumulated value.

    Since

    5.11.0

    See

    [[reduce]], [[reduceRight]]

    Example

    transform([2, 3, 4], (result, n) => {
    result.push(n *= n)
    return n % 2 == 0
    }, [])
    // => [4, 9]

    transform({ 'a': 1, 'b': 2, 'c': 1 }, (result, value, key) => {
    (result[value] || (result[value] = [])).push(key)
    }, {})
    // => { '1': ['a', 'c'], '2': ['b'] }