JavaScript dependency checker/fixer for Closure Library based on ECMAScript AST
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


fixclosure is JavaScript dependency checker/fixer for Closure Library based on ECMAScript AST. It finds namespaces used in a JavaScript file and insert/remove goog.provide / goog.require automatically.

npm version Node.js Version Support Build Status Dependency Status Coverage Status License


$ npm install -g fixclosure


Following foo.js requires an unused namespace goog.unused. Also goog.missing is used but not required.

// foo.js (before)

goog.require('goog.unused'); = function() {;

Fix it !

$ fixclosure --fix-in-place foo.js
File: foo.js


- goog.unused

Missing Require:
- goog.missing

Unnecessary Require:
- goog.unused


1 files fixed

Fixed !
goog.require('goog.unused') is removed and goog.require('goog.missing') is inserted.

// foo.js (fixed!)

goog.require('goog.missing'); = function() {;

Rules fixclosure checked

fixclosure checks and fixes:

  • Duplicated require/provide
  • Missing require/provide
  • Unnecessary require/provide

gjslint beforehand

Run Closure Linter (gjslint) before fixclosure. fixclosure is based on the assumption that target files are linted by it.

Use with Grunt

Use grunt-fixclosure plugin.

Configuration file

fixclosure loads options from .fixclosurerc config file like:

--provideRoots foo,bar
--namespaceMethods foo.foo1,bar.bar1

fixclosure will find the file in the current directory and, if not found, will move one level up the directory tree all the way up to the filesystem root.


-f or --fix-in-place

If an invalid file is found, fixclosure fixes the file in place.


.fixclosurerc file path.
Specify if your file is not in the search path.


Specify your root namespaces to provide. Default is goog. Comma separated list.


Specify root namespaces to require. Default require roots are --provideRoots value and goog,proto2,soy,soydata,svgpan. Comma separated list.


Specify method or property exported as a namespace itself like goog.dispose.
Comma separated list.


Replace method or property to namespace mapping like goog.disposeAll:goog.dispose.
Comma separated list of colon separated pairs like foo.bar1:foo.bar2,foo.bar3:foo.bar4.


Show not only failed files but also passed files.


Disable color output.


Deprecated by --provideRoots and --requireRoots. This will be removed next update.

Specify your root namespaces in addition to default roots goog,proto2,soy,soydata,svgpan. Comma separated list.

Inline hint

fixclosure reads "hint" for lint from special comments in your code.


fixclosure doesn't remove any goog.provide and goog.require with this hint.

goog.provide(''); // fixclosure: ignore

goog.require(''); // fixclosure: ignore

In the above, goog.provide('') will not removed by fixclosure even if it isn't provided in the file. Also goog.require('') will not removed if it isn't used. The hint affects only same line. Useful in module declaration.

fixclosure: suppressUnused is deprecated and will be removed next update.


Suppress goog.require auto insertion.

// fixclosure: suppressRequire;

In the above, goog.require('') will not inserted. The hint affects only next line. This is useful to workaround cyclic reference.


Suppress goog.provide auto insertion.

// fixclosure: suppressProvide
goog.Foo = function() {};

In the above, goog.provide('goog.Foo') will not inserted. The hint affects only next line.


  • 1.5.4 (2016/05/29)
    • Internal: Update dependencies
    • Internal: Use ESLint and eslint-config-teppeis
    • Internal: Testing in Node v0.12, v4 and v6 on Travis.CI (v0.10 and v5 are removed)
  • 1.5.3 (2016/03/16)
    • Bugfix: missing index.js in published package #63
  • 1.5.2 (2016/03/15)
    • Build: use eslint-plugin-node and exclude test directory from npm package #62
  • 1.5.1 (2016/03/14)
    • Bugfix: change estraverse(-fb) to dependencies #61
  • 1.5.0 (2016/03/13)
    • Feat: Support JSX #60
    • Internal: Use espree instead of esprima #59
  • 1.4.0 (2016/03/13)
    • Feat: Support ES6 syntax #58
  • 1.3.5 (2016/03/12)
    • Internal: Use estraverse #56
    • Internal: Use istanbul for test coverage
  • 1.3.4 (2016/03/10)
    • Internal: Update dependencies #50, #51, #52
  • 1.3.3 (2016/01/05)
    • Add check for @extends using with @interface #49
  • 1.3.2 (2014/06/25)
    • Bugfix: Add goog.dom.BufferedViewportSizeMonitor.EventType to default replace map #47
  • 1.3.1 (2014/06/18)
    • Bugfix: Don't remove ignored provides #46
  • 1.3.0 (2014/06/10)
    • Add --provideRoots and --requireRoots and make --roots deprecated.
    • Add "fixclosure: ignore" and make "fixclosure: suppressUnused" deprecated #44
    • Add "fixclosure: suppressProvide" #43
  • 1.2.2 (2014/06/05)
    • Improve default namespace methods #45
  • 1.2.1 (2014/05/30)
    • Allow comment after an inline hint #41
    • Use attachComment of Esprima 1.2 internaly #40
  • 1.2.0 (2014/05/02)
    • Don't insert a blank line with --fix-in-place #38
    • Update esprima 1.2.0
  • 1.1.0 (2014/04/28)
    • Update dependencies #39
  • 1.0.1 (2014/04/01)
    • Fix --no-color #37
  • 1.0.0 (2014/02/17)
    • Some features, bug fixes and breaking changes. See release note .
  • 0.2.1 (2013/11/21)
    • Fix --replaceMap
  • 0.2.0 (2013/11/15)
    • Add .fixclosurerc
    • Add --no-color
  • 0.1.5 (2013/11/15)
    • Update dependencies.
  • 0.1.3 (2012/12/08)
    • Append package methods of Closure Library.
    • Change version option from -V to -v.
    • Change exit code of invalid argument to 1.
    • Fix for private properties.
  • 0.1.2 (2012/11/28)
    • Supports const property correctly.
    • Supports a method starting with "$".
    • Ignore
    • Don't provide @typedef type resources.
    • Fix #5 don't provide a private class.
    • Fix #6 Don't require a private method defined in the same file.
    • Add some package methods.
  • 0.1.1 (2012/11/25)
    • Scope check (by piglovesyou)
    • Root package filter works for toProvide list.
  • 0.1.0 Add some options
    • Changes "fix in place" option to "-f" from "-i"
    • Implements root package filter (default: "goog")
    • Adds options --roots, --namespaceMethods and --replaceMap
  • 0.0.2 Bugfix
  • 0.0.1 Initial release


MIT License: Teppei Sato