@mtkruto/node 0.0.970 → 0.0.972

package/script/deps/deno.land/std@0.196.0/assert/assert_instance_of.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertInstanceOf = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+/**
+ * Make an assertion that `obj` is an instance of `type`.
+ * If not then throw.
+ */
+function assertInstanceOf(actual, expectedType, msg = "") {
+    if (actual instanceof expectedType)
+        return;
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    const expectedTypeStr = expectedType.name;
+    let actualTypeStr = "";
+    if (actual === null) {
+        actualTypeStr = "null";
+    }
+    else if (actual === undefined) {
+        actualTypeStr = "undefined";
+    }
+    else if (typeof actual === "object") {
+        actualTypeStr = actual.constructor?.name ?? "Object";
+    }
+    else {
+        actualTypeStr = typeof actual;
+    }
+    if (expectedTypeStr == actualTypeStr) {
+        msg =
+            `Expected object to be an instance of "${expectedTypeStr}"${msgSuffix}`;
+    }
+    else if (actualTypeStr == "function") {
+        msg =
+            `Expected object to be an instance of "${expectedTypeStr}" but was not an instanced object${msgSuffix}`;
+    }
+    else {
+        msg =
+            `Expected object to be an instance of "${expectedTypeStr}" but was "${actualTypeStr}"${msgSuffix}`;
+    }
+    throw new assertion_error_js_1.AssertionError(msg);
+}
+exports.assertInstanceOf = assertInstanceOf;

package/script/deps/deno.land/std@0.196.0/assert/assert_is_error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Make an assertion that `error` is an `Error`.
+ * If not then an error will be thrown.
+ * An error class and a string that should be included in the
+ * error message can also be asserted.
+ */
+export declare function assertIsError<E extends Error = Error>(error: unknown, ErrorClass?: new (...args: any[]) => E, msgIncludes?: string, msg?: string): asserts error is E;

package/script/deps/deno.land/std@0.196.0/assert/assert_is_error.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertIsError = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+const colors_js_1 = require("../fmt/colors.js");
+/**
+ * Make an assertion that `error` is an `Error`.
+ * If not then an error will be thrown.
+ * An error class and a string that should be included in the
+ * error message can also be asserted.
+ */
+function assertIsError(error, 
+// deno-lint-ignore no-explicit-any
+ErrorClass, msgIncludes, msg) {
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    if (error instanceof Error === false) {
+        throw new assertion_error_js_1.AssertionError(`Expected "error" to be an Error object${msgSuffix}}`);
+    }
+    if (ErrorClass && !(error instanceof ErrorClass)) {
+        msg = `Expected error to be instance of "${ErrorClass.name}", but was "${typeof error === "object" ? error?.constructor?.name : "[not an object]"}"${msgSuffix}`;
+        throw new assertion_error_js_1.AssertionError(msg);
+    }
+    if (msgIncludes && (!(error instanceof Error) ||
+        !(0, colors_js_1.stripColor)(error.message).includes((0, colors_js_1.stripColor)(msgIncludes)))) {
+        msg = `Expected error message to include "${msgIncludes}", but got "${error instanceof Error ? error.message : "[not an Error]"}"${msgSuffix}`;
+        throw new assertion_error_js_1.AssertionError(msg);
+    }
+}
+exports.assertIsError = assertIsError;

package/script/deps/deno.land/std@0.196.0/assert/assert_match.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Make an assertion that `actual` match RegExp `expected`. If not
+ * then throw.
+ */
+export declare function assertMatch(actual: string, expected: RegExp, msg?: string): void;

