terser 3.7.6 → 3.8.1

package/README.md

@@ -3,8 +3,14 @@ terser
 
 A JavaScript parser, mangler/compressor and beautifier toolkit for ES6+.
 
-#### Note:
-- **`terser` is API/CLI compatible with `uglify-es` and `uglify-js@3`.**
+
+Why choose terser?
+------------------
+
+`uglify-es` is no longer maintained and `uglify-js` does not support ES6+.
+
+**`terser`** is a fork of `uglify-es` that retains API and CLI compatibility
+with `uglify-es` and `uglify-js@3`.
 
 Install
 -------
@@ -19,7 +25,7 @@ From NPM for use as a command line app:
 From NPM for programmatic use:
 
     npm install terser
-
+    
 # Command line usage
 
     terser [input files] [options]
@@ -635,7 +641,7 @@ If you're using the `X-SourceMap` header instead, you can just omit `sourceMap.u
   the resultant code is shorter: `m(){return x}` becomes `m:()=>x`.
   This transform requires that the `ecma` compress option is set to `6` or greater.
 
-- `arguments` (default: `true`) -- replace `arguments[index]` with function
+- `arguments` (default: `false`) -- replace `arguments[index]` with function
   parameter name whenever possible.
 
 - `booleans` (default: `true`) -- various optimizations for boolean context,
@@ -660,6 +666,8 @@ If you're using the `X-SourceMap` header instead, you can just omit `sourceMap.u
   enabled `compress` transforms. Useful when you only want to enable a few
   `compress` options while disabling the rest.
 
+- `directives` (default: `true`) -- remove redundant or non-standard directives
+
 - `drop_console` (default: `false`) -- Pass `true` to discard calls to
   `console.*` functions. If you wish to drop a specific function call
   such as `console.info` and/or retain side effects from function arguments
@@ -785,7 +793,8 @@ If you're using the `X-SourceMap` header instead, you can just omit `sourceMap.u
   `foo === void 0`.  Note: recommend to set this value to `false` for IE10 and
   earlier versions due to known issues.
 
