Find One Item

Finds the first item matching specified criteria using optimized search strategies.

`findOne()`

Finds the first item matching specified criteria using optimized search strategies.

findOne(
  matcher: string | number,
  keySelector: KeySelector<T>,
  options?: FindOptions<T>
): T | undefined

Parameter	Type	Description
`matcher`	`string \| number`	Value to match against.
`keySelector`	`KeySelector<T>`	Property name or value extractor function.
`options`	`FindOptions<T>`	Search configuration options.

T | undefined — First matching item or undefined if none found.

playground.ts

Cache First: Checks cache if cacheKey is provided.
Search Strategies:
- Linear search for small datasets (less than 100 items).
- Binary search for larger sorted datasets.
- Fuzzy search when enabled and no exact match.
Result Caching: Stores successful finds when cacheKey is specified.

Performance: Uses cache when available (O(1) lookup). Falls back to linear search for small datasets (O(n)) or binary search for large sorted datasets (O(\log n)). Fuzzy search is O(n) when enabled.
Cache Behavior: Cache entries expire after 5 minutes by default. Cache is automatically cleared when the dataset changes.
String Matching: Case-insensitive by default. Exact matching unless fuzzy is true.
Sorting: Sorts data automatically when needSorting is true. Skips sorting when data is already sorted.