package/script/deps/deno.land/std@0.196.0/assert/assert_match.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertMatch = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+/**
+ * Make an assertion that `actual` match RegExp `expected`. If not
+ * then throw.
+ */
+function assertMatch(actual, expected, msg) {
+    if (!expected.test(actual)) {
+        const msgSuffix = msg ? `: ${msg}` : ".";
+        msg = `Expected actual: "${actual}" to match: "${expected}"${msgSuffix}`;
+        throw new assertion_error_js_1.AssertionError(msg);
+    }
+}
+exports.assertMatch = assertMatch;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_equals.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Make an assertion that `actual` and `expected` are not equal, deeply.
+ * If not then throw.
+ *
+ * Type parameter can be specified to ensure values under comparison have the same type.
+ *
+ * @example
+ * ```ts
+ * import { assertNotEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_not_equals.ts";
+ *
+ * assertNotEquals<number>(1, 2)
+ * ```
+ */
+export declare function assertNotEquals<T>(actual: T, expected: T, msg?: string): void;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_equals.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNotEquals = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const equal_js_1 = require("./equal.js");
+const assertion_error_js_1 = require("./assertion_error.js");
+/**
+ * Make an assertion that `actual` and `expected` are not equal, deeply.
+ * If not then throw.
+ *
+ * Type parameter can be specified to ensure values under comparison have the same type.
+ *
+ * @example
+ * ```ts
+ * import { assertNotEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_not_equals.ts";
+ *
+ * assertNotEquals<number>(1, 2)
+ * ```
+ */
+function assertNotEquals(actual, expected, msg) {
+    if (!(0, equal_js_1.equal)(actual, expected)) {
+        return;
+    }
+    let actualString;
+    let expectedString;
+    try {
+        actualString = String(actual);
+    }
+    catch {
+        actualString = "[Cannot display]";
+    }
+    try {
+        expectedString = String(expected);
+    }
+    catch {
+        expectedString = "[Cannot display]";
+    }
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    throw new assertion_error_js_1.AssertionError(`Expected actual: ${actualString} not to be: ${expectedString}${msgSuffix}`);
+}
+exports.assertNotEquals = assertNotEquals;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_instance_of.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Make an assertion that `obj` is not an instance of `type`.
+ * If so, then throw.
+ */
+export declare function assertNotInstanceOf<A, T>(actual: A, unexpectedType: new (...args: any[]) => T, msg?: string): asserts actual is Exclude<A, T>;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_instance_of.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNotInstanceOf = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assert_false_js_1 = require("./assert_false.js");
+/**
+ * Make an assertion that `obj` is not an instance of `type`.
+ * If so, then throw.
+ */
+function assertNotInstanceOf(actual, 
+// deno-lint-ignore no-explicit-any
+unexpectedType, msg) {
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    msg =
+        `Expected object to not be an instance of "${typeof unexpectedType}"${msgSuffix}`;
+    (0, assert_false_js_1.assertFalse)(actual instanceof unexpectedType, msg);
+}
+exports.assertNotInstanceOf = assertNotInstanceOf;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_match.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Make an assertion that `actual` not match RegExp `expected`. If match
+ * then throw.
+ */
+export declare function assertNotMatch(actual: string, expected: RegExp, msg?: string): void;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_match.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNotMatch = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+/**
+ * Make an assertion that `actual` not match RegExp `expected`. If match
+ * then throw.
+ */
+function assertNotMatch(actual, expected, msg) {
+    if (expected.test(actual)) {
+        const msgSuffix = msg ? `: ${msg}` : ".";
+        msg =
+            `Expected actual: "${actual}" to not match: "${expected}"${msgSuffix}`;
+        throw new assertion_error_js_1.AssertionError(msg);
+    }
+}
+exports.assertNotMatch = assertNotMatch;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_strict_equals.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Make an assertion that `actual` and `expected` are not strictly equal.
+ * If the values are strictly equal then throw.
+ *
+ * ```ts
+ * import { assertNotStrictEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_not_strict_equals.ts";
+ *
+ * assertNotStrictEquals(1, 1)
+ * ```
+ */
+export declare function assertNotStrictEquals<T>(actual: T, expected: T, msg?: string): void;

package/script/deps/deno.land/std@0.196.0/assert/assert_not_strict_equals.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertNotStrictEquals = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+const _format_js_1 = require("./_format.js");
+/**
+ * Make an assertion that `actual` and `expected` are not strictly equal.
+ * If the values are strictly equal then throw.
+ *
+ * ```ts
+ * import { assertNotStrictEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_not_strict_equals.ts";
+ *
+ * assertNotStrictEquals(1, 1)
+ * ```
+ */
+function assertNotStrictEquals(actual, expected, msg) {
+    if (!Object.is(actual, expected)) {
+        return;
+    }
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    throw new assertion_error_js_1.AssertionError(`Expected "actual" to be strictly unequal to: ${(0, _format_js_1.format)(actual)}${msgSuffix}\n`);
+}
+exports.assertNotStrictEquals = assertNotStrictEquals;

package/script/deps/deno.land/std@0.196.0/assert/assert_object_match.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Make an assertion that `actual` object is a subset of `expected` object, deeply.
+ * If not, then throw.
+ */
+export declare function assertObjectMatch(actual: Record<PropertyKey, any>, expected: Record<PropertyKey, unknown>, msg?: string): void;

