feat: implement dev-server watchOptions configuration

Author: Kocal

index.js

@@ -588,6 +588,27 @@ class Encore {
         return this;
     }
 
+    /**
+     * Configure the devServer.watchOptions configuration, only when the dev server is running.
+     *
+     * https://webpack.js.org/configuration/dev-server/#devserver-watchoptions-
+     * https://webpack.js.org/configuration/watch/
+     *
+     * Encore.configureDevServerWatchOptions(function(watchOptions) {
+     *      // change the configuration
+     *
+     *      watchOptions.poll = 250;
+     * });
+     *
+     * @param {function} callback
+     * @returns {Encore}
+     */
+    configureDevServerWatchOptions(callback) {
+        webpackConfig.configureDevServerWatchOptions(callback);
+
+        return this;
+    }
+
     /**
      * Automatically make some variables available everywhere!
      *

lib/WebpackConfig.js

@@ -94,6 +94,7 @@ class WebpackConfig {
         this.shouldUseSingleRuntimeChunk = null;
         this.shouldSplitEntryChunks = false;
         this.splitChunksConfigurationCallback = () => {};
+        this.devServerWatchOptionsConfigurationCallback = () => {};
         this.vueLoaderOptionsCallback = () => {};
         this.eslintLoaderOptionsCallback = () => {};
         this.tsConfigurationCallback = () => {};
@@ -395,6 +396,14 @@ class WebpackConfig {
         this.splitChunksConfigurationCallback = callback;
     }
 
+    configureDevServerWatchOptions(callback) {
+        if (typeof callback !== 'function') {
+            throw new Error('Argument 1 to configureDevServerWatchOptions() must be a callback function.');
+        }
+
+        this.devServerWatchOptionsConfigurationCallback = callback;
+    }
+
     createSharedEntry(name, file) {
         if (this.shouldSplitEntryChunks) {
             throw new Error('Using splitEntryChunks() and createSharedEntry() together is not supported. Use one of these strategies only to optimize your build.');

lib/config-generator.js

@@ -527,6 +527,11 @@ class ConfigGenerator {
 
     buildDevServerConfig() {
         const contentBase = pathUtil.getContentBase(this.webpackConfig);
+        const watchOptions = {
+            ignored: /node_modules/
+        };
+
+        this.webpackConfig.devServerWatchOptionsConfigurationCallback(watchOptions);
 
         return {
             contentBase: contentBase,
@@ -539,9 +544,7 @@ class ConfigGenerator {
             quiet: true,
             compress: true,
             historyApiFallback: true,
-            watchOptions: {
-                ignored: /node_modules/
-            },
+            watchOptions: watchOptions,
             https: this.webpackConfig.useDevServerInHttps()
         };
     }