Skip to main content
Deno 2 is finally 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.217.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

Examples

Example 1

import { minBy } from "https://deno.land/std@0.217.0/collections/min_by.ts";
import { assertEquals } from "https://deno.land/std@0.217.0/assert/assert_equals.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: Iterable<T>
selector: (el: T) => number

Returns

T | undefined

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

Examples

Example 1

import { minBy } from "https://deno.land/std@0.217.0/collections/min_by.ts";

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

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

Parameters

array: Iterable<T>
selector: (el: T) => string

Returns

T | undefined

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

Examples

Example 1

import { minBy } from "https://deno.land/std@0.217.0/collections/min_by.ts";
import { assertEquals } from "https://deno.land/std@0.217.0/assert/assert_equals.ts";

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

Parameters

array: Iterable<T>
selector: (el: T) => bigint

Returns

T | undefined

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

Examples

Example 1

import { minBy } from "https://deno.land/std@0.217.0/collections/min_by.ts";

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, (i) => i.startedAt);

Parameters

array: Iterable<T>
selector: (el: T) => Date

Returns

T | undefined