Repository files navigation

Note: This package is now deprecated. Distribution of the JavaScript version has been moved to the main npm distribution athttps://www.npmjs.com/package/google-closure-compiler. This package will continueto work, but no new versions of the package will be published.

Check, compile, transpile, optimize and compress JavaScript with Closure Compiler in JS.

This repo tracks issues related to the publication to npmjs.org and associated plugins.Any bugs not related to the plugins themselves should be reported to themain repository.

Unlike other packages, this allows Closure Compiler to run entirely in JS.Java is not required.

This is an experimental release - meaning some features are not available and performance may not be on-par with the Java implementation -details here.

These instructions will continue to work, but the package is deprecated.Development has moved tohttps://www.npmjs.com/package/google-closure-compiler.

First, install the latest version:

yarn add google-closure-compiler-js --dev# ornpm install --save-dev google-closure-compiler-js

The module supports modern web browsers as well as Node v4 LTS, and providescompile as a low-level method to compile JavaScript.By default, this compiles ES6 to ES5 and includes the default set of ECMAScript externs files.For example:

constcompile=require('google-closure-compiler-js').compile;constflags={jsCode:[{src:'const x = 1 + 2;'}],};constout=compile(flags);console.info(out.compiledCode);// will print 'var x = 3;\n'

Or to install the command-line version, do:

npm install -g google-closure-compiler-js

You should now be able to rungoogle-closure-compiler-js as a command.Thegoogle-closure-compiler-js command can read from stdin or from a file.For example:

google-closure-compiler-js code.js> minified.js

Rungoogle-closure-compiler-js --help for full usage information.

Yourwebpack.config.js should look like this:

constClosureCompiler=require('google-closure-compiler-js').webpack;constpath=require('path');module.exports={entry:[path.join(__dirname,'app.js')],output:{path:path.join(__dirname,'dist'),filename:'app.min.js'},plugins:[newClosureCompiler({options:{languageIn:'ECMASCRIPT6',languageOut:'ECMASCRIPT5',compilationLevel:'ADVANCED',warningLevel:'VERBOSE',},})]};

Yourgulpfile.js should contain a task like this:

constcompiler=require('google-closure-compiler-js').gulp();gulp.task('script',function(){returngulp.src('./path/to/src.js',{base:'./'})// your other steps here.pipe(compiler({compilationLevel:'SIMPLE',warningLevel:'VERBOSE',outputWrapper:'(function(){\n%output%\n}).call(this)',jsOutputFile:'output.min.js',// outputs single filecreateSourceMap:true,})).pipe(gulp.dest('./dist'));});

The Closure Compiler supports the following languages:

• ECMASCRIPT3,ECMASCRIPT5 andECMASCRIPT5_STRICT
• ECMASCRIPT6 andECMASCRIPT6_STRICT
• ECMASCRIPT6_TYPED (experimental)
• ECMASCRIPT_2017 (experimental)

Unless you're using Gulp's or Webpack's plugins, you'll need to specify code via flags:

• BothjsCode andexterns accept an array containing objects in the form{src, path, sourceMap}.
• Usingpath you can construct a virtual filesystem for use with ES6 or CommonJS imports — although for CommonJS you'll have to setprocessCommonJsModules: true.

The JavaScript version of the Closure-Compiler is transpiled by GWT from the Java source.For more details on the differences in behavior see thesuper sourced files in the mainrepository.

Closure Compiler release notes can be found on themain repository wiki.

Copyright © 2017 The Closure Compiler Authors

Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.