This repository has been archived by the owner on Mar 29, 2020. It is now read-only.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Version 3.0.0 of mustache was just published.
The version(
3.0.0
) is not covered by your current version range(^2.3.0
).Release Notes
v3.0.0
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.
Major
Writer.prototype.parse
to cache by tags in addition to template string, by @raymond-lam.Writer.prototype.parse
cache, by @seminaoki.Minor
tags
parameter toMustache.render()
, by @raymond-lam.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:View:
Template:
Output with v3.0:
Output with v2.x:
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 toMustache.render()
. Consider the following: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 toMustache.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.Powered by hothouse 🐝