37 lines
1.3 KiB
JavaScript
37 lines
1.3 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 {ArrayLike<T>} arr - The array to iterate over.
|
||
|
|
* @param {(value: T, index: number, arr: ArrayLike<T>) => boolean | Partial<T> | [keyof T, unknown] | keyof T} shouldRemoveElement - The function invoked per iteration, a partial object, a property-value pair, or a key to match against each element.
|
||
|
|
* @returns {T[]} - 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 };
|