SparkyTestHelpers.AspNetMvc.Core 2.2.3

dotnet add package SparkyTestHelpers.AspNetMvc.Core --version 2.2.3
NuGet\Install-Package SparkyTestHelpers.AspNetMvc.Core -Version 2.2.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SparkyTestHelpers.AspNetMvc.Core" Version="2.2.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add SparkyTestHelpers.AspNetMvc.Core --version 2.2.3
#r "nuget: SparkyTestHelpers.AspNetMvc.Core, 2.2.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. 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.2.3

// Install SparkyTestHelpers.AspNetMvc.Core as a Cake Tool
#tool nuget:?package=SparkyTestHelpers.AspNetMvc.Core&version=2.2.3

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)
  • .TestOkObject(Action<OkObjectResult> 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 Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
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 4,569 3/5/2021
2.2.2 645 9/2/2019
2.2.1.1 556 9/2/2019
2.2.1 773 5/18/2019
2.2.0 604 5/15/2019
2.1.0 2,369 3/31/2018
2.0.1 924 3/27/2018
2.0.0 900 3/27/2018
1.0.2 916 3/22/2018
1.0.1 922 3/22/2018
1.0.0 1,001 3/22/2018

v2.1: Added support for async actions
v2.2: Added OkObjectResult tester, changed TController constraint from Controller to ControllerBase