objectmodel
v4.4.5
Published
Strong Dynamically Typed Object Modeling for JavaScript
Downloads
8,002
Maintainers
Readme
What is this library ?
ObjectModel intends to bring strong dynamic type checking to your web applications. Contrary to static type-checking solutions like TypeScript or Flow, ObjectModel can also validate data at runtime: JSON from the server, form inputs, content from localStorage, external libraries...
By leveraging ES6 Proxies, this library ensures that your variables always match the model definition and validation constraints you added to them. Thanks to the generated exceptions, it will help you spot potential bugs and save you time spent on debugging. ObjectModel is also very easy to master: no new language to learn, no new tools, no compilation step, just a minimalist and intuitive API in a plain old JS micro-library.
Validating at runtime also brings many other benefits: you can define your own types, use them in complex model definitions with custom assertions that can even change depending on your application state. Actually it goes much further than just type safety. Go on and see for yourself.
Installation
Add the library to your project dependencies with NPM:
$ npm install objectmodel
or just download the library from Github
Basic usage example
import { ObjectModel } from "objectmodel"
const Order = new ObjectModel({
product: { name: String, quantity: Number },
orderDate: Date
});
const myOrder = new Order({
product: { name: "Apple Pie", quantity: 1 },
orderDate: new Date()
});
myOrder.product.quantity = 2; // no exceptions thrown
myOrder.product.quantity = false; //try to assign a Boolean
// ❌ TypeError: expecting product.quantity to be Number, got Boolean false
Documentation
For more examples, documentation and questions, please refer to the project website: objectmodel.js.org
Changelog and Release History
Please refer to Github Releases
Bug reports and pull requests are welcome.
Distributed under the MIT license. See LICENSE
for more information.