46 lines
2.0 KiB
JavaScript
46 lines
2.0 KiB
JavaScript
import { property } from "../object/property.mjs";
|
|
import { matches } from "../predicate/matches.mjs";
|
|
import { matchesProperty } from "../predicate/matchesProperty.mjs";
|
|
import { identity } from "../function/identity.mjs";
|
|
//#region src/compat/array/findIndex.ts
|
|
/**
|
|
* Finds the index of the first item in an array that has a specific property, where the property name is provided as a PropertyKey.
|
|
*
|
|
* @template T
|
|
* @param {ArrayLike<T> | null | undefined} arr - The array to search through.
|
|
* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
|
|
* @param {PropertyKey} propertyToCheck - The property name to check for in the items of the array.
|
|
* @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
|
|
* @returns {number} - The index of the first item that has the specified property, or `-1` if no match is found.
|
|
*
|
|
* @example
|
|
* // Using a property name
|
|
* const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
|
|
* const result = findIndex(items, 'name');
|
|
* console.log(result); // 0
|
|
*/
|
|
function findIndex(arr, doesMatch = identity, fromIndex = 0) {
|
|
if (!arr) return -1;
|
|
if (fromIndex < 0) fromIndex = Math.max(arr.length + fromIndex, 0);
|
|
const subArray = Array.from(arr).slice(fromIndex);
|
|
let index = -1;
|
|
switch (typeof doesMatch) {
|
|
case "function":
|
|
index = subArray.findIndex(doesMatch);
|
|
break;
|
|
case "object":
|
|
if (Array.isArray(doesMatch) && doesMatch.length === 2) {
|
|
const key = doesMatch[0];
|
|
const value = doesMatch[1];
|
|
index = subArray.findIndex(matchesProperty(key, value));
|
|
} else index = subArray.findIndex(matches(doesMatch));
|
|
break;
|
|
case "number":
|
|
case "symbol":
|
|
case "string": index = subArray.findIndex(property(doesMatch));
|
|
}
|
|
return index === -1 ? -1 : index + fromIndex;
|
|
}
|
|
//#endregion
|
|
export { findIndex };
|