package/script/deps/deno.land/std@0.196.0/assert/assert_object_match.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertObjectMatch = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assert_equals_js_1 = require("./assert_equals.js");
+/**
+ * Make an assertion that `actual` object is a subset of `expected` object, deeply.
+ * If not, then throw.
+ */
+function assertObjectMatch(
+// deno-lint-ignore no-explicit-any
+actual, expected, msg) {
+    function filter(a, b) {
+        const seen = new WeakMap();
+        return fn(a, b);
+        function fn(a, b) {
+            // Prevent infinite loop with circular references with same filter
+            if ((seen.has(a)) && (seen.get(a) === b)) {
+                return a;
+            }
+            try {
+                seen.set(a, b);
+            }
+            catch (err) {
+                if (err instanceof TypeError) {
+                    throw new TypeError(`Cannot assertObjectMatch ${a === null ? null : `type ${typeof a}`}`);
+                }
+                else
+                    throw err;
+            }
+            // Filter keys and symbols which are present in both actual and expected
+            const filtered = {};
+            const entries = [
+                ...Object.getOwnPropertyNames(a),
+                ...Object.getOwnPropertySymbols(a),
+            ]
+                .filter((key) => key in b)
+                .map((key) => [key, a[key]]);
+            for (const [key, value] of entries) {
+                // On array references, build a filtered array and filter nested objects inside
+                if (Array.isArray(value)) {
+                    const subset = b[key];
+                    if (Array.isArray(subset)) {
+                        filtered[key] = fn({ ...value }, { ...subset });
+                        continue;
+                    }
+                } // On regexp references, keep value as it to avoid loosing pattern and flags
+                else if (value instanceof RegExp) {
+                    filtered[key] = value;
+                    continue;
+                } // On nested objects references, build a filtered object recursively
+                else if (typeof value === "object" && value !== null) {
+                    const subset = b[key];
+                    if ((typeof subset === "object") && (subset)) {
+                        // When both operands are maps, build a filtered map with common keys and filter nested objects inside
+                        if ((value instanceof Map) && (subset instanceof Map)) {
+                            filtered[key] = new Map([...value].filter(([k]) => subset.has(k)).map(([k, v]) => [k, typeof v === "object" ? fn(v, subset.get(k)) : v]));
+                            continue;
+                        }
+                        // When both operands are set, build a filtered set with common values
+                        if ((value instanceof Set) && (subset instanceof Set)) {
+                            filtered[key] = new Set([...value].filter((v) => subset.has(v)));
+                            continue;
+                        }
+                        filtered[key] = fn(value, subset);
+                        continue;
+                    }
+                }
+                filtered[key] = value;
+            }
+            return filtered;
+        }
+    }
+    return (0, assert_equals_js_1.assertEquals)(
+    // get the intersection of "actual" and "expected"
+    // side effect: all the instances' constructor field is "Object" now.
+    filter(actual, expected), 
+    // set (nested) instances' constructor field to be "Object" without changing expected value.
+    // see https://github.com/denoland/deno_std/pull/1419
+    filter(expected, expected), msg);
+}
+exports.assertObjectMatch = assertObjectMatch;

package/script/deps/deno.land/std@0.196.0/assert/assert_rejects.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Executes a function which returns a promise, expecting it to reject.
+ *
+ * @example
+ * ```ts
+ * import { assertRejects } from "https://deno.land/std@$STD_VERSION/assert/assert_rejects.ts";
+ *
+ * Deno.test("doesThrow", async function () {
+ *   await assertRejects(
+ *     async () => {
+ *       throw new TypeError("hello world!");
+ *     },
+ *   );
+ *   await assertRejects(
+ *     async () => {
+ *       return Promise.reject(new Error());
+ *     },
+ *   );
+ * });
+ *
+ * // This test will not pass.
+ * Deno.test("fails", async function () {
+ *   await assertRejects(
+ *     async () => {
+ *       console.log("Hello world");
+ *     },
+ *   );
+ * });
+ * ```
+ */
+export declare function assertRejects(fn: () => PromiseLike<unknown>, msg?: string): Promise<unknown>;
+/**
+ * Executes a function which returns a promise, expecting it to reject.
+ * If it does not, then it throws. An error class and a string that should be
+ * included in the error message can also be asserted.
+ *
+ * @example
+ * ```ts
+ * import { assertRejects } from "https://deno.land/std@$STD_VERSION/assert/assert_rejects.ts";
+ *
+ * Deno.test("doesThrow", async function () {
+ *   await assertRejects(async () => {
+ *     throw new TypeError("hello world!");
+ *   }, TypeError);
+ *   await assertRejects(
+ *     async () => {
+ *       throw new TypeError("hello world!");
+ *     },
+ *     TypeError,
+ *     "hello",
+ *   );
+ * });
+ *
+ * // This test will not pass.
+ * Deno.test("fails", async function () {
+ *   await assertRejects(
+ *     async () => {
+ *       console.log("Hello world");
+ *     },
+ *   );
+ * });
+ * ```
+ */
+export declare function assertRejects<E extends Error = Error>(fn: () => PromiseLike<unknown>, ErrorClass: new (...args: any[]) => E, msgIncludes?: string, msg?: string): Promise<E>;

