Webpack Dev Middleware

Примечание: webpack-dev-middleware предназначен для продвинутых пользователей. Для готового решения см. webpack-dev-server.
Примечание: Для нескольких webpack конфигураций см. middware или dev-middleware
Если вы ищете этот middleware для koa2 экосистемы с поддержкой HMR, см. koa-webpack-middleware.

Webpack-dev-middleware — это небольшой middleware для стека middleware на основе connect. Он использует webpack для компиляции ресурсов в памяти и их предоставления. Когда выполняется компиляция, каждый запрос к предоставленным webpack ресурсам блокируется до получения стабильного пакета.

Вы можете использовать его в двух режимах:

• режим наблюдения (по умолчанию): компилятор перекомпилирует при изменении файла.
• режим отложенной компиляции: компилятор компилирует при каждом запросе к точке входа.

API

var webpackDevMiddleware = require("webpack-dev-middleware");
var webpack = require("webpack");

var compiler = webpack({
    // configuration
    output: { path: '/' }
});

app.use(webpackDevMiddleware(compiler, {
    // options
}));

параметры

noInfo

Не отображать информацию в консоли (только предупреждения и ошибки)

По умолчанию: false

quiet

Не отображать ничего в консоли

По умолчанию: false

lazy

Переключиться в режим отложенной компиляции.

По умолчанию: false

В режиме отложенной компиляции: запрос должен инициировать компиляцию.

filename

В большинстве случаев это соответствует параметру конфигурации webpack output.filename.

watchOptions.aggregateTimeout

Отложить перестроение после первого изменения. Значение — время в мс.

По умолчанию: 300

watchOptions.poll

true: использовать опрос

число: использовать опрос с указанным интервалом

По умолчанию: undefined

publicPath (обязательно)

Путь, по которому middleware будет привязан к серверу.

В большинстве случаев это соответствует параметру конфигурации webpack output.publicPath.

headers

Добавить пользовательские заголовки. Например, { "X-Custom-Header": "yes" }

stats

Параметры вывода для stats. См. node.js API.

middleware.invalidate()

Вручную аннулировать компиляцию. Полезно, если что-то в компиляторе изменилось.

middleware.fileSystem

Чтение (в памяти) файловой системы, которая может получить доступ к скомпилированным данным.