handlebars.js/spec/string-params.js

describe('string params mode', function() {
  it('arguments to helpers can be retrieved from options hash in string form', function() {
    var template = CompilerContext.compile('{{wycats is.a slave.driver}}', {
      stringParams: true
    });

    var helpers = {
      wycats: function(passiveVoice, noun) {
        return 'HELP ME MY BOSS ' + passiveVoice + ' ' + noun;
      }
    };

    var result = template({}, { helpers: helpers });

    equals(
      result,
      'HELP ME MY BOSS is.a slave.driver',
      'String parameters output'
    );
  });

  it('when using block form, arguments to helpers can be retrieved from options hash in string form', function() {
    var template = CompilerContext.compile(
      '{{#wycats is.a slave.driver}}help :({{/wycats}}',
      { stringParams: true }
    );

    var helpers = {
      wycats: function(passiveVoice, noun, options) {
        return (
          'HELP ME MY BOSS ' +
          passiveVoice +
          ' ' +
          noun +
          ': ' +
          options.fn(this)
        );
      }
    };

    var result = template({}, { helpers: helpers });

    equals(
      result,
      'HELP ME MY BOSS is.a slave.driver: help :(',
      'String parameters output'
    );
  });

  it('when inside a block in String mode, .. passes the appropriate context in the options hash', function() {
    var template = CompilerContext.compile(
      '{{#with dale}}{{tomdale ../need dad.joke}}{{/with}}',
      { stringParams: true }
    );

    var helpers = {
      tomdale: function(desire, noun, options) {
        return (
          'STOP ME FROM READING HACKER NEWS I ' +
          options.contexts[0][desire] +
          ' ' +
          noun
        );
      },

      with: function(context, options) {
        return options.fn(options.contexts[0][context]);
      }
    };

    var result = template(
      {
        dale: {},

        need: 'need-a'
      },
      { helpers: helpers }
    );

    equals(
      result,
      'STOP ME FROM READING HACKER NEWS I need-a dad.joke',
      'Proper context variable output'
    );
  });

  it('information about the types is passed along', function() {
    var template = CompilerContext.compile(
      "{{tomdale 'need' dad.joke true false}}",
      { stringParams: true }
    );

    var helpers = {
      tomdale: function(desire, noun, trueBool, falseBool, options) {
        equal(options.types[0], 'StringLiteral', 'the string type is passed');
        equal(
          options.types[1],
          'PathExpression',
          'the expression type is passed'
        );
        equal(
          options.types[2],
          'BooleanLiteral',
          'the expression type is passed'
        );
        equal(desire, 'need', 'the string form is passed for strings');
        equal(noun, 'dad.joke', 'the string form is passed for expressions');
        equal(trueBool, true, 'raw booleans are passed through');
        equal(falseBool, false, 'raw booleans are passed through');
        return 'Helper called';
      }
    };

    var result = template({}, { helpers: helpers });
    equal(result, 'Helper called');
  });

  it('hash parameters get type information', function() {
    var template = CompilerContext.compile(
      "{{tomdale he.says desire='need' noun=dad.joke bool=true}}",
      { stringParams: true }
    );

    var helpers = {
      tomdale: function(exclamation, options) {
        equal(exclamation, 'he.says');
        equal(options.types[0], 'PathExpression');

        equal(options.hashTypes.desire, 'StringLiteral');
        equal(options.hashTypes.noun, 'PathExpression');
        equal(options.hashTypes.bool, 'BooleanLiteral');
        equal(options.hash.desire, 'need');
        equal(options.hash.noun, 'dad.joke');
        equal(options.hash.bool, true);
        return 'Helper called';
      }
    };

    var result = template({}, { helpers: helpers });
    equal(result, 'Helper called');
  });

  it('hash parameters get context information', function() {
    var template = CompilerContext.compile(
      "{{#with dale}}{{tomdale he.says desire='need' noun=../dad/joke bool=true}}{{/with}}",
      { stringParams: true }
    );

    var context = { dale: {} };

    var helpers = {
      tomdale: function(exclamation, options) {
        equal(exclamation, 'he.says');
        equal(options.types[0], 'PathExpression');

        equal(options.contexts.length, 1);
        equal(options.hashContexts.noun, context);
        equal(options.hash.desire, 'need');
        equal(options.hash.noun, 'dad.joke');
        equal(options.hash.bool, true);
        return 'Helper called';
      },
      with: function(withContext, options) {
        return options.fn(options.contexts[0][withContext]);
      }
    };

    var result = template(context, { helpers: helpers });
    equal(result, 'Helper called');
  });

  it('when inside a block in String mode, .. passes the appropriate context in the options hash to a block helper', function() {
    var template = CompilerContext.compile(
      '{{#with dale}}{{#tomdale ../need dad.joke}}wot{{/tomdale}}{{/with}}',
      { stringParams: true }
    );

    var helpers = {
      tomdale: function(desire, noun, options) {
        return (
          'STOP ME FROM READING HACKER NEWS I ' +
          options.contexts[0][desire] +
          ' ' +
          noun +
          ' ' +
          options.fn(this)
        );
      },

      with: function(context, options) {
        return options.fn(options.contexts[0][context]);
      }
    };

    var result = template(
      {
        dale: {},

        need: 'need-a'
      },
      { helpers: helpers }
    );

    equals(
      result,
      'STOP ME FROM READING HACKER NEWS I need-a dad.joke wot',
      'Proper context variable output'
    );
  });

  it('with nested block ambiguous', function() {
    var template = CompilerContext.compile(
      '{{#with content}}{{#view}}{{firstName}} {{lastName}}{{/view}}{{/with}}',
      { stringParams: true }
    );

    var helpers = {
      with: function() {
        return 'WITH';
      },
      view: function() {
        return 'VIEW';
      }
    };

    var result = template({}, { helpers: helpers });
    equals(result, 'WITH');
  });

  it('should handle DATA', function() {
    var template = CompilerContext.compile('{{foo @bar}}', {
      stringParams: true
    });

    var helpers = {
      foo: function(bar, options) {
        equal(bar, '@bar');
        equal(options.types[0], 'PathExpression');
        return 'Foo!';
      }
    };

    var result = template({}, { helpers: helpers });
    equal(result, 'Foo!');
  });
});