javelin-js

Extraction of Javelin from phacility/phabricator for use with NodeJS


Keywords
javelin, phabricator
License
Apache-2.0
Install
npm install javelin-js@1.0.5

Documentation

This is an extraction of the Javelin front end library originally developed at Facebook, and now maintained by phacility. Javelin is an awesome library that is light weight and gives some much needed structure to large JS codebases. For more information on Javelin, check out https://github.com/phacility/phabricator/tree/master/webroot/rsrc/externals/javelin This is an adaptation based on the Aphlict server used alongside Phabricator (https://www.phacility.com/) with the intention of making it easier to install and use Javelin to structure server side NodeJS code.

Install: npm install javelin-js

Use: var JX = require('javelin-js').JX;

Sample Javelin Module Definition:

var JX = require('javelin-js').JX;

JX.install('ModuleName', {
  initialize: function() {
    // function called once when the module is first installed
  },

  extends: 'Name of module to inherit from',

  construct: function(param1, param2, ...) {
    // function to initialize an object created with new, ie.
    // var myObj = new JX.MyModule();
  },

  statics: {
    // static properties or functions associated with the JX module
    // for example, data formatting functions associated with a module
  },

  properties: {
    // these are generally public object members. On install, Javelin generates
    // getters and setters for these properties. For example, for a module
    // JX.Friends, you could have properties of name, age, and phone number.
    // Javelin would then generate JX.Friends.getName(), JX.Friends.setName(), etc.
  },

  members: {
    // properties or functions that are associated with instances of a JX module
    // for example, if you had a module JX.Friend, you may have member properties
    // of created on, callFriend(), etc.
  }

})