@naturalcycles/js-lib 14.143.0 → 14.144.1

package/dist/error/try.d.ts

@@ -57,3 +57,7 @@ export declare function _expectedError<ERR = Error>(fn: AnyFunction, errorClass?
  * 2. It does `instanceof` check and throws if wrong Error instance was thrown.
  */
 export declare function pExpectedError<ERR = Error>(promise: Promise<any>, errorClass?: Class<ERR>): Promise<ERR>;
+/**
+ * Shortcut function to simplify error snapshot-matching in tests.
+ */
+export declare function pExpectedErrorString<ERR = Error>(promise: Promise<any>, errorClass?: Class<ERR>): Promise<string>;

package/dist/error/try.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pExpectedError = exports._expectedError = exports.UnexpectedPassError = exports.pTry = exports._try = void 0;
+exports.pExpectedErrorString = exports.pExpectedError = exports._expectedError = exports.UnexpectedPassError = exports.pTry = exports._try = void 0;
+const stringifyAny_1 = require("../string/stringifyAny");
 const app_error_1 = require("./app.error");
 /**
  * Calls a function, returns a Tuple of [error, value].
@@ -109,3 +110,10 @@ async function pExpectedError(promise, errorClass) {
     }
 }
 exports.pExpectedError = pExpectedError;
+/**
+ * Shortcut function to simplify error snapshot-matching in tests.
+ */
+async function pExpectedErrorString(promise, errorClass) {
+    return (0, stringifyAny_1._stringifyAny)(await pExpectedError(promise, errorClass));
+}
+exports.pExpectedErrorString = pExpectedErrorString;

package/dist-esm/error/try.js

@@ -1,3 +1,4 @@
+import { _stringifyAny } from '../string/stringifyAny';
 import { AppError } from './app.error';
 /**
  * Calls a function, returns a Tuple of [error, value].
@@ -101,3 +102,9 @@ export async function pExpectedError(promise, errorClass) {
         return err; // this is expected!
     }
 }
+/**
+ * Shortcut function to simplify error snapshot-matching in tests.
+ */
+export async function pExpectedErrorString(promise, errorClass) {
+    return _stringifyAny(await pExpectedError(promise, errorClass));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.143.0",
+  "version": "14.144.1",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/error/try.ts

@@ -1,3 +1,4 @@
+import { _stringifyAny } from '../string/stringifyAny'
 import type { Class } from '../typeFest'
 import type { AnyFunction } from '../types'
 import { AppError } from './app.error'
@@ -113,3 +114,13 @@ export async function pExpectedError<ERR = Error>(
     return err as ERR // this is expected!
   }
 }
+
+/**
+ * Shortcut function to simplify error snapshot-matching in tests.
+ */
+export async function pExpectedErrorString<ERR = Error>(
+  promise: Promise<any>,
+  errorClass?: Class<ERR>,
+): Promise<string> {
+  return _stringifyAny(await pExpectedError<ERR>(promise, errorClass))
+}