ES6 for now: Template strings
Friday, August 28th, 2015 at 4:33 amES6 is the future of JavaScript and it is already here. It is a finished specification, and it brings a lot of features a language requires to stay competitive with the needs of the web of now. Not everything in ES6 is for you and in this little series of posts I will show features that are very handy and already usable.
If you look at JavaScript code I’ve written you will find that I always use single quotes to define strings instead of double quotes. JavaScript is OK with either, the following two examples do exactly the same thing:
var animal = "cow"; var animal = 'cow'; |
The reason why I prefer single quotes is that, first of all, it makes it easier to assemble HTML strings with properly quoted attributes that way:
// with single quotes, there's no need to // escape the quotes around the class value var but = '<button class="big">Save</button>'; // this is a syntax error: var but = "<button class="big">Save</button>"; // this works: var but = "<button class=\"big\">Save</button>"; |
The only time you need to escape now is when you use a single quote in your HTML, which should be a very rare occasion. The only thing I can think of is inline JavaScript or CSS, which means you are very likely to do something shady or desperate to your markup. Even in your texts, you are probably better off to not use a single quote but the typographically more pleasing ‘.
Aside: Of course, HTML is forgiving enough to omit the quotes or to use single quotes around an attribute, but I prefer to create readable markup for humans rather than relying on the forgiveness of a parser. We made the HTML5 parser forgiving because people wrote terrible markup in the past, not as an excuse to keep doing so.
I’ve suffered enough in the DHTML days of document.write
to create a document inside a frameset in a new popup window and other abominations to not want to use the escape character ever again. At times, we needed triple ones, and that was even before we had colour coding in our editors. It was a mess.
Expression substition in strings?
Another reason why I prefer single quotes is that I wrote a lot of PHP in my time for very large web sites where performance mattered a lot. In PHP, there is a difference between single and double quotes. Single quoted strings don’t have any substitution in them, double quoted ones have. That meant back in the days of PHP 3 and 4 that using single quotes was much faster as the parser doesn’t have to go through the string to substitute values. Here is an example what that means:
<?php $animal = 'cow'; $sound = 'moo'; echo 'The animal is $animal and its sound is $sound'; // => The animal is $animal and its sound is $sound echo "The animal is $animal and its sound is $sound"; // => The animal is cow and its sound is moo ?> |
JavaScript didn’t have this substitution, which is why we had to concatenate strings to achieve the same result. This is pretty unwieldy, as you need to jump in and out of quotes all the time.
var animal = 'cow'; var sound = 'moo'; alert('The animal is ' + animal + ' and its sound is ' + sound); // => "The animal is cow and its sound is moo" |
Multi line mess
This gets really messy with longer and more complex strings and especially when we assemble a lot of HTML. And, most likely you will sooner or later end up with your linting tool complaining about trailing whitespace after a + at the end of a line. This is based on the issue that JavaScript has no multi-line strings:
// this doesn't work var list = '<ul> <li>Buy Milk</li> <li>Be kind to Pandas</li> <li>Forget about Dre</li> </ul>'; // This does, but urgh… var list = '<ul>\ <li>Buy Milk</li>\ <li>Be kind to Pandas</li>\ <li>Forget about Dre</li>\ </ul>'; // This is the most common way, and urgh, too… var list = '<ul>' + ' <li>Buy Milk</li>' + ' <li>Be kind to Pandas</li>' + ' <li>Forget about Dre</li>' + '</ul>'; |
Client side templating solutions
In order to work around the mess that is string handling and concatenation in JavaScript, we did what we always do – we write a library. There are many HTML templating libraries with Mustache.js probably having been the seminal one. All of these follow an own – non standardised – syntax and work in that frame of mind. It’s a bit like saying that you write your content in markdown and then realising that there are many different ideas of what “markdown” means.
Enter template strings
With the advent of ES6 and its standardisation we now can rejoice as JavaScript has now a new kid on the block when it comes to handling strings: Template Strings. The support of template strings in current browsers is encouraging: Chrome 44+, Firefox 38+, Microsoft Edge and Webkit are all on board. Safari, sadly enough, is not, but it’ll get there.
The genius of template strings is that it uses a new string delimiter, which isn’t in use either in HTML nor in normal texts: the backtick (`).
Using this one we now have string expression substitution in JavaScript:
var animal = 'cow'; var sound = 'moo'; alert(`The animal is ${animal} and its sound is ${sound}`); // => "The animal is cow and its sound is moo" |
The ${}
construct can take any JavaScript expression that returns a value, you can for example do calculations, or access properties of an object:
var out = `ten times two totally is ${ 10 * 2 }`; // => "ten times two totally is 20" var animal = { name: 'cow', ilk: 'bovine', front: 'moo', back: 'milk', } alert(` The ${animal.name} is of the ${animal.ilk} ilk, one end is for the ${animal.front}, the other for the ${animal.back} `); // => /* The cow is of the bovine ilk, one end is for the moo, the other for the milk */ |
That last example also shows you that multi line strings are not an issue at all any longer.
Tagged templates
Another thing you can do with template strings is prepend them with a tag, which is the name of a function that is called and gets the string as a parameter. For example, you could encode the resulting string for URLs without having to resort to the horridly named encodeURIComponent
all the time.
function urlify (str) { return encodeURIComponent(str); } urlify `http://beedogs.com`; // => "http%3A%2F%2Fbeedogs.com" urlify `woah$£$%£^$"`; // => "woah%24%C2%A3%24%25%C2%A3%5E%24%22" // nesting also works: var str = `foo ${urlify `&&`} bar`; // => "foo %26%26 bar" |
This works, but relies on implicit array-to-string coercion. The parameter sent to the function is not a string, but an array of strings and values. If used the way I show here, it gets converted to a string for convenience, but the correct way is to access the array members directly.
Retrieving strings and values from a template string
Inside the tag function you can not only get the full string but also its parts.
function tag (strings, values) { console.log(strings); console.log(values); console.log(strings[1]); } tag `you ${3+4} it`; /* => Array [ "you ", " it" ] 7 it */ |
There is also an array of the raw strings provided to you, which means that you get all the characters in the string, including control characters. Say for example you add a linebreak with \n you will get the double whitespace in the string, but the \n characters in the raw strings:
function tag (strings, values) { console.log(strings); console.log(values); console.log(strings[1]); console.log(string.raw[1]); } tag `you ${3+4} \nit`; /* => Array [ "you ", " it" ] 7 it \nit */ |
Conclusion
Template strings are one of those nifty little wins in ES6, that can be used right now. If you have to support older browsers, you can of course transpile your ES6 to ES5, you can do a feature test for template string support using a library like featuretests.io or with the following code:
var templatestrings = false; try { new Function( "`{2+2}`" ); templatestrings = true; } catch (err) { templatestrings = false; } if (templatestrings) { // … } |
More articles on template strings: