JScope

JScope

Motivation

Sometimes when you try write elegant code with fallback values you write something like this:

 
  // The Common case
 
  var foo = function(options){
 
      // Ensure option value to prevent undefined value
      options = options || {}; // !!WARNING This line do not force the value type, so if the object passed is not a plain object it will broke your code
 
      /*************************************/
      /* Default value fallback resolution */
      /*************************************/
 
      // Solved with ternary operator
      options.bar  = options.bar ? options.bar : 'foo';
 
      // Solved with if statement
      if(!options.bar)
        options.bar  = 'foo';
 
      // Solved with stream conditional operator
      options.bar  = options.bar || 'foo';
 
      return options;
  }
 

Let's do it easier!!

 
  // The JSCope case
 
  var jscope = require('jscope');
 
  var foo = function(options){
      options = jscope({
          'bar': 'foo',
          'foo': 'bar'
      }).$new(options);
 
      return options;
  }
 
  var result = foo({
      'frog': 'croac!',
      'bar': 'mooo'
  });
 
  // 'croac'
  console.log(result.frog);
  // 'bar'
  console.log(result.foo);
  // 'mooo'
  console.log(result.bar);
  // 'foo'
  console.log(result.$$root.bar);
  // 'foo'
  console.log(result.$$parent.bar);
 
  var child = result.$new({
      'bar': 'wow!!'
  });
 
  // 'foo'
  console.log(child.$$root.bar);
  // 'foo'
  console.log(child.$$parent.$$parent.bar);
  // 'mooo'
  console.log(child.$$parent.bar);
  // 'wow!!'
  console.log(child.bar);
 

As you can see you keep the data with persistence, and it's accesible by $$parent or $$root nodes, so your data never were so sure!!

Installation

Install with npm install jscope --save.