Jaw is a data controller that wraps JSON objects with JSON-schema. It provides an easy to use, chaining API for managing JSON instances in ExtendScript.
npm install @extendscript/aes.util.jaw
> Object Manager
Jaw is a data controller that wraps JSON objects with JSON-schema. It provides an easy to use, chaining API for managing JSON instances in ExtendScript.
npm install @extendscript/aes.util.jaw
#include 'node_modules/@extendscript/aes.util.jaw/jaw.js'
Init Jaw with a schema generate an instance that creates all the required properties:
var schema = {
"title": "Test",
"type" : "object",
"properties": {
"a" : {"type": "string"},
"b" : {"type": "object"}
},
"required" : ["a"]
}
var Jaw = Sky.getUtil("jaw").init( schema )
console.log( Jaw.get() )
Output: { a : "" }
You can also generate all properties by passing a boolean like so:
var Jaw = Sky.getUtil("jaw").init( schema, true )
console.log( Jaw.get() )
Output: { a : "", b : {} }
Or you can wrap Jaw arround existing objects. Keep in mind that these will be validated against the given schema. Jaw will try and generate any requirements that are missing or needed:
// schema from above
var obj = { x : 0 }
Jaw = new jaw( schema, obj )
console.log( Jaw.get() )
console.log( Jaw.get() === obj)
Output: { a : "", x : 0 }, true
set() function can generate deep structures on the fly. The get() command is used to retrieve values. // Schema from above
Jaw.set( "b.c.0.d", 10 )
console.log( Jaw.get('b.c.0') )
Output: { d : 10 }
Not specifying a path always returns the complete object:
console.log( Jaw.get() )
Output: { a : "", b : { c : [{ d : 10 }] } }
There are two ways of validating depending on the type of return you're after. validate() returns an array of errors and isValid() returns a boolean:
var result = Jaw.wrap( obj ).isValid()
console.log( result )
Output: true (No errors, object is succesfully validated against schema.)
var result = Jaw.wrap( obj ).validate()
console.log( result )
Output: [] (No errors, object is succesfully validated against schema.)
errors() function:console.log( Jaw.getErrors() )
Output: [] (No errors)
Advanced Use
------------
Besides the getters and setters Jaw implements some familiar tools for easy manipulation of existing properties.
Any type
- .delete ( path )
- .clone ( path )
Array types
- .push ( path )
- .pop ( path )
- .unshift ( path )
- .shift ( path )
- .splice ( path, index, clear, element, element, etc... )
You can chain commands together:
var result = Jaw
.set( "b.c.0.d", 10 )
.get( "b.c.0" );
console.log( result )
Output: { d : 10 }
You can also validate Schemas:
var schemaIsValid = new jaw( schema ).isValid();
console.log( schemaIsValid )
Output: true
getTemplate: Jaw.getTemplate()
Output: { a : "" }
var allProperties = true;
Jaw.getTemplate( allProperties )
Output: { a : "", b : {} }
We can test the code against a range of targets:
npm run test myTarget
We keep a log of test results
Read the docs