ix/src/iterable/min.ts

The Interactive Extensions for JavaScript

import { equalityComparer } from '../util/comparer.js';
import { identity } from '../util/identity.js';
import { ExtremaOptions } from './extremaoptions.js';

/**
 *  * Returns the minimum element with the optional selector.
 *
 * @template TSource The type of the elements in the source sequence.
 * @param {Iterable<TSource>} source An iterable sequence to determine the minimum element of.
 * @param {ExtremaByOptions<TKey>} [options] The options which include an optional comparer.
 * @returns {TResult} The minimum element.
 */
export function min<TSource, TResult = TSource>(
  source: Iterable<TSource>,
  options?: ExtremaOptions<TSource, TResult>
): TResult {
  const { ['comparer']: comparer = equalityComparer, ['selector']: selector = identity } =
    options || {};

  const it = source[Symbol.iterator]();
  let next = it.next();

  if (next.done) {
    throw new Error('Sequence contains no elements');
  }

  let minValue = selector(next.value);

  while (!(next = it.next()).done) {
    const current = selector(next.value);
    if (comparer(current, minValue) < 0) {
      minValue = current;
    }
  }

  return minValue;
}