pullAllBy

arrays

This method is like pullAll except that it accepts iteratee which is invoked for each element of array and values to generate the criterion by which they're compared.

Try in Playground

Installation

Import

import { pullAllBy } from '@tulx/utils';

Source Code

Implementation

/**
 * This method is like pullAll except that it accepts iteratee which is invoked for each element
 * of array and values to generate the criterion by which they're compared.
 *
 * @param array - The array to modify.
 * @param values - The values to remove.
 * @param iteratee - The iteratee invoked per element.
 * @returns The modified array.
 *
 * @example
 * ```ts
 * const array = [{ 'x': 1 }, { 'x': 2 }, { 'x': 3 }, { 'x': 1 }];
 * pullAllBy(array, [{ 'x': 1 }, { 'x': 3 }], 'x');
 * // [{ 'x': 2 }]
 * ```
 */
export function pullAllBy<T>(
  array: T[],
  values: readonly T[],
  iteratee: ((value: T) => unknown) | string
): T[] {
  const getValue =
    typeof iteratee === 'string'
      ? (item: T) => (item as Record<string, unknown>)[iteratee]
      : iteratee;

  const valueKeys = new Set(values.map((value) => getValue(value)));
  let writeIndex = 0;
  for (let i = 0; i < array.length; i++) {
    if (!valueKeys.has(getValue(array[i]))) {
      array[writeIndex] = array[i];
      writeIndex++;
    }
  }
  array.length = writeIndex;
  return array;
}

Example

import { pullAllBy } from '@tulx/utils';

const array = [{ 'x': 1 }, { 'x': 2 }, { 'x': 3 }, { 'x': 1 }];
pullAllBy(array, [{ 'x': 1 }, { 'x': 3 }], 'x');
// [{ 'x': 2 }]

Related Functions

chunk

Creates an array of elements split into groups the length of size. If array can't be split evenly, the final chunk will be the remaining elements.

compact

Creates an array with all falsy values removed. The values false, null, 0, "", undefined, and NaN are falsy.

concat

Creates a new array concatenating array with any additional arrays and/or values.

difference

Creates an array of array values not included in the other given arrays. The order and references of result values are determined by the first array.

differenceBy

This method is like difference except that it accepts iteratee which is invoked for each element of array and values to generate the criterion by which they're compared.

differenceWith

This method is like difference except that it accepts comparator which is invoked to compare elements of array to values.