Created
February 4, 2016 17:01
-
-
Save teppeis/d6ead25b2dafd15c0a30 to your computer and use it in GitHub Desktop.
Closure Compiler Help (v20160201)
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| --angular_pass : Generate $inject properties for | |
| AngularJS for functions annotated | |
| with @ngInject | |
| --assume_function_wrapper : Enable additional optimizations based | |
| on the assumption that the output | |
| will be wrapped with a function | |
| wrapper. This flag is used to | |
| indicate that "global" declarations | |
| will not actually be global but | |
| instead isolated to the compilation | |
| unit. This enables additional | |
| optimizations. | |
| --charset VAL : Input and output charset for all | |
| files. By default, we accept UTF-8 as | |
| input and output US_ASCII | |
| --checks-only : Don't generate output. Run checks, | |
| but no compiler passes. | |
| --closure_entry_point VAL : Deprecated: use --entry_point. | |
| --common_js_entry_module VAL : Deprecated: use --entry_point. | |
| --common_js_module_path_prefix VAL : Deprecated: use --js_module_root. | |
| --compilation_level (-O) VAL : Specifies the compilation level to | |
| use. Options: WHITESPACE_ONLY, | |
| SIMPLE, ADVANCED | |
| --conformance_configs VAL : A list of JS Conformance configuration | |
| s in text protocol buffer format. | |
| --create_renaming_reports : If true, variable renaming and | |
| property renaming report files will | |
| be produced as {binary name}_vars_rena | |
| ming_report.out and {binary name}_prop | |
| s_renaming_report.out. Note that this | |
| flag cannot be used in conjunction | |
| with either variable_renaming_report | |
| or property_renaming_report | |
| --create_source_map VAL : If specified, a source map file | |
| mapping the generated source files | |
| back to the original source file will | |
| be output to the specified path. The | |
| %outname% placeholder will expand to | |
| the name of the output file that the | |
| source map corresponds to. | |
| --dart_pass : Rewrite Dart Dev Compiler output to | |
| be compiler-friendly. | |
| --debug : Enable debugging options | |
| --define (--D, -D) VAL : Override the value of a variable | |
| annotated @define. The format is | |
| <name>[=<val>], where <name> is the | |
| name of a @define variable and <val> | |
| is a boolean, number, or a single-quot | |
| ed string that contains no single | |
| quotes. If [=<val>] is omitted, the | |
| variable is marked true | |
| --dependency_mode [NONE | LOOSE | : Specifies how the compiler should | |
| STRICT] : determine the set and order of files | |
| for a compilation. Options: NONE the | |
| compiler will include all src files | |
| in the order listed, STRICT files | |
| will be included and sorted by | |
| starting from namespaces or files | |
| listed by the --entry_point flag - | |
| files will only be included if they | |
| are referenced by a goog.require or | |
| CommonJS require or ES6 import, LOOSE | |
| same as with STRICT but files which | |
| do not goog.provide a namespace and | |
| are not modules will be automatically | |
| added as --entry_point entries. | |
| Defaults to NONE. | |
| --entry_point VAL : A file or namespace to use as the | |
| starting point for determining which | |
| src files to include in the compilatio | |
| n. ES6 and CommonJS modules are | |
| specified as file paths (without the | |
| extension). Closure-library namespaces | |
| are specified with a "goog:" prefix. | |
| Example: --entry_point=goog:goog.Promi | |
| se | |
| --env [BROWSER | CUSTOM] : Determines the set of builtin externs | |
| to load. Options: BROWSER, CUSTOM. | |
| Defaults to BROWSER. | |
| --export_local_property_definitions : Generates export code for local | |
| properties marked with @export | |
| --externs VAL : The file containing JavaScript | |
| externs. You may specify multiple | |
| --extra_annotation_name VAL : A whitelist of tag names in JSDoc. | |
| You may specify multiple | |
| --flagfile VAL : A file containing additional command-l | |
| ine options. | |
| --formatting [PRETTY_PRINT | PRINT_INP : Specifies which formatting options, | |
| UT_DELIMITER | SINGLE_QUOTES] : if any, should be applied to the | |
| output JS. Options: PRETTY_PRINT, | |
| PRINT_INPUT_DELIMITER, SINGLE_QUOTES | |
| --generate_exports : Generates export code for those | |
| marked with @export | |
| --help : Displays this message on stdout and | |
| exit | |
| --hide_warnings_for VAL : If specified, files whose path | |
| contains this string will have their | |
| warnings hidden. You may specify | |
| multiple. | |
| --instrumentation_template VAL : A file containing an instrumentation | |
| template. | |
| --j2cl_pass : Rewrite J2CL output to be compiler-fri | |
| endly. | |
| --js VAL : The JavaScript filename. You may | |
| specify multiple. The flag name is | |
| optional, because args are interpreted | |
| as files by default. You may also use | |
| minimatch-style glob patterns. For | |
| example, use --js='**.js' --js='!**_te | |
| st.js' to recursively include all js | |
| files that do not end in _test.js | |
| --js_module_root VAL : Path prefixes to be removed from ES6 | |
| & CommonJS modules. | |
| --js_output_file VAL : Primary output filename. If not | |
| specified, output is written to stdout | |
| --jscomp_error VAL : Make the named class of warnings an | |
| error. Options:accessControls, | |
| ambiguousFunctionDecl, checkEventfulOb | |
| jectDisposal, checkRegExp, checkTypes, | |
| checkVars, conformanceViolations, | |
| const, constantProperty, deprecated, | |
| deprecatedAnnotations, duplicateMessag | |
| e, es3, es5Strict, externsValidation, | |
| fileoverviewTags, globalThis, | |
| internetExplorerChecks, invalidCasts, | |
| misplacedTypeAnnotation, missingGetCss | |
| Name, missingProperties, missingProvid | |
| e, missingRequire, missingReturn, | |
| msgDescriptions, newCheckTypes, | |
| nonStandardJsDocs, reportUnknownTypes, | |
| suspiciousCode, strictModuleDepCheck, | |
| typeInvalidation, undefinedNames, | |
| undefinedVars, unknownDefines, | |
| unnecessaryCasts, unusedLocalVariables | |
| , unusedPrivateMembers, uselessCode, | |
| useOfGoogBase, visibility. '*' adds | |
| all supported. | |
| --jscomp_off VAL : Turn off the named class of warnings. | |
| Options:accessControls, ambiguousFunct | |
| ionDecl, checkEventfulObjectDisposal, | |
| checkRegExp, checkTypes, checkVars, | |
| conformanceViolations, const, | |
| constantProperty, deprecated, | |
| deprecatedAnnotations, duplicateMessag | |
| e, es3, es5Strict, externsValidation, | |
| fileoverviewTags, globalThis, | |
| internetExplorerChecks, invalidCasts, | |
| misplacedTypeAnnotation, missingGetCss | |
| Name, missingProperties, missingProvid | |
| e, missingRequire, missingReturn, | |
| msgDescriptions, newCheckTypes, | |
| nonStandardJsDocs, reportUnknownTypes, | |
| suspiciousCode, strictModuleDepCheck, | |
| typeInvalidation, undefinedNames, | |
| undefinedVars, unknownDefines, | |
| unnecessaryCasts, unusedLocalVariables | |
| , unusedPrivateMembers, uselessCode, | |
| useOfGoogBase, visibility. '*' adds | |
| all supported. | |
| --jscomp_warning VAL : Make the named class of warnings a | |
| normal warning. Options:accessControls | |
| , ambiguousFunctionDecl, checkEventful | |
| ObjectDisposal, checkRegExp, checkType | |
| s, checkVars, conformanceViolations, | |
| const, constantProperty, deprecated, | |
| deprecatedAnnotations, duplicateMessag | |
| e, es3, es5Strict, externsValidation, | |
| fileoverviewTags, globalThis, | |
| internetExplorerChecks, invalidCasts, | |
| misplacedTypeAnnotation, missingGetCss | |
| Name, missingProperties, missingProvid | |
| e, missingRequire, missingReturn, | |
| msgDescriptions, newCheckTypes, | |
| nonStandardJsDocs, reportUnknownTypes, | |
| suspiciousCode, strictModuleDepCheck, | |
| typeInvalidation, undefinedNames, | |
| undefinedVars, unknownDefines, | |
| unnecessaryCasts, unusedLocalVariables | |
| , unusedPrivateMembers, uselessCode, | |
| useOfGoogBase, visibility. '*' adds | |
| all supported. | |
| --json_streams [NONE | IN | OUT | : Specifies whether standard input and | |
| BOTH] : output streams will be a JSON array | |
| of sources. Each source will be an | |
| object of the form {path: filename, | |
| src: file_contents, srcmap: srcmap_con | |
| tents }. Intended for use by stream-ba | |
| sed build systems such as gulpjs. | |
| Options: NONE, IN, OUT, BOTH. | |
| Defaults to NONE. | |
| --jszip VAL : The JavaScript zip filename. You may | |
| specify multiple. | |
| --language_in VAL : Sets what language spec that input | |
| sources conform. Options: ECMASCRIPT3, | |
| ECMASCRIPT5, ECMASCRIPT5_STRICT, | |
| ECMASCRIPT6 (default), ECMASCRIPT6_STR | |
| ICT, ECMASCRIPT6_TYPED (experimental) | |
| --language_out VAL : Sets what language spec the output | |
| should conform to. Options: ECMASCRIPT | |
| 3 (default), ECMASCRIPT5, ECMASCRIPT5_ | |
| STRICT, ECMASCRIPT6_TYPED (experimenta | |
| l) | |
| --logging_level VAL : The logging level (standard java.util. | |
| logging.Level values) for Compiler | |
| progress. Does not control errors or | |
| warnings for the JavaScript code | |
| under compilation | |
| --manage_closure_dependencies : Deprecated: use --dependency_mode=LOOS | |
| E. | |
| --module VAL : A JavaScript module specification. | |
| The format is <name>:<num-js-files>[:[ | |
| <dep>,...][:]]]. Module names must be | |
| unique. Each dep is the name of a | |
| module that this module depends on. | |
| Modules must be listed in dependency | |
| order, and JS source files must be | |
| listed in the corresponding order. | |
| Where --module flags occur in | |
| relation to --js flags is unimportant. | |
| <num-js-files> may be set to 'auto' | |
| for the first module if it has no | |
| dependencies. Provide the value | |
| 'auto' to trigger module creation | |
| from CommonJSmodules. | |
| --module_output_path_prefix VAL : Prefix for filenames of compiled JS | |
| modules. <module-name>.js will be | |
| appended to this prefix. Directories | |
| will be created as needed. Use with | |
| --module | |
| --module_wrapper VAL : An output wrapper for a JavaScript | |
| module (optional). The format is | |
| <name>:<wrapper>. The module name | |
| must correspond with a module | |
| specified using --module. The wrapper | |
| must contain %s as the code placeholde | |
| r. The %basename% placeholder can | |
| also be used to substitute the base | |
| name of the module output file. | |
| --new_type_inf : Checks for type errors using the new | |
| type inference algorithm. | |
| --noinject_library VAL : Prevent injecting the named runtime | |
| libraries. | |
| --only_closure_dependencies : Deprecated: use --dependency_mode=STRI | |
| CT. | |
| --output_manifest VAL : Prints out a list of all the files in | |
| the compilation. If --dependency_mode= | |
| STRICT or LOOSE is specified, this | |
| will not include files that got | |
| dropped because they were not | |
| required. The %outname% placeholder | |
| expands to the JS output file. If | |
| you're using modularization, using | |
| %outname% will create a manifest for | |
| each module. | |
| --output_module_dependencies VAL : Prints out a JSON file of dependencies | |
| between modules. | |
| --output_wrapper VAL : Interpolate output into this string | |
| at the place denoted by the marker | |
| token %output%. Use marker token | |
| %output|jsstring% to do js string | |
| escaping on the output. | |
| --output_wrapper_file VAL : Loads the specified file and passes | |
| the file contents to the --output_wrap | |
| per flag, replacing the value if it | |
| exists. | |
| --polymer_pass : Rewrite Polymer classes to be | |
| compiler-friendly. | |
| --preserve_type_annotations : Preserves type annotations. | |
| --print_ast : Prints a dot file describing the | |
| internal abstract syntax tree and | |
| exits | |
| --print_pass_graph : Prints a dot file describing the | |
| passes that will get run and exits | |
| --print_tree : Prints out the parse tree and exits | |
| --process_closure_primitives : Processes built-ins from the Closure | |
| library, such as goog.require(), | |
| goog.provide(), and goog.exportSymbol( | |
| ). True by default. | |
| --process_common_js_modules : Process CommonJS modules to a | |
| concatenable form. | |
| --process_jquery_primitives : Processes built-ins from the Jquery | |
| library, such as jQuery.fn and | |
| jQuery.extend() | |
| --property_renaming_report VAL : File where the serialized version of | |
| the property renaming map produced | |
| should be saved | |
| --rename_prefix_namespace VAL : Specifies the name of an object that | |
| will be used to store all non-extern | |
| globals | |
| --source_map_format [DEFAULT | V3] : The source map format to produce. | |
| Options are V3 and DEFAULT, which are | |
| equivalent. | |
| --source_map_input VAL : Source map locations for input files, | |
| separated by a '|', (i.e. input-file-p | |
| ath|input-source-map) | |
| --source_map_location_mapping VAL : Source map location mapping separated | |
| by a '|' (i.e. filesystem-path|webserv | |
| er-path) | |
| --summary_detail_level N : Controls how detailed the compilation | |
| summary is. Values: 0 (never print | |
| summary), 1 (print summary only if | |
| there are errors or warnings), 2 | |
| (print summary if the 'checkTypes' | |
| diagnostic group is enabled, see | |
| --jscomp_warning), 3 (always print | |
| summary). The default level is 1 | |
| --third_party : Check source validity but do not | |
| enforce Closure style rules and | |
| conventions | |
| --tracer_mode [ALL | RAW_SIZE | : Shows the duration of each compiler | |
| TIMING_ONLY | OFF] : pass and the impact to the compiled | |
| output size. Options: ALL, RAW_SIZE, | |
| TIMING_ONLY, OFF | |
| --transform_amd_modules : Transform AMD to CommonJS modules. | |
| --translations_file VAL : Source of translated messages. | |
| Currently only supports XTB. | |
| --translations_project VAL : Scopes all translations to the | |
| specified project.When specified, we | |
| will use different message ids so | |
| that messages in different projects | |
| can have different translations. | |
| --use_types_for_optimization : Enable or disable the optimizations | |
| based on available type information. | |
| Inaccurate type annotations may | |
| result in incorrect results. | |
| --variable_renaming_report VAL : File where the serialized version of | |
| the variable renaming map produced | |
| should be saved | |
| --version : Prints the compiler version to stdout | |
| and exit. | |
| --warning_level (-W) [QUIET | DEFAULT : Specifies the warning level to use. | |
| | VERBOSE] : Options: QUIET, DEFAULT, VERBOSE | |
| --warnings_whitelist_file VAL : A file containing warnings to | |
| suppress. Each line should be of the | |
| form | |
| <file-name>:<line-number>? <warning-d | |
| escription> |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment