Flair.js
True object orientated features for plain vanilla JavaScript
Introduction
JavaScript is everywhere, and its popularity has grown tremendously. There has been several enhancements done in the language to make it more powerful. ES6/ES7 has added several object-oriented features to the language, but the bottleneck has always been the varied support of these features by web browsers, thus restricting their large-scale usage.
Due to rich and long history of JavaScript, several compatibility issues do exists. Expecting to have all awesome object-oriented concepts as they exists in any new languages like C#, Java, etc., is tough. Of course there is TypeScript, but that is another language. Even though it 'compiles' or 'transpiles' to native JavaScript, it is not 'the' JavaScript.
Flair.js takes the problem head-on and brings majority of the awesomeness of C#/Java features in JavaScript, natively!
Basic object oriented concepts like, inheritance, encapsulation, polymorphism, events, together with advance features like aspect oriented and attribute based programming, custom attributes, serialization, dependency injection and reflection, etc. are all nicely baked in this JavaScript library.
Furthermore, all of these are available via pure JavaScript syntax, without any build-time transpilation or compilation of your codebase. What you write, is what gets executed. No change!
The forward-looking and future-proof design of Flair.js, plays well with ongoing ECMAScript advancements. While executing code, behind the scenes, new JavaScript constructs are used wherever possible.
Flair.js works in web browsers and in other JavaScript environments like Node and NW.js.
Features
- Pure JavaScript, No external dependencies, ~25k min+gz.
- Inheritance: Single inheritance chain, Multiple inheritance via Mixins, Restrictions via 'sealed', etc.
- Encapsulation: True Public, Private and Protected members etc.
- Polymorphism: Abstract classes, Interfaces, Method overloading and overriding, Restrictions via 'sealed', Dynamic casting via 'as', etc.
- Mature Base Types: Class, Struct, Interface, Mixin, Enum, Exception, Resource, Assembly, AppDomain, etc.
- Aspect orientation: Aspect definitions with Before, After and Around advise weaving on methods.
- Attributes based programming: Inbuilt system attributes like 'readonly', 'sealed' and many more with full-blown support of defining custom attributes and its usage over class and class members.
- Dependency injection: Object life-cycle management via DI container and constructor, method and property injection of other types.
- Serialization: Seamless serialization and deserialization of class objects for persistance and transfer.
- Reflection: Meta programming made easy with advance reflection support on all live objects and types.
- Type organization: Organization of types under individual namespaces and assemblies which are loaded in specific assembly ;load context under primary or secondary app domains.
- Others: Singleton, Static classes and members, State storage, Event handling, Async method calls, Auto-disposable objects, deprecate member notifications, Telemetry, Extension ports, etc.
Getting Started
1. Install
Install using npm install flairjs
or download latest release. All you need is to have flair.min.js
available, whatever approach you want to take.
2. Include
Include Flair.js in your html page or load it as a module, and initialize.
There are no external dependencies of this library, therefore feel free to include in whatever order required. However this must be loaded before any
*.js
file which uses Flair.js features, for those to be available.
When using on client side:
Flair.js also support module loaders and can be loaded via
require
or other module loading techniques.
When using on server side:
const flair = ;
3. Play with Objects
With flair objects available, JavaScript now has the awesomeness of C#/Java. Define and play with objects.
Here is a very basic example:
// note: when code is wrapped in a flair Assembly, such imports are not requiredconst Class $$ event using = flair; // define Vehicle classlet Vehicle = ;
// define Car, derived from Vehiclelet Car = ;
// auto disposable block;
Executing above code will show following on console:
Vehicle constructed!
Car constructed!
SUV (3000cc) started at: (time)
Car disposed!
Explore The Power
What you have seen above is the tip of the iceberg. Flair.js adds a lot of firepower to JavaScript that makes building complex JavaScript projects as easy as with C# or Java.
To tap the real power of Flair.js, explore the Guides to understand concepts and behaviors, API to know details of the programming interface for various constructs, and finally Examples to see working code, showcasing all the key concepts in action.
However, before you delve deep into any of these areas, begin with getting an Overview first.
Release History
See the changelog here.
License
Copyright © 2017-2019 Vikas Burman.
Released under the terms of the MIT license. Authored and maintained by Vikas Burman.