std/assert/assert_not_instance_of.ts
Yoshiya Hinosawa 47c38498eb
docs(assert): improve docs (#4876)
Co-authored-by: Asher Gomez <ashersaupingomez@gmail.com>
2024-05-30 11:38:16 +09:00

34 lines
1.1 KiB
TypeScript

// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
// This module is browser compatible.
import { assertFalse } from "./assert_false.ts";
/**
* Make an assertion that `obj` is not an instance of `type`.
* If so, then throw.
*
* @example Usage
* ```ts no-eval
* import { assertNotInstanceOf } from "@std/assert/assert-not-instance-of";
*
* assertNotInstanceOf(new Date(), Number); // Doesn't throw
* assertNotInstanceOf(new Date(), Date); // Throws
* ```
*
* @typeParam A The type of the object to check.
* @typeParam T The type of the class to check against.
* @param actual The object to check.
* @param unexpectedType The class constructor to check against.
* @param msg The optional message to display if the assertion fails.
*/
export function assertNotInstanceOf<A, T>(
actual: A,
// deno-lint-ignore no-explicit-any
unexpectedType: new (...args: any[]) => T,
msg?: string,
): asserts actual is Exclude<A, T> {
const msgSuffix = msg ? `: ${msg}` : ".";
msg =
`Expected object to not be an instance of "${typeof unexpectedType}"${msgSuffix}`;
assertFalse(actual instanceof unexpectedType, msg);
}