minBy | /collections/mod.ts | std@0.116.0

function minBy

import { minBy } from "https://dotland.deno.dev/std@0.116.0/collections/mod.ts";

minBy<T>(array: readonly T[], selector: (el: T) => number): T | undefined

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

minBy<T>(array: readonly T[], selector: (el: T) => string): T | undefined

minBy<T>(array: readonly T[], selector: (el: T) => bigint): T | undefined

minBy<T>(array: readonly T[], selector: (el: T) => Date): T | undefined

minBy<T>(array: readonly T[], selector:

| ((el: T) => number)

| ((el: T) => string)

| ((el: T) => bigint)

| ((el: T) => Date)

): T | undefined

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

Example:

import { minBy } from "https://deno.land/std@0.116.0/collections/mod.ts";
import { assertEquals } from "https://deno.land/std@0.116.0/testing/asserts.ts"

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 });

| ((el: T) => bigint)

| ((el: T) => Date)

Returns

T | undefined