Function maxBy

maxBy<TElement, TKey>(
    source: Iterable<TElement>,
    keySelector: Selector<TElement, TKey>,
    comparator?: OrderComparator<TKey, TKey>,
): TElement
Returns the element whose projected key is greatest according to the provided comparator.
Type Parameters
- TElement
  Type of elements within the source iterable.
- TKey
  Type of key produced by keySelector.
Parameters
- source: Iterable<TElement>
  The source iterable.
- keySelector: Selector<TElement, TKey>
  Selector used to project each element to the key used for comparison.
- Optionalcomparator: OrderComparator<TKey, TKey>
  Optional order comparator used to compare keys. Defaults to the library's standard order comparison when omitted.
Returns TElement
The element whose key is maximal.
Throws
Thrown when the sequence is empty.

Remarks
When multiple elements share the maximal key, the first such element in the sequence is returned.
Example
```
const people = [
  { name: 'Alice', age: 25 },
  { name: 'Bob', age: 30 },
  { name: 'Charlie', age: 28 },
];
const oldestPerson = maxBy(people, p => p.age);
console.log(oldestPerson); // { name: 'Bob', age: 30 }
```
- Defined in src/enumerator/functions/maxBy.ts:26