A source code transpiler that enables the use of ES2015 Unicode regular expressions in ES5.
npm install regexpu_regexpu_ is a source code transpiler that enables the use of ES2015 Unicode regular expressions in JavaScript-of-today (ES5). It rewrites regular expressions that make use of the ES2015 u flag into equivalent ES5-compatible regular expressions.
Traceur v0.0.61+, Babel v1.5.0+, esnext v0.12.0+, and Bublé v0.12.0+ use _regexpu_ for their u regexp transpilation. The REPL demos for Traceur, Babel, esnext, and Bublé let you try u regexps as well as other ES.next features.
Consider a file named example-es2015.js with the following contents:
``js
var string = 'foo💩bar';
var match = string.match(/foo(.)bar/u);
console.log(match[1]);
// → '💩'
// This regex matches any symbol from U+1F4A9 to U+1F4AB, and nothing else.
var regex = /[\u{1F4A9}-\u{1F4AB}]/u;
// The following regex is equivalent.
var alternative = /[💩-💫]/u;
console.log([
regex.test('a'), // false
regex.test('💩'), // true
regex.test('💪'), // true
regex.test('💫'), // true
regex.test('💬') // false
]);
`
Let’s transpile it:
`bash`
$ regexpu < example-es2015.js > example-es5.js
example-es5.js can now be used in ES5 environments. Its contents are as follows:
`js
var string = 'foo💩bar';
var match = string.match(/foo((?:[\0-\t\x0B\f\x0E-\u2027\u202A-\uD7FF\uE000-\uFFFF]|[\uD800-\uDBFF][\uDC00-\uDFFF]|\uD800-\uDBFF|(?:[^\uD800-\uDBFF]|^)[\uDC00-\uDFFF]))bar/);
console.log(match[1]);
// → '💩'
// This regex matches any symbol from U+1F4A9 to U+1F4AB, and nothing else.
var regex = /(?:\uD83D[\uDCA9-\uDCAB])/;
// The following regex is equivalent.
var alternative = /(?:\uD83D[\uDCA9-\uDCAB])/;
console.log([
regex.test('a'), // false
regex.test('💩'), // true
regex.test('💪'), // true
regex.test('💫'), // true
regex.test('💬') // false
]);
`
1. _regexpu_ only transpiles regular expression _literals_, so things like RegExp('…', 'u') are not affected.RegExp.prototype.unicode
2. _regexpu_ doesn’t polyfill the getter because it’s not possible to do so without side effects.i
3. _regexpu_ doesn’t support canonicalizing the contents of back-references in regular expressions with both the and u flag set, since that would require transpiling/wrapping strings.
4. _regexpu_ doesn’t match lone low surrogates accurately. Unfortunately that is impossible to implement due to the lack of lookbehind support in JavaScript regular expressions.
To use _regexpu_ programmatically, install it as a dependency via npm:
`bash`
npm install regexpu --save-dev
To use the command-line interface, install _regexpu_ globally:
`bash`
npm install regexpu -g
A string representing the semantic version number.
This is an alias for the rewritePattern function exported by _regexpu-core_. Please refer to that project’s documentation for more information.
regexpu.rewritePattern uses regjsgen, regjsparser, and regenerate as internal dependencies. If you only need this function in your program, it’s better to include it directly:
`js
// Instead of…
const rewritePattern = require('regexpu').rewritePattern;
// Use this:
const rewritePattern = require('regexpu-core');
`
This prevents the Recast and Esprima dependencies from being loaded into memory.
This function accepts an abstract syntax tree representing some JavaScript code, and returns a transformed version of the tree in which any regular expression literals that use the ES2015 u flag are rewritten in ES5.
`js`
const regexpu = require('regexpu');
const recast = require('recast');
const tree = recast.parse(code); // ES2015 code
const transformedTree = regexpu.transform(tree);
const result = recast.print(transformedTree);
console.log(result.code); // transpiled ES5 code
console.log(result.map); // source map
The optional options object is passed to _regexpu-core_’s rewritePattern. For a description of the available options, see its documentation.
regexpu.transformTree uses Recast, regjsgen, regjsparser, and regenerate as internal dependencies. If you only need this function in your program, it’s better to include it directly:
`js`
const transformTree = require('regexpu/transform-tree');
This prevents the Esprima dependency from being loaded into memory.
This function accepts a string representing some JavaScript code, and returns a transpiled version of this code tree in which any regular expression literals that use the ES2015 u flag are rewritten in ES5.
`js`
const es2015 = 'console.log(/foo.bar/u.test("foo💩bar"));';
const es5 = regexpu.transpileCode(es2015);
// → 'console.log(/foo(?:[\\0-\\t\\x0B\\f\\x0E-\\u2027\\u202A-\\uD7FF\\uDC00-\\uFFFF]|[\\uD800-\\uDBFF][\\uDC00-\\uDFFF]|[\\uD800-\\uDBFF])bar/.test("foo💩bar"));'
The optional options object recognizes the following properties:
* sourceFileName: a string representing the file name of the original ES2015 source file.sourceMapName
* : a string representing the desired file name of the source map.dotAllFlag
* : a boolean indicating whether to enable experimental support for the s (dotAll) flag.unicodePropertyEscape
* : a boolean indicating whether to enable experimental support for Unicode property escapes.
The sourceFileName and sourceMapName properties must be provided if you want to generate source maps.
`js`
const result = regexpu.transpileCode(code, {
'sourceFileName': 'es2015.js',
'sourceMapName': 'es2015.js.map',
});
console.log(result.code); // transpiled source code
console.log(result.map); // source map
regexpu.transpileCode uses Esprima, Recast, regjsgen, regjsparser, and regenerate as internal dependencies. If you only need this function in your program, feel free to include it directly:
`js`
const transpileCode = require('regexpu/transpile-code');
If you’re looking for a general-purpose ES.next-to-ES5 transpiler with support for Unicode regular expressions, consider using one of these:
* Traceur v0.0.61+
* Babel v1.5.0+
* esnext v0.12.0+
* Bublé v0.12.0+
1. On the main branch, bump the version number in package.json:
`sh`
npm version patch -m 'Release v%s'
Instead of patch, use minor or major as needed.
Note that this produces a Git commit + tag.
1. Push the release commit and tag:
`sh``
git push && git push --tags
Our CI then automatically publishes the new release to npm.
|  |
|---|
| Mathias Bynens |
_regexpu_ is available under the MIT license.