README.md

amdextract

Uses AST to extract AMD modules, their parts and an optimized output without unused dependencies while keeping the original format.

example

source.js

define('module1', ['p1', 'p2'], function (a, b) {
  /**
   * b is not used in this scope.
   */
  return (function(b) {
    return b;
  })(a);
});

define('module2', ['p1', 'p2', 'p3', 'p4'], function (a, b, c) {
	return b;
});

example.js

var fs = require('fs');
var amdextract = require('amdextract');

var content = fs.readFileSync('source.js');
var result = amdextract.parse(content);

console.log(result.results.length + ' modules detected.');

result.results.forEach(function (r) {
	console.log('Unused paths: ' + r.unusedPaths.join(', '));
});

console.log('\nOptimized output:');
console.log(result.optimizedContent);

output

2 modules detected.
Unused paths: p2
Unused paths: p1, p3, p4

Optimized output:

define('module1', ['p1'], function (a) {
  /**
   * b is not used in this scope.
   */
  return (function(b) {
    return b;
  })(a);
});

define('module2', ['p2'], function (b) {
	return b;
});

methods

parse(content[, options])

content

Type: string JavaScript source for parsing.

options

excepts

Type: Array Default value: []

An array of strings or RegExps that represent dependency names that should not take into account.

exceptsPaths

Type: Array Default value: []

An array of strings or RegExps that represent dependency paths that should not take into account.

NOTE: exceptsPaths can also be declared before each module definition as a comment of strings of module paths separated by commas. This only applies on the underlying module definition.

source.js

/* exceptsPaths: p3 */
define(['p1', 'p2', 'p3'], function (a, b, c) {
	return b;
});

optimized-source.js

/* exceptsPaths: p3 */
define(['p2', 'p3'], function (b, c) {
	return b;
});

removeUnusedDependencies

Type: Boolean Default value: false

Removes unused dependencies from content and returns optimized content as optimizedContent property of result.

returns

Returns an object with the following properties:

results

Type: Array

An array of hash objects witch have this properties for each AMD module detected in content:

• moduleId
• paths
• dependencies
• unusedPaths
• unusedDependencies

optimizedContent

Type: String

Optimized content (original content without unused dependencies). This property is available when the value of option removeUnusedDependencies is true.

Release History

• 2015-12-27   v2.1.14   Remove "for in" loop in traverse.
• 2015-12-26   v2.1.13   Remove unused function "extendRange".
• 2015-12-26   v2.1.12   Fixed indentation of samples in README.md.
• 2015-12-26   v2.1.11   Fixed a bug in "optimizedContent" property.
• 2015-07-25   v2.1.10   Update travis CI.
• 2015-07-25   v2.1.9   Update dependencies.
• 2015-04-15   v2.1.8   Update README.
• 2014-08-22   v2.1.6   Fix a bug when there are comments between paths and dependencies.
• 2014-08-16   v2.1.0   Entirely uses AST.
• 2014-07-21   v2.0.3   Fix an issue related to comment detection.
• 2014-07-21   v2.0.2   Fix an issue related to RegExp literals.
• 2014-07-20   v2.0.0   Uses AST to find out unused dependencies.
• 2014-04-19   v1.1.0   Keeps the original separators of paths and dependencies.
• 2014-04-09   v1.0.4   Fix a bug when dependencies length is grater than paths length.
• 2014-03-29   v1.0.3   Fix a bug when specifying exceptsPaths in options only.
• 2014-03-17   v1.0.0   First release.