object-deserializer
v0.6.0
Published
Typesafe deserialization, validation and transformation of POJO to data objects
Downloads
180
Maintainers
Readme
Typesafe Object Deserializer
This is a simple and lightweight library for typesafe deserialization, convertion and validation of a POJO (Plain Old Javascript Object) which you usually receive from the server as a JSON response.
If any error occures object deserializer throws a DeserializationError
with an additional information about a path to the invalid value in a POJO.
This is a simple usage example:
import * from 'object-deserializer';
type Person = {
name: string;
birthday?: Date;
};
const response = `
{
"person": {
"name": "John",
"birthday": "1990-01-01"
}
}`;
const person = deserialize<Person>(JSON.parse(response), d =>
d.required('person').asObject(d => ({
name: d.required('name').asString,
birthday: d.optional('birthday')?.asDate,
}))
);
You can create your own value mappers like this:
function personMapper(d: ObjectDeserializer): Person {
return {
name: d.required('name').asString,
birthday: d.optional('birthday')?.asDate,
};
}
And use it later:
const person = d.required('person').asObject(personMapper);
You can find more advanced examples in the unit tests file.