NAME

jsdoc-plugin-strip-outer-iife - JSDoc plugin to filter out root-level IIFE before processing

INSTALL

mkdir node_modules
npm install jsdoc-plugin-strip-outer-iife
cp node_modules/jsdoc-plugin-strip-outer-iife/strip-outer-iife.js node_modules/jsdoc/plugins/
# create jsdoc.conf.json mentioning this plugin, see below

JSDoc configuration

Sample JSDoc configuration file, e.g. jsdoc.conf.json

1{ "plugins": [ "plugins/strip-outer-iife.js" ] }

RUN

jsdoc --configure jsdoc.conf.json inputfile.js

DESCRIPTION

This is a plugin for jsdoc using the jsdoc-plugins system to filter source code before it's seen by the main JSDoc parser to remove the common root-level IIFE's. The intent of this plugin is to:

• Be harmless in case it doesn't understand your content.
• Allow comments and whitespace before your root-level IIFE.
• Ignore any and all IIFE's in the body.
• Allow anything after the close of the root-level IIFE.
• Only consider IIFE's that start at the beginning of a line, without whitespace.
• Only consider IIFE's that end at the beginning of a line, without whitespace.

EXAMPLES

All of these should get removed:

Basic inner

1(function(){
2    // Whatever is in here gets saved.
3}());

Basic outer

1(function(){
2    // Whatever is in here gets saved.
3})();

Browser window

1(function(){
2    // Whatever is in here gets saved.
3})(window);

CoffeeScript

1(function(){
2    // Whatever is in here gets saved.
3}).call(this);

Common inner

1/**
2 * It's okay to have comments here, these get preserved
3 */
4// So do single line comments like this
5(function(){
6    // Whatever is in here gets saved.
7}());
8// It's also okay to have comments here -- also preserved

LICENSE

This module is licensed under CC0, a kind of internationally-aware "public domain" license, or more properly said: a declaration of my affirmative intent to waive the rights normally reserved under copyright law. You're free to copy, modify, sell for profit, etc, without any need to contact me, give me attribution, reproduce the license text, etc. See LICENSE for the full license text.

TODO

Why not use this module

• Not using a real JavaScript parser to modify the input stream, only regular expressions.
• Doesn't use the JSDoc plugin style (yet).
• Not the right way to fix the problem, see jsdoc-issue-456