uglify-js

uglify-js
 最后更新于 2024年10月02日 23:14:11

安装

npm install uglify-js -g 全局安装 npm install uglify-js 项目安装

使用

uglifyjs [input files] [options]

UglifyJS2可以输入多文件,根据压缩选项,把文件放在队列中依次解释。所有文件都会在同一个全局域中,假如一个文件中的变量、方法被另一文件引用,UglifyJS会合理地匹配。

如果不输入文件,而是要输入字符串(STDIN),则将文件名换成一个横线(-) 如果把选项写在文件名的前,则需要在二者之间加上双横线,防止文件名被当成了选项:

uglifyjs --compress --mangle -- input.js

以下是可用的选项:

--source-map                   指定输出的文件产生一份sourcemap
--source-map-root              此路径中的源码编译后会产生sourcemap
--source-map-url               sourceMappingURL的sourcemap路径。默认--source-map值
--source-map-include-sources   在sourcemap中加上源文件的内容作为sourcesContent属性
--source-map-inline            把sourcemap以base64格式附在输出文件结尾
--in-source-map                输入sourcemap。假如的你要编译的JS是另外的源码编译出来的。假如该sourcemap包含在js内,请指定"inline"--screw-ie8                    是否支持IE6/7/8。UglifyJS默认不兼容IE。
--support-ie8                  是否支持IE6/7/8,等同于在'compress', 'mangle' 和'output'选项中都设置'screw_ie8: false'
--expr                         编译一个表达式,而不是编译一段代码(编译JSON时用)
-p, --prefix                  忽略sourcemap中源码的前缀。例如`-p 3`会干掉文件名前面3层目录以及保证路径是相对路径。你也可以指定`-p relative`,让UglifyJS计算输出文件、sourcemap与源码之间的相对路径。
-o, --output                  输出文件,默认标准输出(STDOUT)
-b, --beautify                美化输出/指定输出 选项
-m, --mangle                  Mangle的名字,或传入一个mangler选项.
-r, --reserved                mangle的例外,不包含在mangling的名字
-c, --compress                是否启用压缩功能(true/fasle),或者传一个压缩选项对象, 例如 '-c "if_return=false,pure_funcs=["Math.pow","console.log"]','-c'不带参数用默认的压缩设置
-d, --define                  全局定义
-e, --enclose                 所有代码嵌入到一个大方法中,传入参数为配置项
--comments                    保留版权注释。默认保留Google Closure那样的,保留JSDoc-style、包含"@license""@preserve"字样的注释。也可以传下面的参数:
                           - "all" 保留所有注释
                           - 正则(如`/foo/`、`/^!/`)保留匹配到的。要注意,如果启用了压缩,因为会移除不可达代码以及压缩连续声明,因此不是*所有*注释都能 保留下来。
--preamble                    在输出文件开头插入的前言。可以插入一段注释,如版权信息这些不会被编译,但sourcemap会改成当前的样子。
--stats                       在STDERR中显示操作运行时间。
--acorn                       用 Acorn解析。
--spidermonkey                假如输入文件是 SpiderMonkey AST 格式(像JSON).
--self                        把UglifyJS2本身也构建成一个依赖包(等同于`--wrap=UglifyJS --export-all`)
--wrap                        所有代码嵌入到一个大函数,让"exports""global"变量有效,需要传入一个参数指定模块被浏览器引入时的名字。
--export-all                  只当'--wrap'时有效,告诉UglifyJS自动把代码暴露到全局。
--lint                        显示一些可视警告
-v, --verbose                 Verbose
-V, --version                 打印版本号.
--noerr                       不要为-c,-b 或 -m选项中出现未知选项而抛出错误。
--bare-returns                允许返回函数的外部。当最小化CommonJs模块和Userscripts时,可能匿名函数会被.user.js引擎调用立即执行(IIFE)
--keep-fnames                 不要混淆、干掉的函数的名字。当代码依赖Function.prototype.name时有用。
--reserved-file               要保留的文件的名字
--reserve-domprops            保留(绝大部分?)DOM的属性,当--mangle-props
--mangle-props                混淆属性,默认是'0'。设置为 'true' 或 '1' 则会混淆所有属性名。设为'unquoted'或 '2'则只混淆不在引号内的属性。'2'时也会让'keep_quoted_props' 美化选项生效,保留括号内的属性;让压缩选项的 'properties'失效,阻止覆写带点号(.)的属性。你可以通过在命令中明确设置来覆写它们。
--mangle-regex                混淆正则,只混淆匹配到的属性名。
--name-cache                  用来保存混淆map的文件
--pure-funcs                  假如返回值没被调用则可以安全移除的函数。例如'--pure-funcs Math.floor console.info'(需要设置 '-compress')

指定--output (-o)来明确输出文件,否则将在终端输出(STDOUT)

sourcemap选项

保留注释

通过 comments 选项保留某些注释,有 正则表达式字符串布尔值函数 等参数。字符串参数有 allsomesome 等同于 CLI 中 --comments 不带任何参数。

注释标识有如下属性:

  • type 单行注释是"comment1",多行注释 "comment2"
  • value 注释体本身
  • posendpos 注释在源码中出现的起始位置/结束位置(从0开始索引)
  • linecol 注释在源码中出现的行和列
  • file 源码的文件名
  • nlb 在源码中,如果注释前有一空行或注释另起新一行的话是true

函数返回 true 保留注释,其他返回值都为 false