feat: deprecate setup in favor of before and after hooks (#1108)

fixes #869

Author: mrtnbroder

examples/node-api-middleware/server.js

@@ -9,7 +9,7 @@ const server = new WebpackDevServer(compiler, {
   stats: {
     colors: true
   },
-  setup(app) {
+  before(app) {
     app.use((req, res, next) => {
       console.log(`Using middleware for ${req.url}`);
       next();

lib/Server.js

@@ -321,11 +321,19 @@ function Server(compiler, options) {
       }
     },
 
+    before: () => {
+      if (typeof options.before === 'function') { options.before(app, this); }
+    },
+
     middleware: () => {
       // include our middleware to ensure it is able to handle '/index.html' request after redirect
       app.use(this.middleware);
     },
 
+    after: () => {
+      if (typeof options.after === 'function') { options.after(app, this); }
+    },
+
     headers: () => {
       app.all('*', this.setContentHeaders.bind(this));
     },
@@ -335,11 +343,13 @@ function Server(compiler, options) {
     },
 
     setup: () => {
+      log('Using "setup" is deprecated and will be removed in the next major version. Please use the "before" and "after" hooks instead.');
+      log('If "setup" was working fine for you until now, simply replace it with "before"');
       if (typeof options.setup === 'function') { options.setup(app, this); }
     }
   };
 
-  const defaultFeatures = ['setup', 'headers', 'middleware'];
+  const defaultFeatures = ['before', 'setup', 'headers', 'middleware'];
   if (options.proxy) { defaultFeatures.push('proxy', 'middleware'); }
   if (contentBase !== false) { defaultFeatures.push('contentBaseFiles'); }
   if (options.watchContentBase) { defaultFeatures.push('watchContentBase'); }
@@ -351,6 +361,7 @@ function Server(compiler, options) {
   if (contentBase !== false) { defaultFeatures.push('contentBaseIndex'); }
   // compress is placed last and uses unshift so that it will be the first middleware used
   if (options.compress) { defaultFeatures.unshift('compress'); }
+  if (options.after) { defaultFeatures.push('after'); }
 
   (options.features || defaultFeatures).forEach((feature) => {
     features[feature]();

lib/optionsSchema.json

@@ -274,6 +274,14 @@
       "description": "Exposes the Express server to add custom middleware or routes.",
       "instanceof": "Function"
     },
+    "before": {
+      "description": "Exposes the Express server to add custom middleware or routes before webpack-dev-middleware will be added.",
+      "instanceof": "Function"
+    },
+    "after": {
+      "description": "Exposes the Express server to add custom middleware or routes after webpack-dev-middleware got added.",
+      "instanceof": "Function"
+    },
     "stats": {
       "description": "Decides what bundle information is displayed.",
       "anyOf": [

test/Validation.test.js

@@ -51,7 +51,7 @@ describe('Validation', () => {
       '   object { hot?, hotOnly?, lazy?, bonjour?, host?, allowedHosts?, filename?, publicPath?, port?, socket?, ' +
       'watchOptions?, headers?, clientLogLevel?, overlay?, progress?, key?, cert?, ca?, pfx?, pfxPassphrase?, requestCert?, ' +
       'inline?, disableHostCheck?, public?, https?, contentBase?, watchContentBase?, open?, useLocalIp?, openPage?, features?, ' +
-      'compress?, proxy?, historyApiFallback?, staticOptions?, setup?, stats?, reporter?, ' +
+      'compress?, proxy?, historyApiFallback?, staticOptions?, setup?, before?, after?, stats?, reporter?, ' +
       'noInfo?, quiet?, serverSideRender?, index?, log?, warn? }'
     ]
   }];