All Versions
Latest Version
Avg Release Cycle
101 days
Latest Release

Changelog History
Page 2

  • v3.0.1 Changes

    November 11, 2018

    #679: Fix partials not rendering tokens when using custom tags, by @stackchain.

  • v3.0.0 Changes

    September 16, 2018

    3.0.0 / 16 September 2018

    We are very happy to announce a new major version of mustache.js. We want to be very careful not to break projects out in the wild, and adhering to Semantic Versioning we have therefore cut this new major version.

    The changes introduced will likely not require any actions for most using projects. The things to look out
    for that might cause unexpected rendering results are described in the migration guide below.

    ๐Ÿš€ A big shout out and thanks to @raymond-lam for this release! Without his contributions with code and
    ๐Ÿš€ issue triaging, this release would never have happened.


    • #618: Allow rendering properties of primitive types that are not objects, by @raymond-lam.
    • ๐Ÿ“œ #643: Writer.prototype.parse to cache by tags in addition to template string, by @raymond-lam.
    • ๐Ÿ“œ #664: Fix Writer.prototype.parse cache, by @seminaoki.


    Migrating from mustache.js v2.x to v3.x

    Rendering properties of primitive types

    We have ensured properties of primitive types can be rendered at all times. That means Array.length, String.length and similar. A corner case where this could cause unexpected output follows:


      stooges: [
        { name: "Moe" },
        { name: "Larry" },
        { name: "Curly" }


      {{name}}: {{name.length}} characters

    Output with v3.0:

      Moe: 3 characters
      Larry: 5 characters
      Curly: 5 characters

    Output with v2.x:

      Moe: characters
      Larry: characters
      Curly: characters
    Caching for templates with custom delimiters

    We have improved the templates cache to ensure custom delimiters are taken into consideration for the
    cache. This improvement might cause unexpected rendering behaviour for using projects actively using the custom delimiters functionality.

    ๐Ÿ“œ Previously it was possible to use Mustache.parse() as a means to set global custom delimiters. If custom
    delimiters were provided as an argument, it would affect all following calls to Mustache.render().
    Consider the following:

    const template = "[[item.title]] [[item.value]]";mustache.parse(template, ["[[", "]]"]);console.log( mustache.render(template, { item: { title: "TEST", value: 1 } }) );\>\> TEST 1

    ๐Ÿ“œ The above illustrates the fact that Mustache.parse() made mustache.js cache the template without
    considering the custom delimiters provided. This is no longer true.

    ๐Ÿ“œ We no longer encourage using Mustache.parse() for this purpose, but have rather added a fourth argument to Mustache.render() letting you provide custom delimiters when rendering.

    ๐Ÿ“œ If you still need the pre-parse the template and use custom delimiters at the same time, ensure to provide
    the custom delimiters as argument to Mustache.render() as well.

  • v2.3.2 Changes

    August 17, 2018

    ๐Ÿš€ This release is made to revert changes introduced in 2.3.1 that caused unexpected behaviour for several users.


    • โช #670: Rollback template cache causing unexpected behaviour, by @raymond-lam.
  • v2.3.1 Changes

    August 07, 2018


    • ๐Ÿ“œ #643: Writer.prototype.parse to cache by tags in addition to template string, by @raymond-lam.
    • ๐Ÿ“œ #664: Fix Writer.prototype.parse cache, by @seminaoki.


    • ๐Ÿš€ #666: Install release tools with npm rather than pre-commit hook & Rakefile, by @phillipj.
    • โœ… #667, #668: Stabilize browser test suite, by @phillipj.

    ๐Ÿ“„ Docs

    • #644: Document global Mustache.escape overriding capacity, by @paultopia.
    • ๐Ÿ“š #657: Correct Mustache.parse() return type documentation, by @bbrooks.
  • v2.3.0 Changes

    November 08, 2016



    ๐Ÿ“„ Docs

    • ๐Ÿ“š #542: Add API documentation to README, by @tomekwi.
    • #546: Add missing syntax highlighting to README code blocks, by @pra85.
    • โšก๏ธ #569: Update Ctemplate links in README, by @mortonfox.
    • #592: Change "loadUser" to "loadUser()" in README, by @Flaque.
    • #593: Adding doctype to HTML code example in README, by @calvinf.


    • ๐Ÿ‘• eslint -> 2.2.0. Breaking changes fix by @phillipj. #548
    • ๐Ÿ‘• eslint -> 2.5.1.
    • mocha -> 3.0.2.
    • zuul -> 3.11.0.

    ๐Ÿš€ Thanks to all the people that contributed to this release!
    Be it issues, comments, changes.. you are awesome! ๐ŸŽ‰ ๐Ÿ˜„

    ๐Ÿฑ PS: Hope you enjoy the new changelog format! I wanted it to group information in a more useful way, and link to PRs for easy diff viewing. :shipit:

  • v2.2.1 Changes

    December 13, 2015

    ๐Ÿ›  Fixes

    • ๐Ÿ‘Œ Improve HTML escaping, by @phillipj.
    • ๐Ÿ›  Fix inconsistency in defining global mustache object, by @simast.
    • ๐Ÿ›  Fix switch-case indent error, by @norfish.
    • ๐Ÿ‘• Unpin chai and eslint versions, by @dasilvacontin.
    • โšก๏ธ Update with proper grammar, by @EvanLovely.
    • โšก๏ธ Update mjackson username in README, by @mjackson.
    • โœ‚ Remove syntax highlighting in README code sample, by @imagentleman.
    • ๐Ÿ›  Fix typo in README, by @Xcrucifier.
    • ๐Ÿ›  Fix link typo in README, by @keirog.
  • v2.2.0 Changes

    October 15, 2015

    โž• Added

    • โž• Add Partials support to CLI, by @palkan.

    ๐Ÿ”„ Changed

    • ๐Ÿšš Move install instructions to README's top, by @mateusortiz
    • ๐Ÿ‘Œ Improved devhook install output, by @ShashankaNataraj.
    • ๐Ÿ“š Clarifies and improves language in documentation, by @jfmercer.
    • ๐Ÿ‘• Linting CLI tool, by @phillipj.
    • npm 2.x and node v4 on Travis, by @phillipj.

    ๐Ÿ›  Fixes

    • ๐Ÿ›  Fix README spelling error to "aforementioned", by @djchie.
    • โœ… Equal error message test in .render() for server and browser, by @phillipj.


    • chai -> 3.3.0
    • ๐Ÿ‘• eslint -> 1.6.0
  • v2.1.3 Changes

    July 23, 2015

    โž• Added

    • Throw error when providing .render() with invalid template type, by @phillipj.
    • Documents use of string literals containing double quotes, by @jfmercer.

    ๐Ÿ”„ Changed

    • ๐Ÿšš Move mustache gif to githubusercontent, by @Andersos.

    ๐Ÿ›  Fixed

    • โšก๏ธ Update UMD Shim to be resilient to HTMLElement global pollution, by @mikesherov.
  • v2.1.2 Changes

    June 17, 2015

    โž• Added

  • v2.1.1 Changes

    June 11, 2015

    โž• Added

    ๐Ÿ›  Fixed

    • ๐Ÿ›  Bugfix for using values from view's context prototype, by @phillipj.
    • ๐Ÿ‘Œ Improve test with undefined/null lookup hit using dot notation, by @dasilvacontin.
    • ๐Ÿ›  Bugfix for null/undefined lookup hit when using dot notation, by @phillipj.
    • โœ‚ Remove moot version property from bower.json, by @kkirsche.
    • bower.json doesn't require a version bump via hook, by @dasilvacontin.

    Thanks to our awesome contributors! :)