frontend/config/webpack.config.js

751 lines
32 KiB
JavaScript
Raw Normal View History

2023-07-06 09:34:24 +08:00
const fs = require("fs")
const path = require("path")
const webpack = require("webpack")
const resolve = require("resolve")
const PnpWebpackPlugin = require("pnp-webpack-plugin")
const HtmlWebpackPlugin = require("html-webpack-plugin")
const CaseSensitivePathsPlugin = require("case-sensitive-paths-webpack-plugin")
const InlineChunkHtmlPlugin = require("react-dev-utils/InlineChunkHtmlPlugin")
const TerserPlugin = require("terser-webpack-plugin")
const MiniCssExtractPlugin = require("mini-css-extract-plugin")
const OptimizeCSSAssetsPlugin = require("optimize-css-assets-webpack-plugin")
const safePostCssParser = require("postcss-safe-parser")
const ManifestPlugin = require("webpack-manifest-plugin")
const InterpolateHtmlPlugin = require("react-dev-utils/InterpolateHtmlPlugin")
const WorkboxWebpackPlugin = require("workbox-webpack-plugin")
const WatchMissingNodeModulesPlugin = require("react-dev-utils/WatchMissingNodeModulesPlugin")
const ModuleScopePlugin = require("react-dev-utils/ModuleScopePlugin")
const getCSSModuleLocalIdent = require("react-dev-utils/getCSSModuleLocalIdent")
const ESLintPlugin = require("eslint-webpack-plugin")
const paths = require("./paths")
const modules = require("./modules")
const getClientEnvironment = require("./env")
const ModuleNotFoundPlugin = require("react-dev-utils/ModuleNotFoundPlugin")
const ForkTsCheckerWebpackPlugin = require("react-dev-utils/ForkTsCheckerWebpackPlugin")
const typescriptFormatter = require("react-dev-utils/typescriptFormatter")
const ReactRefreshWebpackPlugin = require("@pmmmwh/react-refresh-webpack-plugin")
2021-10-26 16:08:21 +08:00
2023-07-06 09:34:24 +08:00
const postcssNormalize = require("postcss-normalize")
2021-10-26 16:08:21 +08:00
2023-07-06 09:34:24 +08:00
const appPackageJson = require(paths.appPackageJson)
2021-10-26 16:08:21 +08:00
// Source maps are resource heavy and can cause out of memory issue for large source files.
2021-12-03 16:06:59 +08:00
// const shouldUseSourceMap = process.env.GENERATE_SOURCEMAP !== 'false';
2023-07-06 09:34:24 +08:00
const shouldUseSourceMap = false
const webpackDevClientEntry = require.resolve("react-dev-utils/webpackHotDevClient")
const reactRefreshOverlayEntry = require.resolve("react-dev-utils/refreshOverlayInterop")
2021-10-26 16:08:21 +08:00
// Some apps do not need the benefits of saving a web request, so not inlining the chunk
// makes for a smoother build process.
2023-07-06 09:34:24 +08:00
const shouldInlineRuntimeChunk = process.env.INLINE_RUNTIME_CHUNK !== "false"
2021-10-26 16:08:21 +08:00
2023-07-06 09:34:24 +08:00
const emitErrorsAsWarnings = process.env.ESLINT_NO_DEV_ERRORS === "true"
const disableESLintPlugin = process.env.DISABLE_ESLINT_PLUGIN === "true"
2021-10-26 16:08:21 +08:00
2023-07-06 09:34:24 +08:00
const imageInlineSizeLimit = parseInt(process.env.IMAGE_INLINE_SIZE_LIMIT || "10000")
2021-10-26 16:08:21 +08:00
// Check if TypeScript is setup
2023-07-06 09:34:24 +08:00
const useTypeScript = fs.existsSync(paths.appTsConfig)
2021-10-26 16:08:21 +08:00
// Get the path to the uncompiled service worker (if it exists).
2023-07-06 09:34:24 +08:00
const swSrc = paths.swSrc
2021-10-26 16:08:21 +08:00
// style files regexes
2023-07-06 09:34:24 +08:00
const cssRegex = /\.css$/
const cssModuleRegex = /\.module\.css$/
const sassRegex = /\.(scss|sass)$/
const sassModuleRegex = /\.module\.(scss|sass)$/
2021-10-26 16:08:21 +08:00
//配置less
2023-07-06 09:34:24 +08:00
const lessRegex = /\.less$/
const lessModuleRegex = /\.module\.less$/
2021-12-02 10:36:10 +08:00
2021-10-26 16:08:21 +08:00
const hasJsxRuntime = (() => {
2023-07-06 09:34:24 +08:00
if (process.env.DISABLE_NEW_JSX_TRANSFORM === "true") {
return false
2021-10-26 16:08:21 +08:00
}
try {
2023-07-06 09:34:24 +08:00
require.resolve("react/jsx-runtime")
return true
2021-10-26 16:08:21 +08:00
} catch (e) {
2023-07-06 09:34:24 +08:00
return false
2021-10-26 16:08:21 +08:00
}
2023-07-06 09:34:24 +08:00
})()
2021-10-26 16:08:21 +08:00
// This is the production and development configuration.
// It is focused on developer experience, fast rebuilds, and a minimal bundle.
module.exports = function (webpackEnv) {
2023-07-06 09:34:24 +08:00
const isEnvDevelopment = webpackEnv === "development"
const isEnvProduction = webpackEnv === "production"
2021-10-26 16:08:21 +08:00
// Variable used for enabling profiling in Production
// passed into alias object. Uses a flag if passed into the build command
2023-07-06 09:34:24 +08:00
const isEnvProductionProfile = isEnvProduction && process.argv.includes("--profile")
2021-10-26 16:08:21 +08:00
// We will provide `paths.publicUrlOrPath` to our app
// as %PUBLIC_URL% in `index.html` and `process.env.PUBLIC_URL` in JavaScript.
// Omit trailing slash as %PUBLIC_URL%/xyz looks better than %PUBLIC_URL%xyz.
// Get environment variables to inject into our app.
2023-07-06 09:34:24 +08:00
const env = getClientEnvironment(paths.publicUrlOrPath.slice(0, -1))
2021-10-26 16:08:21 +08:00
2023-07-06 09:34:24 +08:00
const shouldUseReactRefresh = env.raw.FAST_REFRESH
2021-10-26 16:08:21 +08:00
// common function to get style loaders
const getStyleLoaders = (cssOptions, preProcessor) => {
const loaders = [
2023-07-06 09:34:24 +08:00
isEnvDevelopment && require.resolve("style-loader"),
2021-10-26 16:08:21 +08:00
isEnvProduction && {
loader: MiniCssExtractPlugin.loader,
// css is located in `static/css`, use '../../' to locate index.html folder
// in production `paths.publicUrlOrPath` can be a relative path
2023-07-06 09:34:24 +08:00
options: paths.publicUrlOrPath.startsWith(".") ? { publicPath: "../../" } : {}
2021-10-26 16:08:21 +08:00
},
{
2023-07-06 09:34:24 +08:00
loader: require.resolve("css-loader"),
2022-06-06 14:52:52 +08:00
options: cssOptions
},
{
2023-07-06 09:34:24 +08:00
loader: require.resolve("less-loader")
2021-10-26 16:08:21 +08:00
},
{
// Options for PostCSS as we reference these options twice
// Adds vendor prefixing based on your specified browser support in
// package.json
2023-07-06 09:34:24 +08:00
loader: require.resolve("postcss-loader"),
2021-10-26 16:08:21 +08:00
options: {
// Necessary for external CSS imports to work
// https://github.com/facebook/create-react-app/issues/2677
2023-07-06 09:34:24 +08:00
ident: "postcss",
2021-10-26 16:08:21 +08:00
plugins: () => [
2023-07-06 09:34:24 +08:00
require("postcss-flexbugs-fixes"),
require("postcss-preset-env")({
2021-10-26 16:08:21 +08:00
autoprefixer: {
2023-07-06 09:34:24 +08:00
flexbox: "no-2009"
2021-10-26 16:08:21 +08:00
},
2022-06-06 14:52:52 +08:00
stage: 3
2021-10-26 16:08:21 +08:00
}),
// Adds PostCSS Normalize as the reset css with default options,
// so that it honors browserslist config in package.json
// which in turn let's users customize the target behavior as per their needs.
2022-06-06 14:52:52 +08:00
postcssNormalize()
2021-10-26 16:08:21 +08:00
],
2022-06-06 14:52:52 +08:00
sourceMap: isEnvProduction ? shouldUseSourceMap : isEnvDevelopment
}
}
2023-07-06 09:34:24 +08:00
].filter(Boolean)
2021-10-26 16:08:21 +08:00
if (preProcessor) {
loaders.push(
{
2023-07-06 09:34:24 +08:00
loader: require.resolve("resolve-url-loader"),
2021-10-26 16:08:21 +08:00
options: {
sourceMap: isEnvProduction ? shouldUseSourceMap : isEnvDevelopment,
2022-06-06 14:52:52 +08:00
root: paths.appSrc
}
2021-10-26 16:08:21 +08:00
},
{
loader: require.resolve(preProcessor),
options: {
2022-06-06 14:52:52 +08:00
sourceMap: true
}
2021-10-26 16:08:21 +08:00
}
2023-07-06 09:34:24 +08:00
)
2021-10-26 16:08:21 +08:00
}
2023-07-06 09:34:24 +08:00
return loaders
}
2021-10-26 16:08:21 +08:00
return {
2023-07-06 09:34:24 +08:00
mode: isEnvProduction ? "production" : isEnvDevelopment && "development",
2021-10-26 16:08:21 +08:00
// Stop compilation early in production
bail: isEnvProduction,
devtool: isEnvProduction
? shouldUseSourceMap
2023-07-06 09:34:24 +08:00
? "source-map"
2021-10-26 16:08:21 +08:00
: false
2023-07-06 09:34:24 +08:00
: isEnvDevelopment && "cheap-module-source-map",
2021-10-26 16:08:21 +08:00
// These are the "entry points" to our application.
// This means they will be the "root" imports that are included in JS bundle.
entry:
isEnvDevelopment && !shouldUseReactRefresh
? [
// Include an alternative client for WebpackDevServer. A client's job is to
// connect to WebpackDevServer by a socket and get notified about changes.
// When you save a file, the client will either apply hot updates (in case
// of CSS changes), or refresh the page (in case of JS changes). When you
// make a syntax error, this client will display a syntax error overlay.
// Note: instead of the default WebpackDevServer client, we use a custom one
// to bring better experience for Create React App users. You can replace
// the line below with these two lines if you prefer the stock client:
//
// require.resolve('webpack-dev-server/client') + '?/',
// require.resolve('webpack/hot/dev-server'),
//
// When using the experimental react-refresh integration,
// the webpack plugin takes care of injecting the dev client for us.
webpackDevClientEntry,
// Finally, this is your app's code:
2022-06-06 14:52:52 +08:00
paths.appIndexJs
2021-10-26 16:08:21 +08:00
// We include the app code last so that if there is a runtime error during
// initialization, it doesn't blow up the WebpackDevServer client, and
// changing JS code would still trigger a refresh.
]
: paths.appIndexJs,
output: {
// The build folder.
path: isEnvProduction ? paths.appBuild : undefined,
// Add /* filename */ comments to generated require()s in the output.
pathinfo: isEnvDevelopment,
// There will be one main bundle, and one file per asynchronous chunk.
// In development, it does not produce real files.
filename: isEnvProduction
2023-07-06 09:34:24 +08:00
? "static/js/[name].[contenthash:8].js"
: isEnvDevelopment && "static/js/bundle.js",
2021-10-26 16:08:21 +08:00
// TODO: remove this when upgrading to webpack 5
futureEmitAssets: true,
// There are also additional JS chunk files if you use code splitting.
chunkFilename: isEnvProduction
2023-07-06 09:34:24 +08:00
? "static/js/[name].[contenthash:8].chunk.js"
: isEnvDevelopment && "static/js/[name].chunk.js",
2021-10-26 16:08:21 +08:00
// webpack uses `publicPath` to determine where the app is being served from.
// It requires a trailing slash, or the file assets will get an incorrect path.
// We inferred the "public path" (such as / or /my-project) from homepage.
publicPath: paths.publicUrlOrPath,
// Point sourcemap entries to original disk location (format as URL on Windows)
devtoolModuleFilenameTemplate: isEnvProduction
2023-07-06 09:34:24 +08:00
? (info) => path.relative(paths.appSrc, info.absoluteResourcePath).replace(/\\/g, "/")
2021-10-26 16:08:21 +08:00
: isEnvDevelopment &&
2023-07-06 09:34:24 +08:00
((info) => path.resolve(info.absoluteResourcePath).replace(/\\/g, "/")),
2021-10-26 16:08:21 +08:00
// Prevents conflicts when multiple webpack runtimes (from different apps)
// are used on the same page.
jsonpFunction: `webpackJsonp${appPackageJson.name}`,
// this defaults to 'window', but by setting it to 'this' then
// module chunks which are built will work in web workers as well.
2023-07-06 09:34:24 +08:00
globalObject: "this"
2021-10-26 16:08:21 +08:00
},
2022-06-06 14:52:52 +08:00
2021-10-26 16:08:21 +08:00
optimization: {
minimize: isEnvProduction,
minimizer: [
// This is only used in production mode
new TerserPlugin({
terserOptions: {
parse: {
// We want terser to parse ecma 8 code. However, we don't want it
// to apply any minification steps that turns valid ecma 5 code
// into invalid ecma 5 code. This is why the 'compress' and 'output'
// sections only apply transformations that are ecma 5 safe
// https://github.com/facebook/create-react-app/pull/4234
2022-06-06 14:52:52 +08:00
ecma: 8
2021-10-26 16:08:21 +08:00
},
compress: {
ecma: 5,
warnings: false,
// Disabled because of an issue with Uglify breaking seemingly valid code:
// https://github.com/facebook/create-react-app/issues/2376
// Pending further investigation:
// https://github.com/mishoo/UglifyJS2/issues/2011
comparisons: false,
// Disabled because of an issue with Terser breaking valid code:
// https://github.com/facebook/create-react-app/issues/5250
// Pending further investigation:
// https://github.com/terser-js/terser/issues/120
2022-07-20 11:25:16 +08:00
inline: 2,
drop_console: true,
drop_debugger: true
2021-10-26 16:08:21 +08:00
},
mangle: {
2022-06-06 14:52:52 +08:00
safari10: true
2021-10-26 16:08:21 +08:00
},
// Added for profiling in devtools
keep_classnames: isEnvProductionProfile,
keep_fnames: isEnvProductionProfile,
output: {
ecma: 5,
comments: false,
// Turned on because emoji and regex is not minified properly using default
// https://github.com/facebook/create-react-app/issues/2488
2022-06-06 14:52:52 +08:00
ascii_only: true
}
2021-10-26 16:08:21 +08:00
},
2022-06-06 14:52:52 +08:00
sourceMap: shouldUseSourceMap
2021-10-26 16:08:21 +08:00
}),
// This is only used in production mode
new OptimizeCSSAssetsPlugin({
cssProcessorOptions: {
parser: safePostCssParser,
map: shouldUseSourceMap
? {
// `inline: false` forces the sourcemap to be output into a
// separate file
inline: false,
// `annotation: true` appends the sourceMappingURL to the end of
// the css file, helping the browser find the sourcemap
2022-06-06 14:52:52 +08:00
annotation: true
2021-10-26 16:08:21 +08:00
}
2022-06-06 14:52:52 +08:00
: false
2021-10-26 16:08:21 +08:00
},
cssProcessorPluginOptions: {
2023-07-06 09:34:24 +08:00
preset: ["default", { minifyFontValues: { removeQuotes: false } }]
2022-06-06 14:52:52 +08:00
}
})
2021-10-26 16:08:21 +08:00
],
// Automatically split vendor and commons
// https://twitter.com/wSokra/status/969633336732905474
// https://medium.com/webpack/webpack-4-code-splitting-chunk-graph-and-the-splitchunks-optimization-be739a861366
splitChunks: {
2023-07-06 09:34:24 +08:00
chunks: "all",
2022-06-06 14:52:52 +08:00
name: isEnvDevelopment
2021-10-26 16:08:21 +08:00
},
// Keep the runtime chunk separated to enable long term caching
// https://twitter.com/wSokra/status/969679223278505985
// https://github.com/facebook/create-react-app/issues/5358
runtimeChunk: {
2022-06-06 14:52:52 +08:00
name: (entrypoint) => `runtime-${entrypoint.name}`
}
2021-10-26 16:08:21 +08:00
},
resolve: {
// This allows you to set a fallback for where webpack should look for modules.
// We placed these paths second because we want `node_modules` to "win"
// if there are any conflicts. This matches Node resolution mechanism.
// https://github.com/facebook/create-react-app/issues/253
2023-07-06 09:34:24 +08:00
modules: ["node_modules", paths.appNodeModules].concat(modules.additionalModulePaths || []),
2021-10-26 16:08:21 +08:00
// These are the reasonable defaults supported by the Node ecosystem.
// We also include JSX as a common component filename extension to support
// some tools, although we do not recommend using it, see:
// https://github.com/facebook/create-react-app/issues/290
// `web` extension prefixes have been added for better support
// for React Native Web.
extensions: paths.moduleFileExtensions
2022-06-06 14:52:52 +08:00
.map((ext) => `.${ext}`)
2023-07-06 09:34:24 +08:00
.filter((ext) => useTypeScript || !ext.includes("ts")),
2021-10-26 16:08:21 +08:00
alias: {
// Support React Native Web
// https://www.smashingmagazine.com/2016/08/a-glimpse-into-the-future-with-react-native-for-web/
2023-07-06 09:34:24 +08:00
"react-native": "react-native-web",
2021-10-26 16:08:21 +08:00
// Allows for better profiling with ReactDevTools
...(isEnvProductionProfile && {
2023-07-06 09:34:24 +08:00
"react-dom$": "react-dom/profiling",
"scheduler/tracing": "scheduler/tracing-profiling"
2021-10-26 16:08:21 +08:00
}),
...(modules.webpackAliases || {}),
2023-07-06 09:34:24 +08:00
"@": path.resolve(__dirname, "../src")
2021-10-26 16:08:21 +08:00
},
plugins: [
// Adds support for installing with Plug'n'Play, leading to faster installs and adding
// guards against forgotten dependencies and such.
PnpWebpackPlugin,
// Prevents users from importing files from outside of src/ (or node_modules/).
// This often causes confusion because we only process files within src/ with babel.
// To fix this, we prevent you from importing files out of src/ -- if you'd like to,
// please link the files into your node_modules/ and let module-resolution kick in.
// Make sure your source files are compiled, as they will not be processed in any way.
2023-07-06 09:34:24 +08:00
new ModuleScopePlugin(paths.appSrc, [paths.appPackageJson, reactRefreshOverlayEntry])
2022-06-06 14:52:52 +08:00
]
2021-10-26 16:08:21 +08:00
},
resolveLoader: {
plugins: [
// Also related to Plug'n'Play, but this time it tells webpack to load its loaders
// from the current package.
2022-06-06 14:52:52 +08:00
PnpWebpackPlugin.moduleLoader(module)
]
2021-10-26 16:08:21 +08:00
},
module: {
strictExportPresence: true,
rules: [
// Disable require.ensure as it's not a standard language feature.
{ parser: { requireEnsure: false } },
{
// "oneOf" will traverse all following loaders until one will
// match the requirements. When no loader matches it will fall
// back to the "file" loader at the end of the loader list.
oneOf: [
// TODO: Merge this config once `image/avif` is in the mime-db
// https://github.com/jshttp/mime-db
{
test: [/\.avif$/],
2023-07-06 09:34:24 +08:00
loader: require.resolve("url-loader"),
2021-10-26 16:08:21 +08:00
options: {
limit: imageInlineSizeLimit,
2023-07-06 09:34:24 +08:00
mimetype: "image/avif",
name: "static/media/[name].[hash:8].[ext]"
2022-06-06 14:52:52 +08:00
}
2021-10-26 16:08:21 +08:00
},
// "url" loader works like "file" loader except that it embeds assets
// smaller than specified limit in bytes as data URLs to avoid requests.
// A missing `test` is equivalent to a match.
{
test: [/\.bmp$/, /\.gif$/, /\.jpe?g$/, /\.png$/],
2023-07-06 09:34:24 +08:00
loader: require.resolve("url-loader"),
2021-10-26 16:08:21 +08:00
options: {
limit: imageInlineSizeLimit,
2023-07-06 09:34:24 +08:00
name: "static/media/[name].[hash:8].[ext]"
2022-06-06 14:52:52 +08:00
}
2021-10-26 16:08:21 +08:00
},
// Process application JS with Babel.
// The preset includes JSX, Flow, TypeScript, and some ESnext features.
{
test: /\.(js|mjs|jsx|ts|tsx)$/,
include: paths.appSrc,
2023-07-06 09:34:24 +08:00
loader: require.resolve("babel-loader"),
2021-10-26 16:08:21 +08:00
options: {
2023-07-06 09:34:24 +08:00
customize: require.resolve("babel-preset-react-app/webpack-overrides"),
2021-10-26 16:08:21 +08:00
presets: [
[
2023-07-06 09:34:24 +08:00
require.resolve("babel-preset-react-app"),
2021-10-26 16:08:21 +08:00
{
2023-07-06 09:34:24 +08:00
runtime: hasJsxRuntime ? "automatic" : "classic"
2022-06-06 14:52:52 +08:00
}
]
2021-10-26 16:08:21 +08:00
],
plugins: [
[
2023-07-06 09:34:24 +08:00
require.resolve("babel-plugin-named-asset-import"),
2021-10-26 16:08:21 +08:00
{
loaderMap: {
svg: {
2023-07-06 09:34:24 +08:00
ReactComponent: "@svgr/webpack?-svgo,+titleProp,+ref![path]"
2022-06-06 14:52:52 +08:00
}
}
}
2021-10-26 16:08:21 +08:00
],
isEnvDevelopment &&
shouldUseReactRefresh &&
2023-07-06 09:34:24 +08:00
require.resolve("react-refresh/babel")
2021-10-26 16:08:21 +08:00
].filter(Boolean),
// This is a feature of `babel-loader` for webpack (not Babel itself).
// It enables caching results in ./node_modules/.cache/babel-loader/
// directory for faster rebuilds.
cacheDirectory: true,
// See #6846 for context on why cacheCompression is disabled
cacheCompression: false,
2022-06-06 14:52:52 +08:00
compact: isEnvProduction
}
2021-10-26 16:08:21 +08:00
},
// Process any JS outside of the app with Babel.
// Unlike the application JS, we only compile the standard ES features.
{
test: /\.(js|mjs)$/,
exclude: /@babel(?:\/|\\{1,2})runtime/,
2023-07-06 09:34:24 +08:00
loader: require.resolve("babel-loader"),
2021-10-26 16:08:21 +08:00
options: {
babelrc: false,
configFile: false,
compact: false,
presets: [
2023-07-06 09:34:24 +08:00
[require.resolve("babel-preset-react-app/dependencies"), { helpers: true }]
2021-10-26 16:08:21 +08:00
],
cacheDirectory: true,
// See #6846 for context on why cacheCompression is disabled
cacheCompression: false,
2022-06-06 14:52:52 +08:00
2021-10-26 16:08:21 +08:00
// Babel sourcemaps are needed for debugging into node_modules
// code. Without the options below, debuggers like VSCode
// show incorrect code and set breakpoints on the wrong lines.
sourceMaps: shouldUseSourceMap,
2022-06-06 14:52:52 +08:00
inputSourceMap: shouldUseSourceMap
}
2021-10-26 16:08:21 +08:00
},
// "postcss" loader applies autoprefixer to our CSS.
// "css" loader resolves paths in CSS and adds assets as dependencies.
// "style" loader turns CSS into JS modules that inject <style> tags.
// In production, we use MiniCSSExtractPlugin to extract that CSS
// to a file, but in development "style" loader enables hot editing
// of CSS.
// By default we support CSS Modules with the extension .module.css
{
test: cssRegex,
exclude: cssModuleRegex,
use: getStyleLoaders({
importLoaders: 1,
2023-07-06 09:34:24 +08:00
sourceMap: isEnvProduction ? shouldUseSourceMap : isEnvDevelopment
2021-10-26 16:08:21 +08:00
}),
// Don't consider CSS imports dead code even if the
// containing package claims to have no side effects.
// Remove this when webpack adds a warning or an error for this.
// See https://github.com/webpack/webpack/issues/6571
2022-06-06 14:52:52 +08:00
sideEffects: true
2021-10-26 16:08:21 +08:00
},
// Adds support for CSS Modules (https://github.com/css-modules/css-modules)
// using the extension .module.css
{
test: cssModuleRegex,
use: getStyleLoaders({
importLoaders: 1,
2023-07-06 09:34:24 +08:00
sourceMap: isEnvProduction ? shouldUseSourceMap : isEnvDevelopment,
2021-10-26 16:08:21 +08:00
modules: {
2022-06-06 14:52:52 +08:00
getLocalIdent: getCSSModuleLocalIdent
}
})
2021-10-26 16:08:21 +08:00
},
2022-06-06 14:52:52 +08:00
2021-10-26 16:08:21 +08:00
// Opt-in support for SASS (using .scss or .sass extensions).
// By default we support SASS Modules with the
// extensions .module.scss or .module.sass
{
test: sassRegex,
exclude: sassModuleRegex,
use: getStyleLoaders(
{
importLoaders: 3,
2023-07-06 09:34:24 +08:00
sourceMap: isEnvProduction ? shouldUseSourceMap : isEnvDevelopment
2021-10-26 16:08:21 +08:00
},
2023-07-06 09:34:24 +08:00
"sass-loader"
2021-10-26 16:08:21 +08:00
),
// Don't consider CSS imports dead code even if the
// containing package claims to have no side effects.
// Remove this when webpack adds a warning or an error for this.
// See https://github.com/webpack/webpack/issues/6571
2022-06-06 14:52:52 +08:00
sideEffects: true
2021-10-26 16:08:21 +08:00
},
// Adds support for CSS Modules, but using SASS
// using the extension .module.scss or .module.sass
{
test: sassModuleRegex,
use: getStyleLoaders(
{
importLoaders: 3,
2023-07-06 09:34:24 +08:00
sourceMap: isEnvProduction ? shouldUseSourceMap : isEnvDevelopment,
2021-10-26 16:08:21 +08:00
modules: {
2022-06-06 14:52:52 +08:00
getLocalIdent: getCSSModuleLocalIdent
}
2021-10-26 16:08:21 +08:00
},
2023-07-06 09:34:24 +08:00
"sass-loader"
2022-06-06 14:52:52 +08:00
)
},
{
test: lessRegex,
exclude: lessModuleRegex,
use: getStyleLoaders(
{
importLoaders: 3,
sourceMap: isEnvProduction && shouldUseSourceMap
},
2023-07-06 09:34:24 +08:00
"less-loader"
2021-10-26 16:08:21 +08:00
),
2022-06-06 14:52:52 +08:00
sideEffects: true
},
{
test: lessModuleRegex,
use: getStyleLoaders(
{
importLoaders: 3,
sourceMap: isEnvProduction && shouldUseSourceMap,
modules: {
getLocalIdent: getCSSModuleLocalIdent
}
},
2023-07-06 09:34:24 +08:00
"less-loader"
2022-06-06 14:52:52 +08:00
)
2021-10-26 16:08:21 +08:00
},
// "file" loader makes sure those assets get served by WebpackDevServer.
// When you `import` an asset, you get its (virtual) filename.
// In production, they would get copied to the `build` folder.
// This loader doesn't use a "test" so it will catch all modules
// that fall through the other loaders.
{
2023-07-06 09:34:24 +08:00
loader: require.resolve("file-loader"),
2021-10-26 16:08:21 +08:00
// Exclude `js` files to keep "css" loader working as it injects
// its runtime that would otherwise be processed through "file" loader.
// Also exclude `html` and `json` extensions so they get processed
// by webpacks internal loaders.
exclude: [/\.(js|mjs|jsx|ts|tsx)$/, /\.html$/, /\.json$/],
options: {
2023-07-06 09:34:24 +08:00
name: "static/media/[name].[hash:8].[ext]"
2022-06-06 14:52:52 +08:00
}
}
2021-10-26 16:08:21 +08:00
// ** STOP ** Are you adding a new loader?
// Make sure to add the new loader(s) before the "file" loader.
2022-06-06 14:52:52 +08:00
]
}
]
2021-10-26 16:08:21 +08:00
},
plugins: [
// Generates an `index.html` file with the <script> injected.
new HtmlWebpackPlugin(
Object.assign(
{},
{
inject: true,
2022-06-06 14:52:52 +08:00
template: paths.appHtml
2021-10-26 16:08:21 +08:00
},
isEnvProduction
? {
minify: {
removeComments: true,
collapseWhitespace: true,
removeRedundantAttributes: true,
useShortDoctype: true,
removeEmptyAttributes: true,
removeStyleLinkTypeAttributes: true,
keepClosingSlash: true,
minifyJS: true,
minifyCSS: true,
2022-06-06 14:52:52 +08:00
minifyURLs: true
}
2021-10-26 16:08:21 +08:00
}
: undefined
)
),
// Inlines the webpack runtime script. This script is too small to warrant
// a network request.
// https://github.com/facebook/create-react-app/issues/5358
isEnvProduction &&
shouldInlineRuntimeChunk &&
new InlineChunkHtmlPlugin(HtmlWebpackPlugin, [/runtime-.+[.]js/]),
// Makes some environment variables available in index.html.
// The public URL is available as %PUBLIC_URL% in index.html, e.g.:
// <link rel="icon" href="%PUBLIC_URL%/favicon.ico">
// It will be an empty string unless you specify "homepage"
// in `package.json`, in which case it will be the pathname of that URL.
new InterpolateHtmlPlugin(HtmlWebpackPlugin, env.raw),
// This gives some necessary context to module not found errors, such as
// the requesting resource.
new ModuleNotFoundPlugin(paths.appPath),
// Makes some environment variables available to the JS code, for example:
// if (process.env.NODE_ENV === 'production') { ... }. See `./env.js`.
// It is absolutely essential that NODE_ENV is set to production
// during a production build.
// Otherwise React will be compiled in the very slow development mode.
new webpack.DefinePlugin(env.stringified),
// This is necessary to emit hot updates (CSS and Fast Refresh):
isEnvDevelopment && new webpack.HotModuleReplacementPlugin(),
// Experimental hot reloading for React .
// https://github.com/facebook/react/tree/master/packages/react-refresh
isEnvDevelopment &&
shouldUseReactRefresh &&
new ReactRefreshWebpackPlugin({
overlay: {
entry: webpackDevClientEntry,
// The expected exports are slightly different from what the overlay exports,
// so an interop is included here to enable feedback on module-level errors.
module: reactRefreshOverlayEntry,
// Since we ship a custom dev client and overlay integration,
// the bundled socket handling logic can be eliminated.
2022-06-06 14:52:52 +08:00
sockIntegration: false
}
2021-10-26 16:08:21 +08:00
}),
// Watcher doesn't work well if you mistype casing in a path so we use
// a plugin that prints an error when you attempt to do this.
// See https://github.com/facebook/create-react-app/issues/240
isEnvDevelopment && new CaseSensitivePathsPlugin(),
// If you require a missing module and then `npm install` it, you still have
// to restart the development server for webpack to discover it. This plugin
// makes the discovery automatic so you don't have to restart.
// See https://github.com/facebook/create-react-app/issues/186
2023-07-06 09:34:24 +08:00
isEnvDevelopment && new WatchMissingNodeModulesPlugin(paths.appNodeModules),
2021-10-26 16:08:21 +08:00
isEnvProduction &&
new MiniCssExtractPlugin({
// Options similar to the same options in webpackOptions.output
// both options are optional
2023-07-06 09:34:24 +08:00
filename: "static/css/[name].[contenthash:8].css",
chunkFilename: "static/css/[name].[contenthash:8].chunk.css"
2021-10-26 16:08:21 +08:00
}),
// Generate an asset manifest file with the following content:
// - "files" key: Mapping of all asset filenames to their corresponding
// output file so that tools can pick it up without having to parse
// `index.html`
// - "entrypoints" key: Array of files which are included in `index.html`,
// can be used to reconstruct the HTML if necessary
new ManifestPlugin({
2023-07-06 09:34:24 +08:00
fileName: "asset-manifest.json",
2021-10-26 16:08:21 +08:00
publicPath: paths.publicUrlOrPath,
generate: (seed, files, entrypoints) => {
const manifestFiles = files.reduce((manifest, file) => {
2023-07-06 09:34:24 +08:00
manifest[file.name] = file.path
return manifest
}, seed)
const entrypointFiles = entrypoints.main.filter((fileName) => !fileName.endsWith(".map"))
2021-10-26 16:08:21 +08:00
return {
files: manifestFiles,
2022-06-06 14:52:52 +08:00
entrypoints: entrypointFiles
2023-07-06 09:34:24 +08:00
}
2022-06-06 14:52:52 +08:00
}
2021-10-26 16:08:21 +08:00
}),
// Moment.js is an extremely popular library that bundles large locale files
// by default due to how webpack interprets its code. This is a practical
// solution that requires the user to opt into importing specific locales.
// https://github.com/jmblog/how-to-optimize-momentjs-with-webpack
// You can remove this if you don't use Moment.js:
new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/),
// Generate a service worker script that will precache, and keep up to date,
// the HTML & assets that are part of the webpack build.
isEnvProduction &&
fs.existsSync(swSrc) &&
new WorkboxWebpackPlugin.InjectManifest({
swSrc,
dontCacheBustURLsMatching: /\.[0-9a-f]{8}\./,
exclude: [/\.map$/, /asset-manifest\.json$/, /LICENSE/],
// Bump up the default maximum size (2mb) that's precached,
// to make lazy-loading failure scenarios less likely.
// See https://github.com/cra-template/pwa/issues/13#issuecomment-722667270
2022-06-06 14:52:52 +08:00
maximumFileSizeToCacheInBytes: 5 * 1024 * 1024
2021-10-26 16:08:21 +08:00
}),
// TypeScript type checking
useTypeScript &&
new ForkTsCheckerWebpackPlugin({
2023-07-06 09:34:24 +08:00
typescript: resolve.sync("typescript", {
2022-06-06 14:52:52 +08:00
basedir: paths.appNodeModules
2021-10-26 16:08:21 +08:00
}),
async: isEnvDevelopment,
checkSyntacticErrors: true,
2023-07-06 09:34:24 +08:00
resolveModuleNameModule: process.versions.pnp ? `${__dirname}/pnpTs.js` : undefined,
2021-10-26 16:08:21 +08:00
resolveTypeReferenceDirectiveModule: process.versions.pnp
? `${__dirname}/pnpTs.js`
: undefined,
tsconfig: paths.appTsConfig,
reportFiles: [
// This one is specifically to match during CI tests,
// as micromatch doesn't match
// '../cra-template-typescript/template/src/App.tsx'
// otherwise.
2023-07-06 09:34:24 +08:00
"../**/src/**/*.{ts,tsx}",
"**/src/**/*.{ts,tsx}",
"!**/src/**/__tests__/**",
"!**/src/**/?(*.)(spec|test).*",
"!**/src/setupProxy.*",
"!**/src/setupTests.*"
2021-10-26 16:08:21 +08:00
],
silent: true,
// The formatter is invoked directly in WebpackDevServerUtils during development
2022-06-06 14:52:52 +08:00
formatter: isEnvProduction ? typescriptFormatter : undefined
2021-10-26 16:08:21 +08:00
}),
!disableESLintPlugin &&
new ESLintPlugin({
// Plugin options
2023-07-06 09:34:24 +08:00
extensions: ["js", "mjs", "jsx", "ts", "tsx"],
formatter: require.resolve("react-dev-utils/eslintFormatter"),
eslintPath: require.resolve("eslint"),
2021-10-26 16:08:21 +08:00
failOnError: !(isEnvDevelopment && emitErrorsAsWarnings),
context: paths.appSrc,
cache: true,
2023-07-06 09:34:24 +08:00
cacheLocation: path.resolve(paths.appNodeModules, ".cache/.eslintcache"),
2021-10-26 16:08:21 +08:00
// ESLint class options
cwd: paths.appPath,
resolvePluginsRelativeTo: __dirname,
baseConfig: {
2023-07-06 09:34:24 +08:00
extends: [require.resolve("eslint-config-react-app/base")],
2021-10-26 16:08:21 +08:00
rules: {
...(!hasJsxRuntime && {
2023-07-06 09:34:24 +08:00
"react/react-in-jsx-scope": "error"
2022-06-06 14:52:52 +08:00
})
}
}
})
2021-10-26 16:08:21 +08:00
].filter(Boolean),
// Some libraries import Node modules but don't use them in the browser.
// Tell webpack to provide empty mocks for them so importing them works.
node: {
2023-07-06 09:34:24 +08:00
module: "empty",
dgram: "empty",
dns: "mock",
fs: "empty",
http2: "empty",
net: "empty",
tls: "empty",
child_process: "empty"
2021-10-26 16:08:21 +08:00
},
// Turn off performance processing because we utilize
// our own hints via the FileSizeReporter
2022-06-06 14:52:52 +08:00
performance: false
2023-07-06 09:34:24 +08:00
}
}