Skip to main content
Go to Latest
function findSingle
import { findSingle } from "https://deno.land/std@0.113.0/collections/find_single.ts";

Returns an element if and only if that element is the only one matching the given condition. Returns undefined otherwise.

Example:

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

const bookings = [
    { month: 'January', active: false },
    { month: 'March', active: false },
    { month: 'June', active: true },
];
const activeBooking = findSingle(bookings, (it) => it.active);
const inactiveBooking = findSingle(bookings, (it) => !it.active);

assertEquals(activeBooking, { month: "June", active: true });
assertEquals(inactiveBooking, undefined); // there are two applicable items

Parameters

array: readonly T[]
optional
predicate: (el: T) => boolean = [UNSUPPORTED]

Returns

T | undefined