Karma webpack Middleware
Clone or download
Permalink
Failed to load latest commit information.
.circleci refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.github refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
src fix(karma-webpack): don't include the `os.tmpdir` (`output.publicPath… Sep 7, 2018
test refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.babelrc refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.editorconfig refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.eslintignore refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.eslintrc refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.eslintrc.js refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.gitattributes refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.gitignore refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
.prettierrc refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
CHANGELOG.md chore(release): 4.0.0-rc.2 Sep 7, 2018
CONTRIBUTING.md chore(release): Add changelog generation Aug 5, 2016
LICENSE docs(license): JS Foundation standard license (#217) Feb 21, 2017
README.md docs(README): standardize Feb 25, 2018
appveyor.yml refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
codecov.yml refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
commitlint.config.js refactor(package): apply `webpack-defaults` (#340) Sep 1, 2018
package-lock.json chore(release): 4.0.0-rc.2 Sep 7, 2018
package.json chore(release): 4.0.0-rc.2 Sep 7, 2018

README.md

npm node deps test coverage chat

Karma Webpack

Use webpack to preprocess files in karma

Install

npm i -D karma-webpack

Usage

karma.conf.js

module.exports = (config) => {
  config.set({
    // ... normal karma configuration
    files: [
      // all files ending in "_test"
      { pattern: 'test/*_test.js', watched: false },
      { pattern: 'test/**/*_test.js', watched: false }
      // each file acts as entry point for the webpack configuration
    ],

    preprocessors: {
      // add webpack as preprocessor
      'test/*_test.js': [ 'webpack' ],
      'test/**/*_test.js': [ 'webpack' ]
    },

    webpack: {
      // karma watches the test entry points
      // (you don't need to specify the entry option)
      // webpack watches dependencies

      // webpack configuration
    },

    webpackMiddleware: {
      // webpack-dev-middleware configuration
      // i. e.
      stats: 'errors-only'
    }
  })
}

Alternative Usage

This configuration is more performant, but you cannot run single test anymore (only the complete suite).

The above configuration generates a webpack bundle for each test. For many test cases this can result in many big files. The alternative configuration creates a single bundle with all test cases.

karma.conf.js

files: [
  // only specify one entry point
  // and require all tests in there
  'test/index_test.js'
],

preprocessors: {
  // add webpack as preprocessor
  'test/index_test.js': [ 'webpack' ]
},

test/index_test.js

// require all modules ending in "_test" from the
// current directory and all subdirectories
const testsContext = require.context(".", true, /_test$/)

testsContext.keys().forEach(testsContext)

Every test file is required using the require.context and compiled with webpack into one test bundle.

Source Maps

You can use the karma-sourcemap-loader to get the source maps generated for your test bundle.

npm i -D karma-sourcemap-loader

And then add it to your preprocessors.

karma.conf.js

preprocessors: {
  'test/test_index.js': [ 'webpack', 'sourcemap' ]
}

And tell webpack to generate sourcemaps.

webpack.config.js

webpack: {
  // ...
  devtool: 'inline-source-map'
}

Options

This is the full list of options you can specify in your karma.conf.js

Name Type Default Description
webpack {Object} {} Pass webpack.config.js to karma
webpackMiddleware {Object} {} Pass webpack-dev-middleware configuration to karma
beforeMiddleware {Object} {} Pass custom middleware configuration to karma, before any karma middleware runs

webpack

webpack configuration (webpack.config.js).

webpackMiddleware

Configuration for webpack-dev-middleware.

beforeMiddleware

beforeMiddleware is a webpack option that allows injecting middleware before karma's own middleware runs. This loader provides a webpackBlocker middleware that will block tests from running until code recompiles. That is, given this scenario

  1. Have a browser open on the karma debug page (http://localhost:9876/debug.html)
  2. Make a code change
  3. Refresh

Without the webpackBlocker middleware karma will serve files from before the code change. With the webpackBlocker middleware the loader will not serve the files until the code has finished recompiling.

⚠️ The beforeMiddleware option is only supported in karma >= v1.0.0

Maintainers


Mika Kalathil
Joshua Wiens Will Farley Daniela Valero
Jonathan Trang Carlos Morales