Overview
The JSON Schema Test Suite is a comprehensive collection of conformance tests designed to verify that JSON Schema implementations correctly handle all aspects of the specification and its vocabularies.Repository
The test suite is maintained as a separate project to facilitate sharing across all JSON Schema implementations:JSON Schema Test Suite
Official conformance tests for JSON Schema implementations
Purpose
The test suite serves several critical functions:- Implementation Verification: Ensures that JSON Schema implementations correctly implement the specification
- Regression Testing: Helps maintainers catch regressions when making changes
- Specification Clarity: Provides concrete examples of how features should behave
- Cross-Implementation Consistency: Promotes consistent behavior across different implementations
Coverage
The test suite includes tests for:- Core JSON Schema functionality
- Validation keywords from all standard vocabularies
- Edge cases and corner scenarios
- Format validation
- Schema composition (
allOf,anyOf,oneOf) - Reference resolution (
$ref,$id) - Draft-specific features across multiple specification versions
Using the Test Suite
For Implementation Authors
If you’re building a JSON Schema implementation, you should:- Clone the test suite repository
- Run the tests against your implementation
- Ensure all applicable tests pass for your target draft version
- Add the test suite to your CI/CD pipeline
Test Structure
Tests are organized by:- Draft version: Separate tests for different JSON Schema draft versions
- Feature: Grouped by keywords and functionality
- Format: Machine-readable JSON format for easy integration
Contributing
The test suite welcomes contributions:- Report missing test cases
- Submit new tests for edge cases
- Improve test documentation
- Help maintain test accuracy
Related Resources
Implementations
Browse JSON Schema implementations that use this test suite
Specification
View the official JSON Schema specification