json_schema_matcher 1.0.0

A Dart library for JSON schema validation using native testing framework matchers with strongly-typed validators and detailed error messages.

example/json_schema_matcher_example.dart

import 'package:json_schema_matcher/json_schema_matcher.dart';
import 'package:test/test.dart';

void main() {
  test('user validation', () {
    final userData = {
      'id': 1,
      'name': 'João Silva',
      'email': '[e-mail]',
      'age': 30,
    };

    expect(
      userData,
      isJsonObject({
        'id': typeOf<int>(),
        'name': typeOf<String>(),
        'email': typeOf<String>(),
        'age': typeOf<int>(),
      }),
    );
  });

  test('user with optional fields', () {
    final userData = {
      'id': 1,
      'name': 'Maria Santos',
      'email': '[e-mail]',
    };

    expect(
      userData,
      isJsonObject({
        'id': typeOf<int>(),
        'name': typeOf<String>(),
        'email': typeOf<String>(),
        'phone': typeOf<String?>(), // optional field
      }),
    );
  });

  test('array of users', () {
    final users = [
      {'id': 1, 'name': 'Alice'},
      {'id': 2, 'name': 'Bob'},
    ];

    expect(
      users,
      isJsonArray({
        'id': typeOf<int>(),
        'name': typeOf<String>(),
      }),
    );
  });

  test('array of strings', () {
    expect(
      ['dart', 'json', 'validation'],
      isJsonArrayOf<String>(),
    );
  });

  test('nested object', () {
    final data = {
      'user': {
        'id': 1,
        'name': 'Pedro',
        'profile': {
          'firstName': 'Pedro',
          'lastName': 'Costa',
        },
      },
    };

    expect(
      data,
      isJsonObject({
        'user': jsonObject({
          'id': typeOf<int>(),
          'name': typeOf<String>(),
          'profile': jsonObject({
            'firstName': typeOf<String>(),
            'lastName': typeOf<String>(),
          }),
        }),
      }),
    );
  });
}