pols-utils - v5.3.11
    Preparing search index...

    Function extract

    • Extracts (removes and returns) all elements in an array that match the given logical selector.

      Type Parameters

      • T

        The type of elements in the array.

      • K = T

        The return type of the transformation function, if provided.

      Parameters

      • array: T[]

        the target array to search and mutate.

      • logicalSelector: PLogicalSelector<T>

        The selector used to identify the matching element. This can be either a predicate function or an object for property-based matching.

      • Optionaltransform: (element: T, i: number) => K

        A function to transform the selected element before returning it.

      Returns K[]

      A new array with all matching elements, optionally transformed. If no match is found, an empty array is returned.

      const pets = [
      { type: 'dog', name: 'Fido' },
      { type: 'dog', name: 'Chacalin' },
      { type: 'cat', name: 'Mr. Brown' },
      { type: 'cat', name: 'Night' },
      ]
      console.log(PUtilsArray.extractOne(pets, pet => pet.type === 'dog'))
      // => [
      // { type: 'dog', name: 'Fido' },
      // { type: 'dog', name: 'Chacalin' },
      // ]

      console.log(pets)
      // => [
      // { type: 'cat', name: 'Mr. Brown' },
      // { type: 'cat', name: 'Night' },
      // ]