Neopolitan Pizza Maker

    grunt-iife

    0.3.0 • Public • Published

    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 (Mai 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

    Install

    npm i grunt-iife

    DownloadsWeekly Downloads

    32

    Version

    0.3.0

    License

    MIT

    Last publish

    Collaborators

    • virtyaluk