SparkyTestHelpers.AspNetMvc.Core 2.1.0

.NET Standard 2.0
There is a newer version of this package available.
See the version list below for details.
Install-Package SparkyTestHelpers.AspNetMvc.Core -Version 2.1.0
dotnet add package SparkyTestHelpers.AspNetMvc.Core --version 2.1.0
<PackageReference Include="SparkyTestHelpers.AspNetMvc.Core" Version="2.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SparkyTestHelpers.AspNetMvc.Core --version 2.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: SparkyTestHelpers.AspNetMvc.Core, 2.1.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install SparkyTestHelpers.AspNetMvc.Core as a Cake Addin
#addin nuget:?package=SparkyTestHelpers.AspNetMvc.Core&version=2.1.0

// Install SparkyTestHelpers.AspNetMvc.Core as a Cake Tool
#tool nuget:?package=SparkyTestHelpers.AspNetMvc.Core&version=2.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

see also:


Controller Action test helpers

ControllerTester<TController>

Instantiation:

using SparkyTestHelpers.AspNetMvc
    var homeController = new HomeController(/* with test dependencies */);
    var controllerTester = new ControllerTester<HomeController>(homeController);

It doesn't do anything on its own - just provides an Action(actionDefinitionExpression) method that's used to create a...

ControllerActionTester

    var controllerActionTester = 
        new ControllerTester<HomeController>(homeController).Action(x => x.Index);

The .Action method argument is an expression for either a synchronous or async controller action method.

ControllerActionTester has several .Test... methods used to assert that the controller action returns the expected IActionResult implementation. There are methods for all of the standard result types, plus the generic TestResult<TActionResultType> method:

  • .TestContent(Action<ContentResult> validate)
  • .TestEmpty(Action<EmptyResult> validate)
  • .TestFile(Action<FileResult> validate)
  • .TestJson(Action<JsonResult> validate)
  • .TestPartialView(Action<PartialViewResult> validate)
  • .TestRedirectToAction(string expecteActionName, string expectedControllerName, object expectedRouteValues, Action<RedirectToRouteResult> validate)
  • .TestRedirectToPage(string expectedPageName, Action<RedirectToPageResult> validate)
  • .TestRedirectToRoute(string expectedRoute, Action<RedirectToRouteResult> validate)
  • .TestView(Action<ViewResult> validate)
  • .TestResult<TActionResultType>(Action<TActionResultType> validate)

Additional methods:

  • .ExpectingViewName(string expectedViewName) - used with .TestView and .TestPartialView
  • .ExpectingModel<TModelType>(Action<TModelType> validate) - used with .TestView and .TestJson
  • WhenModelStateIsValidEquals(bool isValid) - used to test conditional logic based on ModelState.IsValid

All validate "callback" actions shown above are optional.

Examples
    var homeController = new HomeController(/* with test dependencies */);
    var controllerTester = new ControllerTester<HomeController>(homeController);

    controllerTester.Action(x => x.Index).TestView();

    controllerTester
        .Action(x => () => x.Details(3))
        .ExpectingViewName("Details")
        .ExpectingModel<Foo>(foo => Assert.IsTrue(foo.IsValid))
        .TestView();

    controllerTester
        .Action(x => () => x.Edit(updateModel))
        .WhenModelStateIsValidEquals(false)
        .TestRedirectToAction("Errors");

    controllerTester
        .Action(x => () => x.Edit(updateModel))
        .WhenModelStateIsValidEquals(true)
        .ExpectingViewName("UpdateSuccessful")
        .TestRedirectToRoute("Home/UpdateSuccessful");

Razor Page test helpers

PageModelTester<TPageModel>

ASP.NET MVC Razor Page PageModels have a lot in common with Controllers (they kind of combine the "C" and "M" of MVC), so the tester classes are pretty similar to ControllerTester and ControllerActionTester...

PageModelTester Instantiation:

using SparkyTestHelpers.AspNetMvc
    var homeModel = new HomeModel(/* with test dependencies */);
    var pageTester = new PageModelTester<HomeModel>(homeModel);

