Языки конфигурации

Webpack принимает файлы конфигурации, написанные на нескольких языках программирования и данных. Список поддерживаемых расширений файлов можно найти в пакете node-interpret. Используя node-interpret, webpack может обрабатывать многие разные типы файлов конфигурации.

TypeScript

Чтобы написать конфигурацию webpack на TypeScript, вы сначала должны установить необходимые зависимости, т.е. TypeScript и соответствующие определения типов из проекта DefinitelyTyped:

npm install --save-dev typescript ts-node @types/node @types/webpack
# and, if using webpack-dev-server < v4.7.0
npm install --save-dev @types/webpack-dev-server

и затем приступить к написанию своей конфигурации:

webpack.config.ts

import path from 'path';
import webpack from 'webpack';
// in case you run into any typescript error when configuring `devServer`
import 'webpack-dev-server';

const config: webpack.Configuration = {
  mode: 'production',
  entry: './foo.js',
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: 'foo.bundle.js',
  },
};

export default config;

tsconfig.json

{
  "compilerOptions": {
    "allowSyntheticDefaultImports": true,
    "esModuleInterop": true
  }
}

В приведенном выше примере предполагается, что используется версия TypeScript >= 2.7 или более поздняя с новыми esModuleInterop и allowSyntheticDefaultImports параметрами компилятора в вашем файле tsconfig.json.

Обратите внимание, что вам также необходимо проверить ваш файл tsconfig.json. Если module в compilerOptions в tsconfig.json имеет значение commonjs, настройка завершена, в противном случае webpack завершится ошибкой. Это происходит потому, что ts-node не поддерживает никакой синтаксис модулей, кроме commonjs.

Есть три решения этой проблемы:

• Изменить tsconfig.json.
• Изменить tsconfig.json и добавить настройки для ts-node.
• Установить пакет tsconfig-paths.

Первое решение — открыть ваш файл tsconfig.json и найти compilerOptions. Установите target в "ES5" и module в "CommonJS" (или полностью удалите параметр module).

Второе решение — добавить настройки для ts-node:

Вы можете сохранить "module": "ESNext" для tsc, и если вы используете webpack или другой инструмент сборки, установите переопределение для ts-node. ts-node конфигурация

{
  "compilerOptions": {
    "module": "ESNext",
  },
  "ts-node": {
    "compilerOptions": {
      "module": "CommonJS"
    }
  }
}

Третье решение — установить пакет tsconfig-paths.

npm install --save-dev tsconfig-paths

И создать отдельную конфигурацию TypeScript специально для ваших конфигураций webpack:

tsconfig-for-webpack-config.json

{
  "compilerOptions": {
    "module": "commonjs",
    "target": "es5",
    "esModuleInterop": true
  }
}

Затем установите переменную окружения process.env.TS_NODE_PROJECT, предоставленную tsconfig-paths, следующим образом:

package.json

{
  "scripts": {
    "build": "cross-env TS_NODE_PROJECT=\"tsconfig-for-webpack-config.json\" webpack"
  }
}

CoffeeScript

Аналогично, чтобы использовать CoffeeScript, вы сначала должны установить необходимые зависимости:

npm install --save-dev coffeescript

и затем приступить к написанию своей конфигурации:

webpack.config.coffee

HtmlWebpackPlugin = require('html-webpack-plugin')
webpack = require('webpack')
path = require('path')

config =
  mode: 'production'
  entry: './path/to/my/entry/file.js'
  output:
    path: path.resolve(__dirname, 'dist')
    filename: 'my-first-webpack.bundle.js'
  module: rules: [ {
    test: /\.(js|jsx)$/
    use: 'babel-loader'
  } ]
  plugins: [
    new HtmlWebpackPlugin(template: './src/index.html')
  ]

module.exports = config

Babel и JSX

В примере ниже используются JSX (React JavaScript Markup) и Babel для создания конфигурации JSON, которую webpack может понять.

С любезного разрешения Jason Miller

Сначала установите необходимые зависимости:

npm install --save-dev babel-register jsxobj babel-preset-es2015

.babelrc

{
  "presets": ["es2015"]
}

webpack.config.babel.js

import jsxobj from 'jsxobj';

// example of an imported plugin
const CustomPlugin = (config) => ({
  ...config,
  name: 'custom-plugin',
});

export default (
  <webpack target="web" watch mode="production">
    <entry path="src/index.js" />
    <resolve>
      <alias
        {...{
          react: 'preact-compat',
          'react-dom': 'preact-compat',
        }}
      />
    </resolve>
    <plugins>
      <CustomPlugin foo="bar" />
    </plugins>
  </webpack>
);