Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/privatenumber/instant-mocha

☕️ Build tests with Webpack and run with Mocha in one command
https://github.com/privatenumber/instant-mocha

binary cli mocha runner testing watch webpack

Last synced: 7 days ago
JSON representation

☕️ Build tests with Webpack and run with Mocha in one command

Host: GitHub
URL: https://github.com/privatenumber/instant-mocha
Owner: privatenumber
License: mit
Created: 2021-04-25T05:34:17.000Z (over 3 years ago)
Default Branch: develop
Last Pushed: 2024-10-12T06:58:38.000Z (23 days ago)
Last Synced: 2024-10-19T01:11:18.125Z (16 days ago)
Topics: binary, cli, mocha, runner, testing, watch, webpack
Language: TypeScript
Homepage:
Size: 492 KB
Stars: 48
Watchers: 3
Forks: 6
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

instant-mocha

Build tests with Webpack and run them with Mocha in one command

### Features
- Source-map support
- Builds and runs in-memory
- Inherits Mocha CLI
- Supports Webpack 5 + Mocha 8, 9, & 10

_How does it compare to [mocha-webpack](https://github.com/zinserjan/mocha-webpack) / [mochapack](https://github.com/sysgears/mochapack)?_ Answered in the [FAQ](#how-is-it-different-from-mocha-webpack-or-its-fork-mochapack).

## 🚀 Install
```sh
npm i -D mocha webpack instant-mocha
```

Note: `webpack` and `mocha` are peer-dependencies so you can provide any version

## 👨‍🏫 Usage
```sh
instant-mocha [test paths/globs...]
```

You can either use [`npx`](https://www.npmjs.com/package/npx) (eg. `npx instant-mocha ...`) or add it to [`package.json` scripts](https://nodejs.dev/learn/the-package-json-guide) (eg. `npm test`) to invoke it.

### Options
#### -w, --watch
Watch mode. Re-compiles the Webpack build and re-run tests on file-changes.

#### --webpack-config
Default: `webpack.config.js`

Path to the Webpack config.

#### Supports all options from Mocha CLI
For more info, run:
```sh
instant-mocha --help
```

### Example
```sh
instant-mocha ---webpack-config webpack.config.js --require setup.js 'tests/*.spec.js'
```
- Load Webpack config from `webpack.config.js`
- Load setup script from `setup.js`. _Note, this is not apart of the build and is loaded directly from Node.js_
- Find and run tests that matches glob `tests/*.spec.js`

## 💁‍♀️ FAQ

### How do I enable source-maps?
Set [`devtool: 'source-map'`](https://webpack.js.org/configuration/devtool/) in your Webpack config.

### How do I add a progress bar?
Add [webpackbar](https://github.com/unjs/webpackbar) to your Webpack config.

### Are `node_modules` automatically externalized?
They can't be automatically externalized because it's possible some dependencies require bundling or pre-processing. For example, packages in [ESM format](https://nodejs.org/api/esm.html) or deep-dependencies that are stubbed for testing.

It's recommended to externalize what you can in your [Webpack config](https://webpack.js.org/configuration/externals/) to speed up the build though. Consider using [`webpack-node-externals`](https://github.com/liady/webpack-node-externals) to do this.

### How is it different from [mocha-webpack](https://github.com/zinserjan/mocha-webpack) or its fork [mochapack](https://github.com/sysgears/mochapack)?

_First of all, major thanks to [mocha-webpack](https://github.com/zinserjan/mocha-webpack) for the original implementation and serving the community._

This project was created from scratch because `mocha-webpack` is no longer maintained and doesn't have Webpack 5 support.

Some notable improvements include:
- **Written in TypeScript** whereas `mocha-webpack` uses [Flow](https://github.com/facebook/flow).
- **Doesn't re-implement another file-watching mechanism** Relies on Webpack's watcher instead.
- **Loosely coupled with Mocha and Webpack** The API surface used is very narrow so it works with most versions, (eg. Webpack 4 & 5).
- **Correct exit codes** Mocha and `mocha-webpack` returns the number of failed tests as the exit code. instant-mocha only uses exit code `1` for any test failures as per [Bash convention](https://tldp.org/LDP/abs/html/exitcodes.html).
- **Smaller size** Reuses a lot from Webpack & Mocha so it's much lighter: [![instant-mocha install size](https://packagephobia.now.sh/badge?p=instant-mocha)](https://packagephobia.now.sh/result?p=instant-mocha) vs [![mocha-webpack install size](https://packagephobia.now.sh/badge?p=mocha-webpack)](https://packagephobia.now.sh/result?p=mocha-webpack)

## Sponsors