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!');
  });
});