package/script/deps/deno.land/std@0.196.0/assert/assert_rejects.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertRejects = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+const assert_is_error_js_1 = require("./assert_is_error.js");
+async function assertRejects(fn, errorClassOrMsg, msgIncludesOrMsg, msg) {
+    // deno-lint-ignore no-explicit-any
+    let ErrorClass = undefined;
+    let msgIncludes = undefined;
+    let err;
+    if (typeof errorClassOrMsg !== "string") {
+        if (errorClassOrMsg === undefined ||
+            errorClassOrMsg.prototype instanceof Error ||
+            errorClassOrMsg.prototype === Error.prototype) {
+            // deno-lint-ignore no-explicit-any
+            ErrorClass = errorClassOrMsg;
+            msgIncludes = msgIncludesOrMsg;
+        }
+    }
+    else {
+        msg = errorClassOrMsg;
+    }
+    let doesThrow = false;
+    let isPromiseReturned = false;
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    try {
+        const possiblePromise = fn();
+        if (possiblePromise &&
+            typeof possiblePromise === "object" &&
+            typeof possiblePromise.then === "function") {
+            isPromiseReturned = true;
+            await possiblePromise;
+        }
+    }
+    catch (error) {
+        if (!isPromiseReturned) {
+            throw new assertion_error_js_1.AssertionError(`Function throws when expected to reject${msgSuffix}`);
+        }
+        if (ErrorClass) {
+            if (error instanceof Error === false) {
+                throw new assertion_error_js_1.AssertionError(`A non-Error object was rejected${msgSuffix}`);
+            }
+            (0, assert_is_error_js_1.assertIsError)(error, ErrorClass, msgIncludes, msg);
+        }
+        err = error;
+        doesThrow = true;
+    }
+    if (!doesThrow) {
+        throw new assertion_error_js_1.AssertionError(`Expected function to reject${msgSuffix}`);
+    }
+    return err;
+}
+exports.assertRejects = assertRejects;

package/script/deps/deno.land/std@0.196.0/assert/assert_strict_equals.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Make an assertion that `actual` and `expected` are strictly equal. If
+ * not then throw.
+ *
+ * @example
+ * ```ts
+ * import { assertStrictEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_strict_equals.ts";
+ *
+ * Deno.test("isStrictlyEqual", function (): void {
+ *   const a = {};
+ *   const b = a;
+ *   assertStrictEquals(a, b);
+ * });
+ *
+ * // This test fails
+ * Deno.test("isNotStrictlyEqual", function (): void {
+ *   const a = {};
+ *   const b = {};
+ *   assertStrictEquals(a, b);
+ * });
+ * ```
+ */
+export declare function assertStrictEquals<T>(actual: unknown, expected: T, msg?: string): asserts actual is T;

