@vitest/expect 3.2.4 → 4.0.0-beta.10

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021-Present Vitest Team
+Copyright (c) 2021-Present VoidZero Inc. and Vitest contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/index.d.ts

@@ -3,14 +3,14 @@ import { stringify, Constructable } from '@vitest/utils';
 import { Formatter } from 'tinyrainbow';
 import { diff, printDiffOrStringify } from '@vitest/utils/diff';
 export { DiffOptions } from '@vitest/utils/diff';
+import * as chai from 'chai';
+export { chai };
 
 declare const MATCHERS_OBJECT: unique symbol;
 declare const JEST_MATCHERS_OBJECT: unique symbol;
 declare const GLOBAL_EXPECT: unique symbol;
 declare const ASYMMETRIC_MATCHERS_OBJECT: unique symbol;
 
-/* eslint-disable unicorn/no-instanceof-builtins -- we check both */
-
 interface AsymmetricMatcherInterface {
 	asymmetricMatch: (other: unknown) => boolean;
 	toString: () => string;
@@ -23,7 +23,6 @@ declare abstract class AsymmetricMatcher<
 > implements AsymmetricMatcherInterface {
 	protected sample: T;
 	protected inverse: boolean;
-	// should have "jest" to be compatible with its ecosystem
 	$$typeof: symbol;
 	constructor(sample: T, inverse?: boolean);
 	protected getMatcherContext(expect?: Chai.ExpectStatic): State;
@@ -43,10 +42,11 @@ declare class Anything extends AsymmetricMatcher<void> {
 	toString(): string;
 	toAsymmetricMatcher(): string;
 }
-declare class ObjectContaining extends AsymmetricMatcher<Record<string, unknown>> {
+declare class ObjectContaining extends AsymmetricMatcher<Record<string | symbol | number, unknown>> {
 	constructor(sample: Record<string, unknown>, inverse?: boolean);
 	getPrototype(obj: object): any;
-	hasProperty(obj: object | null, property: string): boolean;
+	hasProperty(obj: object | null, property: string | symbol): boolean;
+	getProperties(obj: object): (string | symbol)[];
 	asymmetricMatch(other: any): boolean;
 	toString(): string;
 	getExpectedType(): string;
@@ -77,17 +77,17 @@ declare function matcherHint(matcherName: string, received?: string, expected?:
 declare function printReceived(object: unknown): string;
 declare function printExpected(value: unknown): string;
 declare function getMatcherUtils(): {
-	EXPECTED_COLOR: Formatter
-	RECEIVED_COLOR: Formatter
-	INVERTED_COLOR: Formatter
-	BOLD_WEIGHT: Formatter
-	DIM_COLOR: Formatter
-	diff: typeof diff
-	matcherHint: typeof matcherHint
-	printReceived: typeof printReceived
-	printExpected: typeof printExpected
-	printDiffOrStringify: typeof printDiffOrStringify
-	printWithType: typeof printWithType
+	EXPECTED_COLOR: Formatter;
+	RECEIVED_COLOR: Formatter;
+	INVERTED_COLOR: Formatter;
+	BOLD_WEIGHT: Formatter;
+	DIM_COLOR: Formatter;
+	diff: typeof diff;
+	matcherHint: typeof matcherHint;
+	printReceived: typeof printReceived;
+	printExpected: typeof printExpected;
+	printDiffOrStringify: typeof printDiffOrStringify;
+	printWithType: typeof printWithType;
 };
 declare function printWithType<T>(name: string, value: T, print: (value: T) => string): string;
 declare function addCustomEqualityTesters(newTesters: Array<Tester>): void;
@@ -129,16 +129,14 @@ interface MatcherState {
 	isExpectingAssertions?: boolean;
 	isExpectingAssertionsError?: Error | null;
 	isNot: boolean;
-	// environment: VitestEnvironment
 	promise: string;
-	// snapshotState: SnapshotState
 	suppressedErrors: Array<Error>;
 	testPath?: string;
 	utils: ReturnType<typeof getMatcherUtils> & {
-		diff: typeof diff
-		stringify: typeof stringify
-		iterableEquality: Tester
-		subsetEquality: Tester
+		diff: typeof diff;
+		stringify: typeof stringify;
+		iterableEquality: Tester;
+		subsetEquality: Tester;
 	};
 	soft?: boolean;
 	poll?: boolean;
@@ -157,9 +155,6 @@ interface RawMatcherFn<
 > {
 	(this: T, received: any, ...expected: E): ExpectationResult;
 }
-// Allow unused `T` to preserve its name for extensions.
-// Type parameter names must be identical when extending those types.
-// eslint-disable-next-line
 interface Matchers<T = any> {}
 type MatchersObject<T extends MatcherState = MatcherState> = Record<string, RawMatcherFn<T>> & ThisType<T> & { [K in keyof Matchers<T>]? : RawMatcherFn<T, Parameters<Matchers<T>[K]>> };
 interface ExpectStatic extends Chai.ExpectStatic, Matchers, AsymmetricMatchersContaining {
@@ -366,6 +361,13 @@ interface JestAssertion<T = any> extends jest.Matchers<void, T>, CustomMatcher {
 	*/
 	toBeNull: () => void;
 	/**
+	* Used to check that a variable is nullable (null or undefined).
+	*
+	* @example
+	* expect(value).toBeNullable();
+	*/
+	toBeNullable: () => void;
+	/**
 	* Ensure that a variable is not undefined.
 	*
 	* @example
@@ -736,50 +738,20 @@ interface Assertion<T = any> extends VitestAssertion<Chai.Assertion, T>, JestAss
 	rejects: PromisifyAssertion<T>;
 }
 declare global {
-	// support augmenting jest.Matchers by other libraries
-	// eslint-disable-next-line ts/no-namespace
 	namespace jest {
-		// eslint-disable-next-line unused-imports/no-unused-vars, ts/no-empty-object-type
-interface Matchers<
+		interface Matchers<
 			R,
 			T = {}
 		> {}
 	}
 }
 
-// selectively ported from https://github.com/jest-community/jest-extended
 declare const customMatchers: MatchersObject;
 
-// Jest Expect Compact
 declare const JestChaiExpect: ChaiPlugin;
 
 declare const JestExtend: ChaiPlugin;
 
-/*
-Copyright (c) 2008-2016 Pivotal Labs
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-*/
-
-// Extracted out of jasmine 2.5.2
 declare function equals(a: unknown, b: unknown, customTesters?: Array<Tester>, strictCheck?: boolean): boolean;
 declare function isAsymmetric(obj: any): boolean;
 declare function hasAsymmetric(obj: any, seen?: Set<any>): boolean;
@@ -797,8 +769,8 @@ declare function generateToBeMessage(deepEqualityName: string, expected?: string
 declare function pluralize(word: string, count: number): string;
 declare function getObjectKeys(object: object): Array<string | symbol>;
 declare function getObjectSubset(object: any, subset: any, customTesters: Array<Tester>): {
-	subset: any
-	stripped: number
+	subset: any;
+	stripped: number;
 };
 
 declare function getState<State extends MatcherState = MatcherState>(expect: ExpectStatic): State;

package/dist/index.js

@@ -4,6 +4,8 @@ import c from 'tinyrainbow';
 import { isMockFunction } from '@vitest/spy';
 import { processError } from '@vitest/utils/error';
 import { use, util } from 'chai';
+import * as chai from 'chai';
+export { chai };
 
 const MATCHERS_OBJECT = Symbol.for("matchers-object");
 const JEST_MATCHERS_OBJECT = Symbol.for("$$jest-matchers-object");
@@ -339,7 +341,7 @@ function hasDefinedKey(obj, key) {
 	return hasKey(obj, key) && obj[key] !== undefined;
 }
 function hasKey(obj, key) {
-	return Object.prototype.hasOwnProperty.call(obj, key);
+	return Object.hasOwn(obj, key);
 }
 function isA(typeName, value) {
 	return Object.prototype.toString.apply(value) === `[object ${typeName}]`;
@@ -367,7 +369,7 @@ function hasProperty(obj, property) {
 	if (!obj) {
 		return false;
 	}
-	if (Object.prototype.hasOwnProperty.call(obj, property)) {
+	if (Object.hasOwn(obj, property)) {
 		return true;
 	}
 	return hasProperty(getPrototype(obj), property);
@@ -514,7 +516,7 @@ function hasPropertyInObject(object, key) {
 	if (shouldTerminate) {
 		return false;
 	}
-	return Object.prototype.hasOwnProperty.call(object, key) || hasPropertyInObject(Object.getPrototypeOf(object), key);
+	return Object.hasOwn(object, key) || hasPropertyInObject(Object.getPrototypeOf(object), key);
 }
 function isObjectWithKeys(a) {
 	return isObject(a) && !(a instanceof Error) && !Array.isArray(a) && !(a instanceof Date);
@@ -658,7 +660,7 @@ function getObjectSubset(object, subset, customTesters) {
 	};
 }
 
-if (!Object.prototype.hasOwnProperty.call(globalThis, MATCHERS_OBJECT)) {
+if (!Object.hasOwn(globalThis, MATCHERS_OBJECT)) {
 	const globalState = new WeakMap();
 	const matchers = Object.create(null);
 	const customEqualityTesters = [];
@@ -769,19 +771,33 @@ class ObjectContaining extends AsymmetricMatcher {
 		if (!obj) {
 			return false;
 		}
-		if (Object.prototype.hasOwnProperty.call(obj, property)) {
+		if (Object.hasOwn(obj, property)) {
 			return true;
 		}
 		return this.hasProperty(this.getPrototype(obj), property);
 	}
+	getProperties(obj) {
+		return [...Object.keys(obj), ...Object.getOwnPropertySymbols(obj).filter((s) => {
+			var _Object$getOwnPropert;
+			return (_Object$getOwnPropert = Object.getOwnPropertyDescriptor(obj, s)) === null || _Object$getOwnPropert === void 0 ? void 0 : _Object$getOwnPropert.enumerable;
+		})];
+	}
 	asymmetricMatch(other) {
 		if (typeof this.sample !== "object") {
 			throw new TypeError(`You must provide an object to ${this.toString()}, not '${typeof this.sample}'.`);
 		}
 		let result = true;
 		const matcherContext = this.getMatcherContext();
-		for (const property in this.sample) {
-			if (!this.hasProperty(other, property) || !equals(this.sample[property], other[property], matcherContext.customTesters)) {
+		const properties = this.getProperties(this.sample);
+		for (const property of properties) {
+			var _Object$getOwnPropert2, _Object$getOwnPropert3;
+			if (!this.hasProperty(other, property)) {
+				result = false;
+				break;
+			}
+			const value = ((_Object$getOwnPropert2 = Object.getOwnPropertyDescriptor(this.sample, property)) === null || _Object$getOwnPropert2 === void 0 ? void 0 : _Object$getOwnPropert2.value) ?? this.sample[property];
+			const otherValue = ((_Object$getOwnPropert3 = Object.getOwnPropertyDescriptor(other, property)) === null || _Object$getOwnPropert3 === void 0 ? void 0 : _Object$getOwnPropert3.value) ?? other[property];
+			if (!equals(value, otherValue, matcherContext.customTesters)) {
 				result = false;
 				break;
 			}
@@ -1241,6 +1257,10 @@ const JestChaiExpect = (chai, utils) => {
 		const obj = utils.flag(this, "object");
 		this.assert(obj === null, "expected #{this} to be null", "expected #{this} not to be null", null, obj);
 	});
+	def("toBeNullable", function() {
+		const obj = utils.flag(this, "object");
+		this.assert(obj == null, "expected #{this} to be nullish", "expected #{this} not to be nullish", null, obj);
+	});
 	def("toBeDefined", function() {
 		const obj = utils.flag(this, "object");
 		this.assert(typeof obj !== "undefined", "expected #{this} to be defined", "expected #{this} to be undefined", obj);
@@ -1264,7 +1284,7 @@ const JestChaiExpect = (chai, utils) => {
 		const actual = this._obj;
 		const [propertyName, expected] = args;
 		const getValue = () => {
-			const hasOwn = Object.prototype.hasOwnProperty.call(actual, propertyName);
+			const hasOwn = Object.hasOwn(actual, propertyName);
 			if (hasOwn) {
 				return {
 					value: actual[propertyName],
@@ -1383,7 +1403,7 @@ const JestChaiExpect = (chai, utils) => {
 	def(["toHaveBeenLastCalledWith", "lastCalledWith"], function(...args) {
 		const spy = getSpy(this);
 		const spyName = spy.getMockName();
-		const lastCall = spy.mock.calls[spy.mock.calls.length - 1];
+		const lastCall = spy.mock.calls.at(-1);
 		this.assert(lastCall && equalsArgumentArray(lastCall, args), `expected last "${spyName}" call to have been called with #{exp}`, `expected last "${spyName}" call to not have been called with #{exp}`, args, lastCall);
 	});
 	/**
@@ -1522,22 +1542,22 @@ const JestChaiExpect = (chai, utils) => {
 	[{
 		name: "toHaveLastResolvedWith",
 		condition: (spy, value) => {
-			const result = spy.mock.settledResults[spy.mock.settledResults.length - 1];
-			return result && result.type === "fulfilled" && equals(result.value, value);
+			const result = spy.mock.settledResults.at(-1);
+			return Boolean(result && result.type === "fulfilled" && equals(result.value, value));
 		},
 		action: "resolve"
 	}, {
 		name: ["toHaveLastReturnedWith", "lastReturnedWith"],
 		condition: (spy, value) => {
-			const result = spy.mock.results[spy.mock.results.length - 1];
-			return result && result.type === "return" && equals(result.value, value);
+			const result = spy.mock.results.at(-1);
+			return Boolean(result && result.type === "return" && equals(result.value, value));
 		},
 		action: "return"
 	}].forEach(({ name, condition, action }) => {
 		def(name, function(value) {
 			const spy = getSpy(this);
 			const results = action === "return" ? spy.mock.results : spy.mock.settledResults;
-			const result = results[results.length - 1];
+			const result = results.at(-1);
 			const spyName = spy.getMockName();
 			this.assert(condition(spy, value), `expected last "${spyName}" call to ${action} #{exp}`, `expected last "${spyName}" call to not ${action} #{exp}`, value, result === null || result === void 0 ? void 0 : result.value);
 		});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vitest/expect",
   "type": "module",
-  "version": "3.2.4",
+  "version": "4.0.0-beta.10",
   "description": "Jest's expect matchers as a Chai plugin",
   "license": "MIT",
   "funding": "https://opencollective.com/vitest",
@@ -30,14 +30,13 @@
   ],
   "dependencies": {
     "@types/chai": "^5.2.2",
-    "chai": "^5.2.0",
+    "chai": "^6.0.1",
     "tinyrainbow": "^2.0.0",
-    "@vitest/spy": "3.2.4",
-    "@vitest/utils": "3.2.4"
+    "@vitest/spy": "4.0.0-beta.10",
+    "@vitest/utils": "4.0.0-beta.10"
   },
   "devDependencies": {
-    "rollup-plugin-copy": "^3.5.0",
-    "@vitest/runner": "3.2.4"
+    "@vitest/runner": "4.0.0-beta.10"
   },
   "scripts": {
     "build": "rimraf dist && rollup -c",