It doesn't do anything on its own - just provides an Action(actionDefinitionExpression) method that's used to create a...

PageModelActionTester<TPageModel>

    var actionTester = 
        new PageModelTester<HomeModel>(homeModel).Action(x => x.OnGet);

The .Action method argument is an expression for either a synchronous or async PageModel action method.

PageModelActionTester has several .Test... methods used to assert that the PageModel action returns the expected IActionResult implementation. There are methods for many standard result types, plus the generic TestResult<TActionResultType> method:

  • .TestContent((optional) Action<ContentResult> validate)
  • .TestFile((optional) Action<FileResult> validate)
  • .TestJsonResult((optional) Action<JsonResult> validate)
  • .TestPage((optional) Action<PageResult> validate)
  • .TestRedirectToAction(string expecteActionName, string expectedControllerName, object expectedRouteValues, (optional) Action<RedirectToRouteResult> validate)
  • .TestRedirectToPage(string expectedPageName, (optional) Action<RedirectToPageResult> validate)
  • .TestRedirectToRoute(string expectedRoute, (optional) Action<RedirectToRouteResult> validate)
  • .TestResult<TActionResultType>((optional) Action<TActionResultType> validate)

Additional methods:

  • .ExpectingModel<TModelType>((optional) Action<TModelType> validate) - used with .TestJson. Can also be used with .TestPage, but it's more efficient to use...
  • .ExpectingModel(Action<TPageModel> validate) - used with .TestPage to perform validation PageModel property validation
  • WhenModelStateIsValidEquals(bool isValid) - used to test conditional logic based on ModelState.IsValid
Examples
    var homeModel = new HomeModel(/* with test dependencies */);
    var pageTester = new PageModelTester<HomeModel>(homeModel);

    pageTester
        .Action(x => x.OnGet)
        .ExpectingModel(model => Assert.IsTrue(model.Foo))
        .TestPage();

    pageTester
        .Action(x => x.OnPost)
        .WhenModelStateIsValidEquals(false)
        .ExpectingModel(model => Assert.AreEqual(expectedErrorMessage, model.ErrorMessage))
        .TestPage();

    pageTester
        .Action(x => x.Post)
        .WhenModelStateIsValidEquals(true)
        .TestRedirectToPage("UpdateSuccessful");

ViewComponent test helpers

ViewComponentTester<TViewComponent> and ViewComponentInvocationTester are very similar to their Controller... and PageModel... counterparts.

ViewComponentTester methods

  • .Invocation(synchronous Invoke method expression)
  • .Invocation(async InvokeAsync method expression)

ViewComponentInvocationTester methods

  • .ExpectingViewName(string expectedViewName) - used with .TestView
  • .ExpectingModel<TModelType>(Action<TModelType> validate) - used with .TestView
  • .TestContent(Action<ContentViewComponentResult> validate)
  • .TestHtmlContent(Action<HtmlContentViewComponentResult> validate)
  • .TestView(Action<ViewViewComponentResult> validate)
  • .TestResult<TViewComponentResultType>(Action<TViewComponentResultType> validate)
  • WhenModelStateIsValidEquals(bool isValid) - used to test conditional logic based on ModelState.IsValid

All validate "callback" actions shown above are optional.

Examples
using SparkyTestHelpers.AspNetMvc
new ViewComponentTester<FooViewComponent>()
    .Invocation(x => x.Invoke)
    .ExpectingViewName("Default")
    .ExpectingModel(model => Assert.IsTrue(model.Baz))
    .TestView();

new ViewComponentTester<BarViewComponent>()
    .Invocation(x => x.InvokeAsnyc)
    .TestView();
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.2.3 3,065 3/5/2021
2.2.2 464 9/2/2019
2.2.1.1 367 9/2/2019
2.2.1 570 5/18/2019
2.2.0 442 5/15/2019
2.1.0 2,116 3/31/2018
2.0.1 711 3/27/2018
2.0.0 685 3/27/2018
1.0.2 709 3/22/2018
1.0.1 712 3/22/2018
1.0.0 756 3/22/2018

v2.1: Added support for async actions