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.