Go to Latest
function findSingle
import { findSingle } from "https://dotland.deno.dev/std@0.181.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.

Examples

Example 1

import { findSingle } from "https://deno.land/std@0.181.0/collections/find_single.ts";
import { assertEquals } from "https://deno.land/std@0.181.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[]
predicate: (el: T) => boolean

Returns

T | undefined