Function minBy

  • minBy<T>(array, selector): T | undefined

  • Returns the first element that is the smallest value of the given function or undefined if there are no elements.

    Type Parameters

    • T

      The type of the elements in the array.

    Parameters

    • array: Iterable<T, any, any>

      The array to find the minimum element in.

    • selector: ((el: T) => number)

      The function to get the value to compare from each element.

        • (el): number

        • Parameters

          • el: T

          Returns number

    Returns T | undefined

    The first element that is the smallest value of the given function or undefined if there are no elements.

    Example: Basic usage

    import { minBy } from "@std/collections/min-by";
    import { assertEquals } from "@std/assert";

    const people = [
      { name: "Anna", age: 34 },
      { name: "Kim", age: 42 },
      { name: "John", age: 23 },
    ];

    const personWithMinAge = minBy(people, (i) => i.age);

    assertEquals(personWithMinAge, { name: "John", age: 23 });
  • minBy<T>(array, selector): T | undefined

  • Returns the first element that is the smallest value of the given function or undefined if there are no elements.

    Type Parameters

    • T

      The type of the elements in the array.

    Parameters

    • array: Iterable<T, any, any>

      The array to find the minimum element in.

    • selector: ((el: T) => string)

      The function to get the value to compare from each element.

        • (el): string

        • Parameters

          • el: T

          Returns string

    Returns T | undefined

    The first element that is the smallest value of the given function or undefined if there are no elements.

    Example: Basic usage

    import { minBy } from "@std/collections/min-by";
    import { assertEquals } from "@std/assert";

    const people = [
      { name: "Anna" },
      { name: "Kim" },
      { name: "John" },
    ];

    const personWithMinName = minBy(people, (person) => person.name);

    assertEquals(personWithMinName, { name: "Anna" });
  • minBy<T>(array, selector): T | undefined

  • Returns the first element that is the smallest value of the given function or undefined if there are no elements.

    Type Parameters

    • T

      The type of the elements in the array.

    Parameters

    • array: Iterable<T, any, any>

      The array to find the minimum element in.

    • selector: ((el: T) => bigint)

      The function to get the value to compare from each element.

        • (el): bigint

        • Parameters

          • el: T

          Returns bigint

    Returns T | undefined

    The first element that is the smallest value of the given function or undefined if there are no elements.

    Example: Basic usage

    import { minBy } from "@std/collections/min-by";
    import { assertEquals } from "@std/assert";

    const people = [
      { name: "Anna", age: 34n },
      { name: "Kim", age: 42n },
      { name: "John", age: 23n },
    ];

    const personWithMinAge = minBy(people, (i) => i.age);

    assertEquals(personWithMinAge, { name: "John", age: 23n });
  • minBy<T>(array, selector): T | undefined

  • Returns the first element that is the smallest value of the given function or undefined if there are no elements.

    Type Parameters

    • T

      The type of the elements in the array.

    Parameters

    • array: Iterable<T, any, any>

      The array to find the minimum element in.

    • selector: ((el: T) => Date)

      The function to get the value to compare from each element.

        • (el): Date

        • Parameters

          • el: T

          Returns Date

    Returns T | undefined

    The first element that is the smallest value of the given function or undefined if there are no elements.

    Example: Basic usage

    import { minBy } from "@std/collections/min-by";
    import { assertEquals } from "@std/assert";

    const people = [
      { name: "Anna", startedAt: new Date("2020-01-01") },
      { name: "Kim", startedAt: new Date("2020-03-01") },
      { name: "John", startedAt: new Date("2019-01-01") },
    ];

    const personWithMinStartedAt = minBy(people, (person) => person.startedAt);

Settings

Member Visibility