package/script/deps/deno.land/std@0.196.0/assert/assert_strict_equals.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertStrictEquals = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const _format_js_1 = require("./_format.js");
+const assertion_error_js_1 = require("./assertion_error.js");
+const diff_js_1 = require("../_util/diff.js");
+const _constants_js_1 = require("./_constants.js");
+const colors_js_1 = require("../fmt/colors.js");
+/**
+ * Make an assertion that `actual` and `expected` are strictly equal. If
+ * not then throw.
+ *
+ * @example
+ * ```ts
+ * import { assertStrictEquals } from "https://deno.land/std@$STD_VERSION/assert/assert_strict_equals.ts";
+ *
+ * Deno.test("isStrictlyEqual", function (): void {
+ *   const a = {};
+ *   const b = a;
+ *   assertStrictEquals(a, b);
+ * });
+ *
+ * // This test fails
+ * Deno.test("isNotStrictlyEqual", function (): void {
+ *   const a = {};
+ *   const b = {};
+ *   assertStrictEquals(a, b);
+ * });
+ * ```
+ */
+function assertStrictEquals(actual, expected, msg) {
+    if (Object.is(actual, expected)) {
+        return;
+    }
+    const msgSuffix = msg ? `: ${msg}` : ".";
+    let message;
+    const actualString = (0, _format_js_1.format)(actual);
+    const expectedString = (0, _format_js_1.format)(expected);
+    if (actualString === expectedString) {
+        const withOffset = actualString
+            .split("\n")
+            .map((l) => `    ${l}`)
+            .join("\n");
+        message =
+            `Values have the same structure but are not reference-equal${msgSuffix}\n\n${(0, colors_js_1.red)(withOffset)}\n`;
+    }
+    else {
+        try {
+            const stringDiff = (typeof actual === "string") &&
+                (typeof expected === "string");
+            const diffResult = stringDiff
+                ? (0, diff_js_1.diffstr)(actual, expected)
+                : (0, diff_js_1.diff)(actualString.split("\n"), expectedString.split("\n"));
+            const diffMsg = (0, diff_js_1.buildMessage)(diffResult, { stringDiff }).join("\n");
+            message = `Values are not strictly equal${msgSuffix}\n${diffMsg}`;
+        }
+        catch {
+            message = `\n${(0, colors_js_1.red)(_constants_js_1.CAN_NOT_DISPLAY)} + \n\n`;
+        }
+    }
+    throw new assertion_error_js_1.AssertionError(message);
+}
+exports.assertStrictEquals = assertStrictEquals;

package/script/deps/deno.land/std@0.196.0/assert/assert_string_includes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Make an assertion that actual includes expected. If not
+ * then throw.
+ */
+export declare function assertStringIncludes(actual: string, expected: string, msg?: string): void;

package/script/deps/deno.land/std@0.196.0/assert/assert_string_includes.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertStringIncludes = void 0;
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+const assertion_error_js_1 = require("./assertion_error.js");
+/**
+ * Make an assertion that actual includes expected. If not
+ * then throw.
+ */
+function assertStringIncludes(actual, expected, msg) {
+    if (!actual.includes(expected)) {
+        const msgSuffix = msg ? `: ${msg}` : ".";
+        msg = `Expected actual: "${actual}" to contain: "${expected}"${msgSuffix}`;
+        throw new assertion_error_js_1.AssertionError(msg);
+    }
+}
+exports.assertStringIncludes = assertStringIncludes;

package/script/deps/deno.land/std@0.196.0/assert/assert_throws.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Executes a function, expecting it to throw. If it does not, then it
+ * throws.
+ *
+ * @example
+ * ```ts
+ * import { assertThrows } from "https://deno.land/std@$STD_VERSION/assert/assert_throws.ts";
+ *
+ * Deno.test("doesThrow", function (): void {
+ *   assertThrows((): void => {
+ *     throw new TypeError("hello world!");
+ *   });
+ * });
+ *
+ * // This test will not pass.
+ * Deno.test("fails", function (): void {
+ *   assertThrows((): void => {
+ *     console.log("Hello world");
+ *   });
+ * });
+ * ```
+ */
+export declare function assertThrows(fn: () => unknown, msg?: string): unknown;
+/**
+ * Executes a function, expecting it to throw. If it does not, then it
+ * throws. An error class and a string that should be included in the
+ * error message can also be asserted.
+ *
+ * @example
+ * ```ts
+ * import { assertThrows } from "https://deno.land/std@$STD_VERSION/assert/assert_throws.ts";
+ *
+ * Deno.test("doesThrow", function (): void {
+ *   assertThrows((): void => {
+ *     throw new TypeError("hello world!");
+ *   }, TypeError);
+ *   assertThrows(
+ *     (): void => {
+ *       throw new TypeError("hello world!");
+ *     },
+ *     TypeError,
+ *     "hello",
+ *   );
+ * });
+ *
+ * // This test will not pass.
+ * Deno.test("fails", function (): void {
+ *   assertThrows((): void => {
+ *     console.log("Hello world");
+ *   });
+ * });
+ * ```
+ */
+export declare function assertThrows<E extends Error = Error>(fn: () => unknown, ErrorClass: new (...args: any[]) => E, msgIncludes?: string, msg?: string): E;