Practical ASP.NET

Unit Testing AJAX Calls to an ASP.NET MVC Controller

Sometimes what you want to test is how your Action method behaves when it's invoked through an AJAX call. Here's how to mock up that call using Moq.

In an earlier column on using Moq to create unit tests, I looked briefly at using the ControllerContext object to create a Session object that you could configure for testing.

Recently, though, I faced a different problem: I needed a unit test for an Action method that returned a different result depending on whether it was called through a normal HTTP request or through an AJAX request. As it turns out, this was just the start of a series of AJAX-related tests I needed to create, but this was the start of all my subsequent solutions.

The code in the Action method looks something like this:

If Request.IsAjaxRequest Then
  Return Json(Orders)
End If
Return View(Orders)

Obviously, I needed to mock the Request object so that I could set its IsAjaxRequest property:

Dim req As New Mock(Of HttpRequestBase)

However, to set the IsAjaxRequest property, ASP.NET MVC looks for an X-Requested-With HTTP header set to XMLHttpRequest on the Request object. So, I set up my mock Request object to return that value:

req.Setup(Function(r) r("X-Requested-With")).Returns("XMLHttpRequest")

I also needed to mock the HttpContext object because, under the hood, it's the HttpContext object that's responsible for returning the Request object used in my Controller. I mocked it and tied its Request property to my mock Request object:

Dim hct As New Mock(Of HttpContextBase)
hct.Setup(Function(h) h.Request).Returns(req.Object)

Now I could instantiate the HomeController class I wanted to test and set its ControllerContext object (the ControllerContext is responsible for managing the HttpContext object). I did that by instantiating a ControllerContext class, passing my mock HttpContext object, an empty RouteData table (because I didn't use it in my Action method), and my HomeController object. I shoved the resulting ControllerContext class into my HomeContoller object's ControllerContext property:

Dim hc As New HomeController
hc.ControllerContext = New ControllerContext(hct.Object, New RouteData(), hc)

Finally, I could call the Action method I wanted to test:

Dim ac As ActionResult
ac = hc.GetCustomerOrders(2)

It turned out, by the way, that this was just the start of various AJAX mockings I needed to create. However, from this point on, all I needed to do was keep extending my mock Request object.

About the Author

Peter Vogel is a system architect and principal in PH&V Information Services. PH&V provides full-stack consulting from UX design through object modeling to database design. Peter tweets about his VSM columns with the hashtag #vogelarticles. His blog posts on user experience design can be found at

comments powered by Disqus


  • .NET for Apache Spark Debuts in Version 1.0

    The open source project .NET for Apache Spark has debuted in version 1.0, finally vaulting the C# and F# programming languages into Big Data first-class citizenship.

  • In-App Reviews Come to Xamarin.Forms Android

    Android is playing a little catch-up to iOS regarding in-app review functionality, just now coming tp Microsoft's Xamarin.Forms implementation.

  • C# Slides in Usage Ranking of Programming Languages

    "The fact that C# lost three places in the ranking of language communities during the last three years is mostly explained by its slower growth compared to C/C++ and PHP."

  • Telerik UI for Blazor Updated

    Progress announced an update to its Telerik UI for Blazor components, targeting Microsoft's open source Blazor framework that lets C# coders create web apps without having to rely upon JavaScript.

  • Infragistics Unveils UI Components for Blazor

    Infragistics, specializing in third-party UI/UX controls and tools, unveiled a new offering targeting Blazor, Microsoft's red-hot open source framework that allows for C#-based web development instead of traditional mainstay JavaScript.

Upcoming Events