Skip to main content
The Deno 2 Release Candidate is here
Learn more
Module

std/collections/min_by.ts>minBy

Deno standard library
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
function minBy
import { minBy } from "https://deno.land/std@0.145.0/collections/min_by.ts";

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.145.0/collections/min_by.ts";
import { assertEquals } from "https://deno.land/std@0.145.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 });

Parameters

array: readonly T[]
selector: (el: T) => number

Returns

T | undefined

Parameters

array: readonly T[]
selector: (el: T) => string

Returns

T | undefined

Parameters

array: readonly T[]
selector: (el: T) => bigint

Returns

T | undefined

Parameters

array: readonly T[]
selector: (el: T) => Date

Returns

T | undefined

Parameters

array: readonly T[]
selector:
| ((el: T) => number)
| ((el: T) => string)
| ((el: T) => bigint)
| ((el: T) => Date)

Returns

T | undefined