Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Managing jQuery plugin dependency in webpack

I'm using Webpack in my application, in which I create two entry points - bundle.js for all my JavaScript files/codes, and vendors.js for all libraries like jQuery and React. What do I do in order to use plugins which have jQuery as their dependencies and I want to have them also in vendors.js? What if those plugins have multiple dependencies?

Currently I'm trying to use this jQuery plugin here - https://github.com/mbklein/jquery-elastic. The Webpack documentation mentions providePlugin and imports-loader. I used providePlugin, but still the jQuery object is not available. Here is how my webpack.config.js looks like-

var webpack = require('webpack'); var bower_dir = __dirname + '/bower_components'; var node_dir = __dirname + '/node_modules'; var lib_dir = __dirname + '/public/js/libs';  var config = {     addVendor: function (name, path) {         this.resolve.alias[name] = path;         this.module.noParse.push(new RegExp(path));     },     plugins: [         new webpack.ProvidePlugin({             $: "jquery",             jquery: "jQuery",             "window.jQuery": "jquery"         }),         new webpack.optimize.CommonsChunkPlugin('vendors', 'vendors.js', Infinity)     ],     entry: {         app: ['./public/js/main.js'],         vendors: ['react','jquery']     },     resolve: {         alias: {             'jquery': node_dir + '/jquery/dist/jquery.js',             'jquery.elastic': lib_dir + '/jquery.elastic.source.js'         }     },     output: {         path: './public/js',         filename: 'bundle.js'     },     module: {         loaders: [             { test: /\.js$/, loader: 'jsx-loader' },             { test: /\.jquery.elastic.js$/, loader: 'imports-loader' }         ]     } }; config.addVendor('react', bower_dir + '/react/react.min.js'); config.addVendor('jquery', node_dir + '/jquery/dist/jquery.js'); config.addVendor('jquery.elastic', lib_dir +'/jquery.elastic.source.js');  module.exports = config; 

But in spite of this, it still throws an error in the browser console:

Uncaught ReferenceError: jQuery is not defined

Similarly, when I use the imports-loader, it throws an error,

require is not defined'

in this line:

var jQuery = require("jquery") 

However, I could use the same plugin when I don't add it to my vendors.js file and instead required it in the normal AMD way as how I include my other JavaScript code files, like-

define( [     'jquery',     'react',     '../../common-functions',     '../../libs/jquery.elastic.source' ],function($,React,commonFunctions){     $("#myInput").elastic() //It works  }); 

But this is not what I want to do, as this would mean that jquery.elastic.source.js is bundled along with my JavaScript code in bundle.js, and I want all my jQuery plugins to be in the vendors.js bundle. So how do I go about achieving this?

like image 325
booleanhunter Avatar asked Mar 10 '15 17:03

booleanhunter


People also ask

What does webpack Provideplugin do?

Automatically load modules instead of having to import or require them everywhere.

What is webpack dependency?

Any time one file depends on another, webpack treats this as a dependency. This allows webpack to take non-code assets, such as images or web fonts, and also provide them as dependencies for your application.

Does webpack include Node_modules?

Webpack allows you to define externals - modules that should not be bundled. When bundling with Webpack for the backend - you usually don't want to bundle its node_modules dependencies. This library creates an externals function that ignores node_modules when bundling in Webpack.


2 Answers

You've mixed different approaches how to include legacy vendor modules. This is how I'd tackle it:

1. Prefer unminified CommonJS/AMD over dist

Most modules link the dist version in the main field of their package.json. While this is useful for most developers, for webpack it is better to alias the src version because this way webpack is able to optimize dependencies better (e.g. when using the DedupePlugin).

// webpack.config.js  module.exports = {     ...     resolve: {         alias: {             jquery: "jquery/src/jquery"         }     } }; 

However, in most cases the dist version works just fine as well.


2. Use the ProvidePlugin to inject implicit globals

Most legacy modules rely on the presence of specific globals, like jQuery plugins do on $ or jQuery. In this scenario you can configure webpack, to prepend var $ = require("jquery") everytime it encounters the global $ identifier.

var webpack = require("webpack");      ...      plugins: [         new webpack.ProvidePlugin({             $: "jquery",             jQuery: "jquery"         })     ] 

3. Use the imports-loader to configure this

Some legacy modules rely on this being the window object. This becomes a problem when the module is executed in a CommonJS context where this equals module.exports. In this case you can override this with the imports-loader.

Run npm i imports-loader --save-dev and then

module: {     loaders: [         {             test: /[\/\\]node_modules[\/\\]some-module[\/\\]index\.js$/,             loader: "imports-loader?this=>window"         }     ] } 

The imports-loader can also be used to manually inject variables of all kinds. But most of the time the ProvidePlugin is more useful when it comes to implicit globals.


4. Use the imports-loader to disable AMD

There are modules that support different module styles, like AMD, CommonJS and legacy. However, most of the time they first check for define and then use some quirky code to export properties. In these cases, it could help to force the CommonJS path by setting define = false.

module: {     loaders: [         {             test: /[\/\\]node_modules[\/\\]some-module[\/\\]index\.js$/,             loader: "imports-loader?define=>false"         }     ] } 

5. Use the script-loader to globally import scripts

If you don't care about global variables and just want legacy scripts to work, you can also use the script-loader. It executes the module in a global context, just as if you had included them via the <script> tag.


6. Use noParse to include large dists

When there is no AMD/CommonJS version of the module and you want to include the dist, you can flag this module as noParse. Then webpack will just include the module without parsing it, which can be used to improve the build time. This means that any feature requiring the AST, like the ProvidePlugin, will not work.

module: {     noParse: [         /[\/\\]node_modules[\/\\]angular[\/\\]angular\.js$/     ] } 
like image 143
Johannes Ewald Avatar answered Sep 29 '22 08:09

Johannes Ewald


For global access to jquery then several options exist. In my most recent webpack project, I wanted global access to jquery so I added the following to my plugins declarations:

 plugins: [     new webpack.ProvidePlugin({       $: "jquery",       jQuery: "jquery"     })   ] 

This then means that jquery is accessible from within the JavaScript source code via global references $ and jQuery.

Of course, you need to have also installed jquery via npm:

$ npm i jquery --save 

For a working example of this approach please feel free to fork my app on github

like image 34
arcseldon Avatar answered Sep 29 '22 08:09

arcseldon