Skip to content

🗜️ A Grunt plugin for wrapping JavaScript code in IIFEs.

License

Notifications You must be signed in to change notification settings

modern-dev/grunt-iife

Repository files navigation

grunt-iife

Build Status Code Climate Dependency Status npm version

A Grunt plugin for wrapping JavaScript code within immediately invoked function expressions (IIFEs).

Wraps JavaScript code within an immediately invoked function expression.

💿 Getting Started

This plugin requires Grunt >=0.4.0

If you haven't used 🔗Grunt before, be sure to check out the 🔗Getting Started guide, as it explains how to create a 🔗Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

$ npm install --save-dev grunt-iife

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-iife');

⚡ Usage

This configuration will wrap JS files using the default options.

// Project configuration.
grunt.initConfig({
    iife: {
        myTarget: {
            files: {
                'dest/output.js': 'src/input.js'
            }
        }
    }
});

So, if input file looks like this:

var foo = 'bar';
console.log(foo);

Then output file will be like this:

;(function() {
'use strict';
var foo = 'bar';
console.log(foo);
}());

🔧 Options

You can pass additional options to change output file:

useStrict

  • Type: Boolean
  • Default: true

A boolean indicating whether to prepend a 'use strict'; directive to the function body.

prependSemicolon

  • Type: Boolean
  • Default: true

A boolean indicating whether to prepend a semicolon as statement terminator before the IIFE.

bindThis

  • Type: Boolean
  • Default: false

A boolean indicating whether to append .bind(this) to the IIFE. Setting this value to true makes the surrounding global object available to the function, which is usually not the case in strict mode.

trimCode

  • Type: Boolean
  • Default: true

A boolean indicating whether to remove leading & trailing whitespace from the code.

args

  • Type: String[]
  • Default: null

An array of argument names to be passed into the IIFE. If the params option is not specified, the parameters of the function will have the same names as the arguments passed.

params

  • Type: String[]
  • Default: null

An array of parameter names to be accepted by the IIFE. If the args option is not specified, the same identifiers will be passed as arguments of the function call.

indent

  • Type: String
  • Default: null

A string value that is used to indent.

Here's an example specifying all available options:

grunt.initConfig({
    iife: {
        myTarget: {
            options: {
                useStrict: true,
                prependSemicolon: false,
                bindThis: true,
                trimCode: true,
                indent
                args: ['window', '$'],
                params: ['window', 'jQuery']
            },
            files: {
                'dest/output.js': 'src/input.js'
            }
        }
    }
});

Input file:

var foo = 'bar';
console.log(foo);

Output file:

(function(window, $) {
    'use strict';
    var foo = 'bar';
    console.log(foo);
}(window, jQuery));

📜 Changelog

0.2.0 (April 30, 2016)

  • Fixed issue resulting in error while performing iife task.

0.3.0 (May 1, 2016)

  • Added new feature - indentation of code. @brunowego in #3.
  • Codebase improvements.

📗 License

Licensed under the MIT license.

Copyright (c) 2016 Bohdan Shtepan and all the contributors.


modern-dev.com  ·  GitHub @virtyaluk  ·  Twitter @virtyaluk