JsonValidator 1.1.0

{✓} JSON Validator

This project provides a simple way to validate JSON objects in dotnet. The main use for the tool is in integration tests where you would — ideally — validate an API JSON response manually instead of using the model classes.

NuGet packages

Package	Nuget	Description
JsonValidator		Base package containing the validation logic
JsonValidator.FluentAssertions		Extensions for FluentAssertions

Usage

• Parse the JSON string to a System.Text.Json.JsonDocument
• Define the object with the properties you would like to validate. This can be a regular class or an anonymous class as well. We recommend anonymous classes.
• Call the ValidateMatch extension method on the JsonDocument.
• The ValidateMatch will throw a ValidationFailedException if any value of the above defined object is not present or does not match the value in the JsonDocument.
• Values that are present in the JsonDocument but are not defined in the validation object are ignored. They will not influence the validation result.

Example

JsonDocument.Parse(
        """
        {
          "name": "Anna Smith",
          "title": null,
          "level": 2,
          "isAvailable": true,
          "score": 4.5326,
          "capabilities": ["accounting", "marketing", "sales"],                      
          "personalData":
          {
            "age": 29,
            "nickname": "Anny",
            "isMarried": false
          }
        }
        """)
    .ValidateMatch(
        new
        {
            name = "Anna Smith",
            title = null as string,
            level = 2,
            isAvailable = true,
            score = 4.5326,
            capabilities = new[] { "accounting", "marketing", "sales" },
            personalData = new
            {
                age = 29,
                nickname = "Anny",
                isMarried = false,
            }
        });