maxBy | /collections/max_by.ts | std@0.206.0

Module

std/collections/max_by.ts>maxBy

Deno standard library

denoland/deno_std

Go to Latest

mod.ts (default module)

binary_search_node.ts

BinarySearchNode

Direction

binary_search_tree.ts

first_not_nullish_of.ts

unstable_binary_heap.ts

BinaryHeap

unstable_binary_search_tree.ts

BinarySearchTree

unstable_comparators.ts

ascend

descend

unstable_red_black_tree.ts

The Standard Library has been moved to JSR. See the blog post for details.

function maxBy

import { maxBy } from "https://deno.land/std@0.206.0/collections/max_by.ts";

maxBy<T>(array: Iterable<T>, selector: (el: T) => number): T | undefined

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

maxBy<T>(array: Iterable<T>, selector: (el: T) => string): T | undefined

maxBy<T>(array: Iterable<T>, selector: (el: T) => bigint): T | undefined

maxBy<T>(array: Iterable<T>, selector: (el: T) => Date): T | undefined

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

Examples

Example 1

import { maxBy } from "https://deno.land/std@0.206.0/collections/max_by.ts";
import { assertEquals } from "https://deno.land/std@0.206.0/assert/assert_equals.ts";

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

const personWithMaxAge = maxBy(people, (i) => i.age);

assertEquals(personWithMaxAge, { name: "Kim", age: 42 });