According to Yahoo!'s Exceptional Performance Team, 40% to 60% of Yahoo!'s users have an empty cache experience and about 20% of all page views are done with an empty cache (see this article by Tenni Theurer on the YUIBlog for more information on browser cache usage). This fact outlines the importance of keeping web pages as lightweight as possible. Improving the engineering design of a page or a web application usually yields the biggest savings and that should always be a primary strategy. With the right design in place, there are many secondary strategies for improving performance such as minification of the code, HTTP compression, using CSS sprites, etc.
- Documentation: Detailed description of the YUI Compressor and how to use it.
- Release Notes: Detailed change log for the YUI Compressor.
- CSS minification: Description of the CSS minification performed by the compressor.
- License: All code specific to YUI Compressor is issued under a BSD license. YUI Compressor extends and implements code from Mozilla's Rhino project. Rhino is issued under the Mozilla Public License (MPL), and MPL applies to the Rhino source and binaries that are distributed with YUI Compressor, including Rhino modifications made by YUI Compressor. YUI Compressor also makes use of and distributes a binary of JArgs; the JArgs BSD license applies to this binary.
- Download: Download the YUI Compressor.
How does the YUI Compressor work?
The YUI Compressor is written in Java (requires Java >= 1.4)
omitting as many white space characters as possible, and replacing all local symbols by a 1 (or 2, or 3) letter symbol
wherever such a substitution is appropriate (in the face of
evil features such as
with, the YUI Compressor takes a defensive approach by not obfuscating any of the scopes containing the evil
statement) The CSS compression algorithm uses a set of finely tuned regular expressions to compress the source CSS file.
The YUI Compressor is open-source, so don't hesitate to look at the code to understand exactly how it works.
Using the YUI Compressor from the command line
Note: If no input file is specified, it defaults to stdin.
The following command line (x.y.z represents the version number):
$ java -jar yuicompressor-x.y.z.jar myfile.js -o myfile-min.js
will minify the file
myfile.js and output the file
For more information on how to use the YUI Compressor, please refer to the documentation
included in the archive.
The charset parameter isn't always required, but the compressor may throw an error if the file's encoding is incompatible with the system's default encoding. In particular, if your file is encoded in utf-8, you should supply the parameter.
$ java -jar yuicompressor-x.y.z.jar myfile.js -o myfile-min.js --charset utf-8
Don't hesitate to use the
-voption. Although not a replacement for JSLint, it will output some helpful hints when it senses that something might be wrong with your code.
- If you wish to minify your files on the backend (also known as on-the-fly minification) instead of at build time, you will want to cache the minified files in memory for optimal performance (instead of minifying the same files over and over & minification is a time consuming process) Note that the YUI Compressor can easily be instantiated and used from a Java-based environment (Servlet).
Support & Community
YUICompressor is discussed on the on the YUICompressor Google Group.
Also be sure to check out YUIBlog for updates and articles about the YUI Library written by the library's developers.
Filing Bugs & Feature Requests
YUICompressor uses Github Issues to track issues.
- Helping the YUI Compressor, by Nicholas Zakas
- How to create a YUI Compressor MSBuild Task, by Nick Berardi
- Minification v Obfuscation, by Douglas Crockford
- Introducing the YUI Compressor, by YUI Compressor author Julien Lecomte
- JSMIN, by Douglas Crockford
- ShrinkSafe, aka The Dojo Compressor
- Packer, by Dean Edwards
- CompressorRater, by Arthur Blake