用UglifyJS解析/壓縮/格式化你的Javascript

aaie_ 2014-08-07

展開全文

UglifyJS是基于 NodeJS 的Javascript語法解析/壓縮/格式化工具，它支持任何CommonJS模塊系統(tǒng)的Javascript平臺（實現(xiàn)自己的CommonJS平臺也非難事）。 UglifyJS通過解析重新生成JS代碼的語法樹，你可以通過AST以了解更多代碼情況，或者自己來做一個不同的實現(xiàn)。UglifyJS解析器是在 parse-js.js 中實現(xiàn)的，它是非常優(yōu)秀的 parse。

非安全轉(zhuǎn)換

UglifyJS是基于 NodeJS 的Javascript語法解析/壓縮/格式化工具，它支持任何CommonJS模塊系統(tǒng)的Javascript平臺（實現(xiàn)自己的CommonJS平臺也非難事）。

UglifyJS通過解析重新生成JS代碼的語法樹，你可以通過AST以了解更多代碼情況，或者自己來做一個不同的實現(xiàn)。UglifyJS解析器是在 parse-js.js 中實現(xiàn)的，它是非常優(yōu)秀的 parse-js Common Lisp Library 的一部分。

（如果你正在查找UglifyJS的Common Lisp版本，點擊這里）

UglifyJS的另一個重要部分是在 process.js 實現(xiàn)的，它用于檢查并實現(xiàn)解析生成的AST：

通過AST進行Javascript代碼的重新生成：如果你想格式化已經(jīng)被壓縮過的代碼，可以選擇縮進參數(shù)。你也可以打印出無空白（whitespace）的AST，以達到壓縮的目的。
縮短變量名：UglifyJS通過分析代碼并生成新的變量名稱，依賴于作用域，這些名稱通常被簡化為單一字符，并能足夠智能的處理全局變量，或者eval()調(diào)用及with{}塊。換句話說，如果在某個作用域內(nèi)使用了eval()或with{}，那么該作用域的所有變量及其父作用域的變量都不會被重新命名，并且所有指向這類變量的引用也不會被改變。
以下是一些優(yōu)化規(guī)則會讓代碼更簡潔更高效：

非安全轉(zhuǎn)換

UglifyJS在保留語義的同時會盡量提高壓縮比率，如果經(jīng)過UglifyJS處理后你的代碼邏輯失效了，或?qū)glifyJS的優(yōu)化實現(xiàn)有更好的想法，都可有直接聯(lián)系作者。

涉及到全局數(shù)組構(gòu)造函數(shù)的調(diào)用

這時會進行如下轉(zhuǎn)換：

newArray(1,2,3,4)=>[1,2,3,4]Array(a, b, c)=>[a,b,c]newArray(5)=>Array(5)newArray(a)=>Array(a)

在Array沒有被重新定義之前，這些轉(zhuǎn)換是安全的。UglifyJS也會對經(jīng)過用戶本地或全局重定義的Array進行處理，但CSSer建議還是不要這么做：

// case 1.  全局聲明varArray;newArray(1,2, www.csser.com);Array(a, b);// 或者后聲明newArray(1,2,3);varArray;// 或者定義為函數(shù)newArray(1,2,3);functionArray(){...}// case 2. 在函數(shù)內(nèi)部聲明(function(){
    a =newArray(1,2,3);
    b =Array(5,6);varArray;})();// 或者(function(Array){returnArray(5,6,7);})();// 或者(function(){returnnewArray(1,2,3,4);functionArray(){...}})();

// 等等.

安裝

通過NPM安裝

UglifyJS已經(jīng)可以通過NPM進行安裝：

npm install uglify-js

通過GitHub安裝最新版本

## 克隆倉庫
mkdir -p /where/you/wanna/put/it
cd /where/you/wanna/put/it
git clone git://github.com/mishoo/UglifyJS.git## 讓uglify模塊對NodeJS有效
mkdir -p ~/.node_libraries/
cd ~/.node_libraries/
ln -s /where/you/wanna/put/it/UglifyJS/uglify-js.js

## 支持命令行的方式調(diào)用
mkdir -p ~/bin
cd ~/bin
ln -s /where/you/wanna/put/it/UglifyJS/bin/uglifyjs
  # (然后將 ~/bin 增加到 $PATH)

