36 lines
1.2 KiB
JavaScript
36 lines
1.2 KiB
JavaScript
import { remove as remove$1 } from "../../array/remove.mjs";
|
|
import { identity } from "../../function/identity.mjs";
|
|
import { iteratee } from "../util/iteratee.mjs";
|
|
//#region src/compat/array/remove.ts
|
|
/**
|
|
* Removes elements from an array based on various criteria.
|
|
*
|
|
* @param arr - The array to iterate over.
|
|
* @param shouldRemoveElement - The function invoked per iteration, a partial object, a property-value pair, or a key to match against each element.
|
|
* @returns Returns the modified array with the specified elements removed.
|
|
*
|
|
* @example
|
|
* // Using a predicate function
|
|
* const numbers = [1, 2, 3, 4, 5];
|
|
* remove(numbers, value => value % 2 === 0); // => [1, 3, 5]
|
|
*
|
|
* @example
|
|
* // Using a partial object
|
|
* const objects = [{ a: 1 }, { a: 2 }, { a: 3 }];
|
|
* remove(objects, { a: 1 }); // => [{ a: 2 }, { a: 3 }]
|
|
*
|
|
* @example
|
|
* // Using a property-value pair
|
|
* const objects = [{ a: 1 }, { a: 2 }, { a: 3 }];
|
|
* remove(objects, ['a', 1]); // => [{ a: 2 }, { a: 3 }]
|
|
*
|
|
* @example
|
|
* // Using a property key
|
|
* const objects = [{ a: 0 }, { a: 1 }];
|
|
* remove(objects, 'a'); // => [{ a: 0 }]
|
|
*/
|
|
function remove(arr, shouldRemoveElement = identity) {
|
|
return remove$1(arr, iteratee(shouldRemoveElement));
|
|
}
|
|
//#endregion
|
|
export { remove };
|