-- `unsafe` (default: `false`) -- apply "unsafe" transformations (discussion below)
+- `unsafe` (default: `false`) -- apply "unsafe" transformations
+  ([details](#the-unsafe-compress-option)).
 
 - `unsafe_arrows` (default: `false`) -- Convert ES5 style anonymous function
   expressions to arrow functions if the function body does not reference `this`.
@@ -939,9 +948,6 @@ can pass additional arguments that control the code output:
   adjust for this text.  Can be used to insert a comment containing
   licensing information, for example.
 
-- `preserve_line` (default `false`) -- pass `true` to preserve lines, but it
-  only works if `beautify` is set to `false`.
-
 - `quote_keys` (default `false`) -- pass `true` to quote all keys in literal
   objects
 
@@ -975,7 +981,7 @@ can pass additional arguments that control the code output:
 
 - `wrap_iife` (default `false`) -- pass `true` to wrap immediately invoked
   function expressions. See
-  [#640](https://github.com/mishoo/Terser2/issues/640) for more details.
+  [#640](https://github.com/mishoo/UglifyJS2/issues/640) for more details.
 
 # Miscellaneous
 
@@ -1010,14 +1016,16 @@ needs to be kept in the output) are comments attached to toplevel nodes.
 ### The `unsafe` `compress` option
 
 It enables some transformations that *might* break code logic in certain
-contrived cases, but should be fine for most code.  You might want to try it
-on your own code, it should reduce the minified size.  Here's what happens
-when this flag is on:
+contrived cases, but should be fine for most code.  It assumes that standard
+built-in ECMAScript functions and classes have not been altered or replaced.
+You might want to try it on your own code; it should reduce the minified size.
+Some examples of the optimizations made when this option is enabled:
 
 - `new Array(1, 2, 3)` or `Array(1, 2, 3)` → `[ 1, 2, 3 ]`
 - `new Object()` → `{}`
 - `String(exp)` or `exp.toString()` → `"" + exp`
 - `new Object/RegExp/Function/Error/Array (...)` → we discard the `new`
+- `"foo bar".substr(4)` → `"bar"`
 
 ### Conditional compilation
 
@@ -1133,9 +1141,14 @@ var result = Terser.minify(ast, {
 
 ### Working with Terser AST
 
-Transversal and transformation of the native AST can be performed through
-[`TreeWalker`](http://lisperator.net/terser/walk) and
-[`TreeTransformer`](http://lisperator.net/terser/transform) respectively.
+Traversal and transformation of the native AST can be performed through
+[`TreeWalker`](https://github.com/fabiosantoscode/terser/blob/master/lib/ast.js) and
+[`TreeTransformer`](https://github.com/fabiosantoscode/terser/blob/master/lib/transform.js)
+respectively.
+
+Largely compatible native AST examples can be found in the original UglifyJS
+documention. See: [tree walker](http://lisperator.net/uglifyjs/walk) and
+[tree transform](http://lisperator.net/uglifyjs/transform).
 
 ### ESTree / SpiderMonkey AST
 
@@ -1217,3 +1230,30 @@ To allow for better optimizations, the compiler makes various assumptions:
 - Object properties can be added, removed and modified (not prevented with
   `Object.defineProperty()`, `Object.defineProperties()`, `Object.freeze()`,
   `Object.preventExtensions()` or `Object.seal()`).
+
+### Build Tools and Adaptors using Terser
+
+https://www.npmjs.com/browse/depended/terser
+
+### Replacing `uglify-es` with `terser` in a project using `yarn`
+
+A number of JS bundlers and uglify wrappers are still using buggy versions
+of `uglify-es` and have not yet upgraded to `terser`. If you are using `yarn`
+you can add the following alias to your project's `package.json` file:
+
+```js
+  "resolutions": {
+    "uglify-es": "npm:terser"
+  }
+```
+
+to use `terser` instead of `uglify-es` in all deeply nested dependencies
+without changing any code.
+
+Note: for this change to take effect you must run the following commands
+to remove the existing `yarn` lock file and reinstall all packages:
+
+```
+$ rm -rf node_modules yarn.lock
+$ yarn
+```

package/bin/uglifyjs

@@ -3,13 +3,25 @@
 
 "use strict";
 
-require("../tools/exit");
+require("../tools/exit.js");
 
 var fs = require("fs");
 var info = require("../package.json");
 var path = require("path");
 var program = require("commander");
-var UglifyJS = require("../tools/node");
+
+var bundle_path = __dirname + "/../dist/browser.bundle.js";
+if (process.env.TERSER_DEBUG
+    /* note: commander not initialized yet */
+    && !/--help|--self/.test(process.argv.toString())
+    && fs.existsSync(bundle_path)) {
+    var UglifyJS = require(bundle_path);
+    try {
+        require("source-map-support").install();
+    } catch (err) {}
+} else {
+    var UglifyJS = require("../tools/node.js");
+}
 
 var skip_keys = [ "cname", "inlined", "parent_scope", "scope", "uses_eval", "uses_with" ];
 var files = {};
@@ -50,7 +62,7 @@ program.option("--name-cache <file>", "File to hold mangled name mappings.");
 program.option("--rename", "Force symbol expansion.");
 program.option("--no-rename", "Disable symbol expansion.");
 program.option("--safari10", "Support non-standard Safari 10.");
-program.option("--self", "Build UglifyJS as a library (implies --wrap UglifyJS)");
+program.option("--self", "Build Terser as a library (implies --wrap Terser)");
 program.option("--source-map [options]", "Enable source map/specify source map options.", parse_source_map());
 program.option("--timings", "Display operations run time on STDERR.");
 program.option("--toplevel", "Compress and/or mangle variables in toplevel scope.");
@@ -112,8 +124,8 @@ if (program.mangleProps) {
     } else {
         if (typeof program.mangleProps != "object") program.mangleProps = {};
         if (!Array.isArray(program.mangleProps.reserved)) program.mangleProps.reserved = [];
-        require("../tools/domprops").forEach(function(name) {
-            UglifyJS._push_uniq(program.mangleProps.reserved, name);
+        require("../tools/domprops.json").forEach(function(name) {
+            UglifyJS.push_uniq(program.mangleProps.reserved, name);
         });
     }
     if (typeof options.mangle != "object") options.mangle = {};
@@ -161,7 +173,7 @@ if (program.self) {
     if (program.args.length) {
         print_error("WARN: Ignoring input files since --self was passed");
     }
-    if (!options.wrap) options.wrap = "UglifyJS";
+    if (!options.wrap) options.wrap = "Terser";
     simple_glob(UglifyJS.FILES).forEach(function(name) {
         files[convert_path(name)] = read_file(name);
     });
@@ -343,7 +355,7 @@ function read_file(path, default_value) {
     try {
         return fs.readFileSync(path, "utf8");
     } catch (ex) {
-        if (ex.code == "ENOENT" && default_value != null) return default_value;
+        if ((ex.code == "ENOENT" || ex.code == "ENAMETOOLONG") && default_value != null) return default_value;
         fatal(ex);
     }
 }