feat: add Encore.configureDevServerOptions()

Author: Kocal

index.js

@@ -652,6 +652,27 @@ class Encore {
         return this;
     }
 
+    /**
+     * Configure the devServer configuration.
+     *
+     * https://webpack.js.org/configuration/dev-server
+     *
+     * ```
+     * Encore.configureDevServerOptions(function(options) {
+     *     // change the configuration
+     *     options
+     * });
+     * ```
+     *
+     * @param {function} callback
+     * @returns {Encore}
+     */
+    configureDevServerOptions(callback) {
+        webpackConfig.configureDevServerOptions(callback);
+
+        return this;
+    }
+
     /**
      * Automatically make some variables available everywhere!
      *

lib/WebpackConfig.js

@@ -144,6 +144,7 @@ class WebpackConfig {
         this.cssLoaderConfigurationCallback = () => {};
         this.splitChunksConfigurationCallback = () => {};
         this.watchOptionsConfigurationCallback = () => {};
+        this.devServerOptionsConfigurationCallback = () => {};
         this.vueLoaderOptionsCallback = () => {};
         this.eslintLoaderOptionsCallback = () => {};
         this.tsConfigurationCallback = () => {};
@@ -499,6 +500,14 @@ class WebpackConfig {
         this.watchOptionsConfigurationCallback = callback;
     }
 
+    configureDevServerOptions(callback) {
+        if (typeof callback !== 'function') {
+            throw new Error('Argument 1 to configureDevServerOptions() must be a callback function.');
+        }
+
+        this.devServerOptionsConfigurationCallback = 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

@@ -613,7 +613,7 @@ class ConfigGenerator {
     buildDevServerConfig() {
         const contentBase = pathUtil.getContentBase(this.webpackConfig);
 
-        return {
+        const devServerOptions = {
             contentBase: contentBase,
             // this doesn't appear to be necessary, but here in case
             publicPath: this.webpackConfig.getRealPublicPath(),
@@ -627,6 +627,11 @@ class ConfigGenerator {
             watchOptions: this.buildWatchOptionsConfig(),
             https: this.webpackConfig.useDevServerInHttps()
         };
+
+        return applyOptionsCallback(
+            this.webpackConfig.devServerOptionsConfigurationCallback,
+            devServerOptions
+        );
     }
 }