JSON serialization – DataContractJsonSerializer vs JavaScriptSerializer

Check out my new course Learn you some Lambda best practice for great good! and learn the best practices for performance, cost, security, resilience, observability and scalability.

In C#, when you have to work with JSON data you’re usually represented with two choices – DataContractJsonSerializer or JavaScriptSerializer. There are other popular third-party libraries out there, such as the popular Json.Net project, but for the rest of this blog let’s just focus on the two built-in JSON serializers and see how they differ.


Without doubt the biggest difference between the two is that DataContractJsonSerializer only works with types decorated with the DataContract attribute, but JavaScriptSerializer can work with any object.

This makes perfect sense as the primary purpose of the DataContractJsonSerializer is to be used with WCF, and just as its name suggests, it’s a JSON serializer for DataContract types.

Anonymous Types

One interesting side effect of the above is that you can’t use DataContractJsonSerializer with anonymous types.

On the other hand, with the JavaScriptSerializer at least you can easily serialize an instance of an anonymous type:

   1: var jsSerializer = new JavaScriptSerializer();


   3: // define an anonymous type

   4: var anonymous = new { Id = Guid.NewGuid(), Name = "Yan", Age = 29 };


   6: // this writes:

   7: // {"Id":"2edebefb-2585-438c-bbc3-939e7688f630","Name":"Yan","Age":29}

   8: Console.WriteLine(jsSerializer.Serialize(anonymous));

Unfortunately you won’t be able to deserialize the JSON string back into an anonymous type as all the available deserialize methods requires a type which has a parameterless constructor.


Another main functional difference between these two serializers is how they deal with dictionaries.

Take this simple dictionary for instance:

   1: var dictionary = new Dictionary<string, object>();

   2: dictionary.Add("Id", Guid.NewGuid());

   3: dictionary.Add("Name", "Yan");

   4: dictionary.Add("Age", 29);

The DataContractJsonSerializer serializes dictionaries as an array of KeyValuePair objects:


whereas the JavaScriptSerializer serializes dictionaries in a much more ‘JSON’ way:


This subtle different might seem trivial at first, but it can make a huge difference when you’re dealing with data that are originated from a non-.Net language. A perfect example came couple of days ago when we were testing out the Facebook graph API and one of the JSON responses we came across was a dictionary whose keys were numeric IDs like this:

{“1652438520054”:{“id”:”1652438520054″, …}}

In cases like this, you simply won’t be able to deserialize this JSON using the DataContractJsonSerializer!

Liked this article? Support me on Patreon and get direct help from me via a private Slack channel or 1-2-1 mentoring.
Subscribe to my newsletter

Hi, I’m Yan. I’m an AWS Serverless Hero and the author of Production-Ready Serverless.

I specialise in rapidly transitioning teams to serverless and building production-ready services on AWS.

Are you struggling with serverless or need guidance on best practices? Do you want someone to review your architecture and help you avoid costly mistakes down the line? Whatever the case, I’m here to help.

Hire me.

Check out my new podcast Real-World Serverless where I talk with engineers who are building amazing things with serverless technologies and discuss the real-world use cases and challenges they face. If you’re interested in what people are actually doing with serverless and what it’s really like to be working with serverless day-to-day, then this is the podcast for you.

Check out my new course, Learn you some Lambda best practice for great good! In this course, you will learn best practices for working with AWS Lambda in terms of performance, cost, security, scalability, resilience and observability. We will also cover latest features from re:Invent 2019 such as Provisioned Concurrency and Lambda Destinations. Enrol now and start learning!

Check out my video course, Complete Guide to AWS Step Functions. In this course, we’ll cover everything you need to know to use AWS Step Functions service effectively. There is something for everyone from beginners to more advanced users looking for design patterns and best practices. Enrol now and start learning!

Are you working with Serverless and looking for expert training to level-up your skills? Or are you looking for a solid foundation to start from? Look no further, register for my Production-Ready Serverless workshop to learn how to build production-grade Serverless applications!

Find a workshop near you