如何使用

UglifyJS提供了命令行工具，支持shell腳本的操作需要：

uglifyjs [選項...][文件名]

最后一個參數(shù)是要處理的JS文件名，如果不指定，則從標準輸入（STDIN）讀取。

支持的選項：

-b 或 --beautify - 輸出格式化代碼，當傳入該參數(shù)，下面的附加選項用于更美觀的控制格式化：
--ascii -默認 UglifyJS 不處理字符編碼而直接輸出 Unicode 字符，通過傳入該參數(shù)將非ASCII編碼的字符轉(zhuǎn)化為\cXXXX的序列（輸出總按照UTF8編碼，但傳入該選項能得到ASCII編碼的輸出）。
-nm 或 --no-mangle - 不改變變量名稱
-ns 或 --no-squeeze - 不調(diào)用 ast_squeeze() 函數(shù)（該函數(shù)會做多種優(yōu)化使得結(jié)果更小，可讀性略有降低）
-mt 或 --mangle-toplevel - 在頂級作用域打亂變量名稱（默認不開啟）
--no-seqs - 當調(diào)用 ast_squeeze() 將會合并多個語句塊為一個語句塊，如 "a=10; b=20; foo()" 將被轉(zhuǎn)換為 "a=10,b=20,foo()"
--no-dead-code - 默認 UglifyJS 將會刪除不被用到的代碼，傳入該參數(shù)禁用此功能。
-nc 或 --no-copyright - 默認 uglifyjs 會在輸出后的代碼中添加版權(quán)信息等注釋代碼，傳入該參數(shù)禁用此功能。
-o 文件名或 --output 文件名 - 指定輸出文件名，如果不指定，則打印到標準輸出（STDOUT）
--overwrite - 如果傳入的JS代碼來自文件而不是標準輸入，傳入該參數(shù)，輸出會覆蓋該文件。
--ast - 傳入該參數(shù)會得到抽象的語法樹而不是Javascript，對調(diào)試或了解內(nèi)部代碼很有用。
-v 或 --verbose - 在標準錯誤輸出一些信息（目前的版本僅輸出操作用時）
--extra - 開啟附加優(yōu)化，這些優(yōu)化并未得到全面的測試。
--unsafe - 開啟其他附加優(yōu)化，這些優(yōu)化已知在特定情況下并不安全，目前僅支持：
--max-line-len （默認32K字節(jié)） - 在32K字節(jié)出增加換行符，傳入0禁用此功能。
--reserved-names - 一些類庫會依賴一些變量，該參數(shù)指定的名稱不會被混淆掉，多個用逗號隔開。

API

要想在Javascript中使用UglifyJS類庫，參考下面的示例（以NodeJS為例）：

var jsp =require("uglify-js").parser;var pro =require("uglify-js").uglify;var orig_code ="Javascript代碼";var ast = jsp.parse(orig_code);// 解析代碼返回初始的AST
ast = pro.ast_mangle(ast);// 獲取變量名稱打亂的AST
ast = pro.ast_squeeze(ast);// 獲取經(jīng)過壓縮優(yōu)化的ASTvar final_code = pro.gen_code(ast);// 壓縮后的代碼

上面的代碼會立刻進行代碼的全面壓縮，正如你所看到的，這里經(jīng)歷了一系列的步驟，你可有省略某些步驟以滿足自己的需求。

這里的函數(shù)有一些參數(shù)，我們做些介紹：

jsp.parse(code, strict_semicolons) - 解析JS代碼并返回AST。strict_semicolons是可選的，默認為false，當傳入true，解析器會在預期為分號而實際沒找到的情況下拋出錯誤。對于大多數(shù)JS代碼我們不需要那么做，但嚴格約束代碼很有益處。
pro.ast_mangle(ast, options) - 返回經(jīng)過變量和函數(shù)名稱混淆的AST，它支持以下選項：
pro.ast_squeeze(ast, options) - 開啟深度優(yōu)化以降低代碼尺寸，返回新的AST，選項可以是一個hash，支持的參數(shù)有：
pro.gen_code(ast, options) - 通過AST生成JS代碼。默認輸出壓縮代碼，但可以通過調(diào)整選項參數(shù)獲得格式化的輸出。選項是可選的，如果傳入必須為對象，支持以下選項：