xUnit Assertions Cheat Sheet

مرجع سریع پرکاربردترین Assertion و Attribute های xUnit. منبع کامل: xUnit.net Documentation.

دسته: Unit Testing ←مفهوم مرتبط: تست واحد (Unit Testing) ←

Attribute

نام	امضا	مثال	خروجی	کاربرد
[Fact]	[Fact]	`[Fact] public void Add_ReturnsSum() { ... }`		تعریف یک تست ساده بدون ورودی متغیر
[Theory] + [InlineData]	[Theory] [InlineData(...)]	`[Theory] [InlineData(2, 3, 5)] public void Add(int a, int b, int expected) { ... }`		اجرای یک تست با چند مجموعه ورودی مختلف

Assertion

نام	امضا	مثال	خروجی	کاربرد
Assert.Equal	Assert.Equal(expected, actual)	`Assert.Equal(5, calculator.Add(2, 3));`		بررسی برابری دو مقدار
Assert.True / False	Assert.True(condition)	`Assert.True(result.IsSuccess);`		بررسی صحت یک شرط بولی
Assert.Null / NotNull	Assert.Null(obj)	`Assert.NotNull(user);`		بررسی null بودن یا نبودن یک مقدار
Assert.Throws	Assert.Throws<T>(() => ...)	`Assert.Throws<DivideByZeroException>(() => calculator.Divide(1, 0));`		بررسی پرتاب‌شدن یک نوع Exception مشخص
Assert.Contains	Assert.Contains(item, collection)	`Assert.Contains(3, new[] { 1, 2, 3 });`		بررسی وجود یک عنصر در مجموعه
Assert.Collection	Assert.Collection(list, item1 => ..., item2 => ...)	`Assert.Collection(results, r => Assert.Equal(1, r), r => Assert.Equal(2, r));`		بررسی دقیق هر عنصر یک مجموعه به‌ترتیب

Mock (Moq)

نام	امضا	مثال	خروجی	کاربرد
mock.Setup	mock.Setup(x => x.Method()).Returns(value)	`repoMock.Setup(r => r.GetById(1)).Returns(user);`		تعریف رفتار یک وابستگی Mock‌شده
mock.Verify	mock.Verify(x => x.Method(), Times.Once)	`repoMock.Verify(r => r.Save(It.IsAny<User>()), Times.Once);`		بررسی اینکه یک متد دقیقاً چند بار صدا زده شده