@babel/plugin-transform-template-literals

NOTE: This plugin is included in @babel/preset-env

Example

In

`foo${bar}`;

Out

"foo".concat(bar);

Installation

npm install --save-dev @babel/plugin-transform-template-literals

Usage

With a configuration file (Recommended)

Without options:

{
  "plugins": ["@babel/plugin-transform-template-literals"]
}

With options:

{
  "plugins": [
    [
      "@babel/plugin-transform-template-literals",
      {
        "loose": true
      }
    ]
  ]
}

Via CLI

babel --plugins @babel/plugin-transform-template-literals script.js

Via Node API

require("@babel/core").transformSync("code", {
  plugins: ["@babel/plugin-transform-template-literals"],
});

Options

loose

boolean, defaults to false.

⚠️ Consider migrating to the top level mutableTemplateObject assumption.

// babel.config.json
{
  "assumptions": {
    "mutableTemplateObject": true
  }
}

When mutableTemplateObject is true, tagged template literal objects aren’t frozen. All template literal expressions and quasis are combined with the + operator instead of with String.prototype.concat.

When false or not set, all template literal expressions and quasis are combined with String.prototype.concat. It will handle cases with Symbol.toPrimitive correctly and throw correctly if template literal expression is a Symbol(). See babel/babel#5791.

In

`foo${bar}`;

Out

"foo" + bar;

You can read more about configuring plugin options here