What is this?
JSON Schemas are JSON documents that describe how a JSON object should be structured. The JSON Schema standard includes rules about what fields are required, what type and format of data is allowed in a field, and many other complex rules that allow you to do things like limit the length of a text field, or require between one and three entries in an array.
This package provides a series of Fluid components and static functions that are intended to help with two general use cases:
- Defining the fields and values that are allowed in JSON using FSS, a variant of the underlying JSON Schema language.
- Validating JSON data against an FSS Schema and reporting errors to the user. See the validator documentation for more details.
Although you can reuse the above in various additional ways, this package provides components and functions to assist with the following specific use cases:
- (In both Node and a browser) Defining the information a schema-validated component requires to start up and preventing its creation if material is missing or incorrect.
- (In both Node and a browser) Defining what is allowed in the model of a schema-validated modelComponent, and automatically (re)validating the model when changes are made.
- (In Node) Rejecting invalid data sent to a REST endpoint (presumably via a POST or PUT request) served up by either fluid-express or kettle. See the middleware documentation for more details.
- (In a browser) Associating model material with HTML DOM elements, and displaying validation errors in context using the "error binder".
Running the tests
You can run the tests on a local machine using commands like the following from the root of the repository:
npm install npm test
Running the Browser Tests without Instrumentation
By default, the browser tests are run against instrumented code so that we can prepare a code coverage report at the end
of each test run. If you need to troubleshoot a problem with the browser tests, you can also run the tests against the
raw source code by hosting the content in a standalone web server and then opening the tests in a browser. For example,
if you have python installed, you can use the command
python -m SimpleHTTPServer from the root of the repository, and
in a browser.
Using these components in a browser
This package depends on AJV. AJV can be used on the client-side, but must first
be bundled using
browserify. The AJV package takes care of this automatically when it's installed, the required
client-side bundle can be found in
./node_modules/ajv/dist/ajv.bundle.js once you've installed this package's
dependencies. The remaining client-side dependencies depend on which parts of this package you're using. See the HTML
browser test fixtures in
./tests/static/ for examples.