webpack-dev-server 3.11.3 → 4.0.0-beta.3

package/lib/options.json

@@ -1,117 +1,264 @@
 {
   "type": "object",
-  "properties": {
-    "after": {
-      "instanceof": "Function"
-    },
-    "allowedHosts": {
-      "type": "array",
-      "items": {
-        "type": "string"
+  "definitions": {
+    "StaticObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "directory": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Directory for static contents."
+        },
+        "staticOptions": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "publicPath": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "The bundled files will be available in the browser under this path."
+        },
+        "serveIndex": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "additionalProperties": true
+            }
+          ],
+          "description": "Tells dev-server to use serveIndex middleware when enabled."
+        },
+        "watch": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "description": "options for watch, description available at https://github.com/paulmillr/chokidar#api"
+            }
+          ],
+          "description": "Watch for files in static content directory."
+        }
       }
     },
-    "before": {
-      "instanceof": "Function"
+    "StaticString": {
+      "type": "string",
+      "minLength": 1
     },
-    "bonjour": {
+    "OpenBoolean": {
       "type": "boolean"
     },
-    "ca": {
-      "anyOf": [
-        {
-          "type": "string"
+    "OpenString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "OpenObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "target": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Open specified route in browser."
         },
-        {
-          "instanceof": "Buffer"
+        "app": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1
+            }
+          ],
+          "description": "Open specified browser."
         }
-      ]
+      }
     },
-    "cert": {
-      "anyOf": [
-        {
-          "type": "string"
+    "WatchFilesString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "WatchFilesObject": {
+      "type": "object",
+      "properties": {
+        "paths": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          ]
         },
-        {
-          "instanceof": "Buffer"
+        "options": {
+          "type": "object",
+          "additionalProperties": true
         }
-      ]
-    },
-    "clientLogLevel": {
-      "enum": [
-        "info",
-        "warn",
-        "error",
-        "debug",
-        "trace",
-        "silent",
-        "none",
-        "warning"
-      ]
-    },
-    "compress": {
-      "type": "boolean"
-    },
-    "contentBasePublicPath": {
+      },
+      "additionalProperties": false
+    }
+  },
+  "properties": {
+    "bonjour": {
       "anyOf": [
         {
-          "type": "string"
+          "type": "boolean"
         },
         {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "minItems": 1
+          "type": "object"
         }
-      ]
-    },
-    "contentBase": {
-      "anyOf": [
-        {
-          "enum": [false]
+      ],
+      "description": "Broadcasts the server via ZeroConf networking on start. https://webpack.js.org/configuration/dev-server/#devserverbonjour"
+    },
+    "client": {
+      "type": "object",
+      "properties": {
+        "host": {
+          "type": "string",
+          "description": "Tells clients connected to devServer to use the provided host."
         },
-        {
-          "type": "number"
+        "path": {
+          "type": "string",
+          "description": "Tells clients connected to devServer to use the provided port."
         },
-        {
-          "type": "string"
+        "port": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Tells clients connected to devServer to use the provided path to connect."
         },
-        {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "minItems": 1
+        "logging": {
+          "enum": ["none", "error", "warn", "info", "log", "verbose"],
+          "decription": "Log level in the browser."
+        },
+        "progress": {
+          "type": "boolean",
+          "description": "Print compilation progress in percentage in the browser."
+        },
+        "overlay": {
+          "anyOf": [
+            {
+              "type": "boolean",
+              "description": "Show a full-screen overlay in the browser when there are compiler errors or warnings."
+            },
+            {
+              "type": "object",
+              "properties": {
+                "errors": {
+                  "type": "boolean",
+                  "description": "Show a full-screen overlay in the browser when there are compiler errors."
+                },
+                "warnings": {
+                  "type": "boolean",
+                  "description": "Show a full-screen overlay in the browser when there are compiler warnings."
+                }
+              }
+            }
+          ]
+        },
+        "needClientEntry": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "instanceof": "Function"
+            }
+          ],
+          "description": "Tells devServer to inject a client entry."
+        },
+        "needHotEntry": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "instanceof": "Function"
+            }
+          ],
+          "description": "Tells devServer to inject a Hot Module Replacement entry."
         }
-      ]
+      },
+      "description": "Specifies client properties. https://webpack.js.org/configuration/dev-server/#devserverclient",
+      "additionalProperties": false
     },
-    "disableHostCheck": {
-      "type": "boolean"
+    "compress": {
+      "type": "boolean",
+      "description": "Enable gzip compression for everything served. https://webpack.js.org/configuration/dev-server/#devservercompress"
     },
-    "features": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
+    "devMiddleware": {
+      "type": "object",
+      "description": "Provide options to webpack-dev-middleware which handles webpack assets. https://webpack.js.org/configuration/dev-server/#devserverdevmiddleware"
     },
-    "filename": {
+    "firewall": {
       "anyOf": [
         {
-          "type": "string"
-        },
-        {
-          "instanceof": "RegExp"
+          "type": "boolean"
         },
         {
-          "instanceof": "Function"
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
         }
-      ]
-    },
-    "fs": {
-      "type": "object"
+      ],
+      "description": "Defines routes which are enabled by default, on by default and allows localhost. https://webpack.js.org/configuration/dev-server/#devserverfirewall"
     },
     "headers": {
-      "type": "object"
+      "type": "object",
+      "description": "Adds headers to all responses. https://webpack.js.org/configuration/dev-server/#devserverheaders"
     },
     "historyApiFallback": {
       "anyOf": [
@@ -121,7 +268,8 @@
         {
           "type": "object"
         }
-      ]
+      ],
+      "description": "When using the HTML5 History API, the index.html page will likely have to be served in place of any 404 responses. https://webpack.js.org/configuration/dev-server/#devserverhistoryapifallback"
     },
     "host": {
       "anyOf": [
@@ -131,144 +279,133 @@
         {
           "type": "null"
         }
-      ]
+      ],
+      "description": "Specify a host to use. If you want your server to be accessible externally. https://webpack.js.org/configuration/dev-server/#devserverhost"
     },
     "hot": {
-      "type": "boolean"
-    },
-    "hotOnly": {
-      "type": "boolean"
-    },
-    "http2": {
-      "type": "boolean"
-    },
-    "https": {
-      "anyOf": [
-        {
-          "type": "object"
-        },
-        {
-          "type": "boolean"
-        }
-      ]
-    },
-    "index": {
-      "type": "string"
-    },
-    "injectClient": {
       "anyOf": [
         {
           "type": "boolean"
         },
         {
-          "instanceof": "Function"
+          "enum": ["only"]
         }
-      ]
+      ],
+      "description": "Enable webpack's Hot Module Replacement feature. https://webpack.js.org/configuration/dev-server/#devserverhot"
     },
-    "injectHot": {
-      "anyOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "instanceof": "Function"
-        }
-      ]
-    },
-    "inline": {
-      "type": "boolean"
+    "http2": {
+      "type": "boolean",
+      "description": "Serve over HTTP/2 using spdy. https://webpack.js.org/configuration/dev-server/#devserverhttp2"
     },
-    "key": {
+    "https": {
       "anyOf": [
         {
-          "type": "string"
+          "type": "boolean"
         },
         {
-          "instanceof": "Buffer"
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "passphrase": {
+              "type": "string",
+              "description": "Passphrase for a pfx file."
+            },
+            "requestCert": {
+              "type": "boolean",
+              "description": "Request for an SSL certificate."
+            },
+            "cacert": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "instanceof": "Buffer"
+                }
+              ],
+              "description": "Path to an SSL CA certificate."
+            },
+            "key": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "instanceof": "Buffer"
+                }
+              ],
+              "description": "Path to an SSL key."
+            },
+            "pfx": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "instanceof": "Buffer"
+                }
+              ],
+              "description": "Path to an SSL pfx file."
+            },
+            "cert": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "instanceof": "Buffer"
+                }
+              ],
+              "description": "Path to an SSL certificate."
+            }
+          }
         }
-      ]
-    },
-    "lazy": {
-      "type": "boolean"
+      ],
+      "description": "By default, dev-server will be served over HTTP. It can optionally be served over HTTP/2 with HTTPS. https://webpack.js.org/configuration/dev-server/#devserverhttps"
     },
     "liveReload": {
-      "type": "boolean"
-    },
-    "log": {
-      "instanceof": "Function"
-    },
-    "logLevel": {
-      "enum": ["info", "warn", "error", "debug", "trace", "silent"]
+      "type": "boolean",
+      "description": "By default, the dev-server will reload/refresh the page when file changes are detected. https://webpack.js.org/configuration/dev-server/#devserverlivereload"
     },
-    "logTime": {
-      "type": "boolean"
-    },
-    "mimeTypes": {
-      "type": "object"
+    "onAfterSetupMiddleware": {
+      "instanceof": "Function",
+      "description": "Provides the ability to execute custom middleware after all other middleware internally within the server. https://webpack.js.org/configuration/dev-server/#devserverafter"
     },
-    "noInfo": {
-      "type": "boolean"
+    "onBeforeSetupMiddleware": {
+      "instanceof": "Function",
+      "description": "Provides the ability to execute custom middleware prior to all other middleware internally within the server. https://webpack.js.org/configuration/dev-server/#devserverbefore"
     },
     "onListening": {
-      "instanceof": "Function"
+      "instanceof": "Function",
+      "description": "Provides an option to execute a custom function when webpack-dev-server starts listening for connections on a port. https://webpack.js.org/configuration/dev-server/#onlistening"
     },
     "open": {
       "anyOf": [
         {
-          "type": "string"
+          "$ref": "#/definitions/OpenBoolean"
         },
         {
-          "type": "boolean"
+          "$ref": "#/definitions/OpenString"
         },
         {
-          "type": "object"
-        }
-      ]
-    },
-    "openPage": {
-      "anyOf": [
-        {
-          "type": "string"
+          "$ref": "#/definitions/OpenObject"
         },
         {
           "type": "array",
           "items": {
-            "type": "string"
+            "anyOf": [
+              {
+                "$ref": "#/definitions/OpenString"
+              },
+              {
+                "$ref": "#/definitions/OpenObject"
+              }
+            ]
           },
           "minItems": 1
         }
-      ]
-    },
-    "overlay": {
-      "anyOf": [
-        {
-          "type": "boolean"
-        },
-        {
-          "type": "object",
-          "properties": {
-            "errors": {
-              "type": "boolean"
-            },
-            "warnings": {
-              "type": "boolean"
-            }
-          }
-        }
-      ]
-    },
-    "pfx": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "instanceof": "Buffer"
-        }
-      ]
-    },
-    "pfxPassphrase": {
-      "type": "string"
+      ],
+      "description": "Tells dev-server to open the browser after server had been started. Set it to true to open your default browser. https://webpack.js.org/configuration/dev-server/#devserveropen"
     },
     "port": {
       "anyOf": [
@@ -281,13 +418,8 @@
         {
           "type": "null"
         }
-      ]
-    },
-    "profile": {
-      "type": "boolean"
-    },
-    "progress": {
-      "type": "boolean"
+      ],
+      "description": "Specify a port number to listen for requests on. https://webpack.js.org/configuration/dev-server/#devserverport"
     },
     "proxy": {
       "anyOf": [
@@ -308,76 +440,44 @@
           },
           "minItems": 1
         }
-      ]
+      ],
+      "description": "Proxying some URLs can be useful when you have a separate API backend development server and you want to send API requests on the same domain. https://webpack.js.org/configuration/dev-server/#devserverproxy"
     },
     "public": {
-      "type": "string"
-    },
-    "publicPath": {
-      "type": "string"
-    },
-    "quiet": {
-      "type": "boolean"
-    },
-    "reporter": {
-      "instanceof": "Function"
-    },
-    "requestCert": {
-      "type": "boolean"
-    },
-    "serveIndex": {
-      "type": "boolean"
-    },
-    "serverSideRender": {
-      "type": "boolean"
-    },
-    "setup": {
-      "instanceof": "Function"
-    },
-    "sockHost": {
-      "type": "string"
+      "type": "string",
+      "description": "When using dev server and you're proxying dev-server, the client script does not always know where to connect to. It will try to guess the URL of the server based on window.location, but if that fails you'll need to use this. https://webpack.js.org/configuration/dev-server/#devserverpublic"
     },
-    "sockPath": {
-      "type": "string"
+    "setupExitSignals": {
+      "type": "boolean",
+      "description": "It takes a boolean and if true (default on CLI), the server will close and exit the process on SIGINT and SIGTERM. https://webpack.js.org/configuration/dev-server/#devserversetupexitsignals"
     },
-    "sockPort": {
+    "static": {
       "anyOf": [
         {
-          "type": "number"
+          "type": "boolean"
         },
         {
-          "type": "string"
+          "$ref": "#/definitions/StaticString"
         },
         {
-          "type": "null"
-        }
-      ]
-    },
-    "socket": {
-      "type": "string"
-    },
-    "staticOptions": {
-      "type": "object"
-    },
-    "stats": {
-      "anyOf": [
-        {
-          "type": "object"
+          "$ref": "#/definitions/StaticObject"
         },
         {
-          "type": "boolean"
-        },
-        {
-          "enum": [
-            "none",
-            "errors-only",
-            "errors-warnings",
-            "minimal",
-            "normal",
-            "verbose"
-          ]
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "#/definitions/StaticString"
+              },
+              {
+                "$ref": "#/definitions/StaticObject"
+              }
+            ]
+          },
+          "minItems": 1
         }
-      ]
+      ],
+      "description": "It is possible to configure advanced options for serving static files from directory. See the Express documentation for the possible options. https://webpack.js.org/configuration/dev-server/#devserverstatic"
     },
     "transportMode": {
       "anyOf": [
@@ -403,96 +503,32 @@
         {
           "enum": ["sockjs", "ws"]
         }
-      ]
+      ],
+      "description": "This option allows us either to choose the current devServer transport mode for client/server individually or to provide custom client/server implementation. https://webpack.js.org/configuration/dev-server/#devservertransportmode"
     },
-    "useLocalIp": {
-      "type": "boolean"
-    },
-    "warn": {
-      "instanceof": "Function"
-    },
-    "watchContentBase": {
-      "type": "boolean"
-    },
-    "watchOptions": {
-      "type": "object"
-    },
-    "writeToDisk": {
+    "watchFiles": {
       "anyOf": [
         {
-          "type": "boolean"
+          "$ref": "#/definitions/WatchFilesString"
+        },
+        {
+          "$ref": "#/definitions/WatchFilesObject"
         },
         {
-          "instanceof": "Function"
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "$ref": "#/definitions/WatchFilesString"
+              },
+              {
+                "$ref": "#/definitions/WatchFilesObject"
+              }
+            ]
+          }
         }
-      ]
-    }
-  },
-  "errorMessage": {
-    "properties": {
-      "after": "should be {Function} (https://webpack.js.org/configuration/dev-server/#devserverafter)",
-      "allowedHosts": "should be {Array} (https://webpack.js.org/configuration/dev-server/#devserverallowedhosts)",
-      "before": "should be {Function} (https://webpack.js.org/configuration/dev-server/#devserverbefore)",
-      "bonjour": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverbonjour)",
-      "ca": "should be {String|Buffer}",
-      "cert": "should be {String|Buffer}",
-      "clientLogLevel": "should be {String} and equal to one of the allowed values\n\n [ 'none', 'silent', 'info', 'debug', 'trace', 'error', 'warning', 'warn' ]\n\n (https://webpack.js.org/configuration/dev-server/#devserverclientloglevel)",
-      "compress": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devservercompress)",
-      "contentBase": "should be {Number|String|Array} (https://webpack.js.org/configuration/dev-server/#devservercontentbase)",
-      "disableHostCheck": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck)",
-      "features": "should be {Array}",
-      "filename": "should be {String|RegExp|Function} (https://webpack.js.org/configuration/dev-server/#devserverfilename-)",
-      "fs": "should be {Object} (https://github.com/webpack/webpack-dev-middleware#fs)",
-      "headers": "should be {Object} (https://webpack.js.org/configuration/dev-server/#devserverheaders-)",
-      "historyApiFallback": "should be {Boolean|Object} (https://webpack.js.org/configuration/dev-server/#devserverhistoryapifallback)",
-      "host": "should be {String|Null} (https://webpack.js.org/configuration/dev-server/#devserverhost)",
-      "hot": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverhot)",
-      "hotOnly": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverhotonly)",
-      "http2": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverhttp2)",
-      "https": "should be {Object|Boolean} (https://webpack.js.org/configuration/dev-server/#devserverhttps)",
-      "index": "should be {String} (https://webpack.js.org/configuration/dev-server/#devserverindex)",
-      "injectClient": "should be {Boolean|Function} (https://webpack.js.org/configuration/dev-server/#devserverinjectclient)",
-      "injectHot": "should be {Boolean|Function} (https://webpack.js.org/configuration/dev-server/#devserverinjecthot)",
-      "inline": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverinline)",
-      "key": "should be {String|Buffer}",
-      "lazy": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverlazy-)",
-      "liveReload": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverlivereload-)",
-      "log": "should be {Function}",
-      "logLevel": "should be {String} and equal to one of the allowed values\n\n [ 'info', 'warn', 'error', 'debug', 'trace', 'silent' ]\n\n (https://github.com/webpack/webpack-dev-middleware#loglevel)",
-      "logTime": "should be {Boolean} (https://github.com/webpack/webpack-dev-middleware#logtime)",
-      "mimeTypes": "should be {Object} (https://webpack.js.org/configuration/dev-server/#devservermimetypes-)",
-      "noInfo": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devservernoinfo-)",
-      "onListening": "should be {Function} (https://webpack.js.org/configuration/dev-server/#onlistening)",
-      "open": "should be {String|Boolean|Object} (https://webpack.js.org/configuration/dev-server/#devserveropen)",
-      "openPage": "should be {String|Array} (https://webpack.js.org/configuration/dev-server/#devserveropenpage)",
-      "overlay": "should be {Boolean|Object} (https://webpack.js.org/configuration/dev-server/#devserveroverlay)",
-      "pfx": "should be {String|Buffer} (https://webpack.js.org/configuration/dev-server/#devserverpfx)",
-      "pfxPassphrase": "should be {String} (https://webpack.js.org/configuration/dev-server/#devserverpfxpassphrase)",
-      "port": "should be {Number|String|Null} (https://webpack.js.org/configuration/dev-server/#devserverport)",
-      "profile": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverprofile)",
-      "progress": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverprogress---cli-only)",
-      "proxy": "should be {Object|Array} (https://webpack.js.org/configuration/dev-server/#devserverproxy)",
-      "public": "should be {String} (https://webpack.js.org/configuration/dev-server/#devserverpublic)",
-      "publicPath": "should be {String} (https://webpack.js.org/configuration/dev-server/#devserverpublicpath-)",
-      "quiet": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverquiet-)",
-      "reporter": "should be {Function} (https://github.com/webpack/webpack-dev-middleware#reporter)",
-      "requestCert": "should be {Boolean}",
-      "contentBasePublicPath": "should be {String|Array} (https://webpack.js.org/configuration/dev-server/#devservercontentbasepublicpath)",
-      "serveIndex": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverserveindex)",
-      "serverSideRender": "should be {Boolean} (https://github.com/webpack/webpack-dev-middleware#serversiderender)",
-      "setup": "should be {Function} (https://webpack.js.org/configuration/dev-server/#devserversetup)",
-      "sockHost": "should be {String|Null} (https://webpack.js.org/configuration/dev-server/#devserversockhost)",
-      "sockPath": "should be {String} (https://webpack.js.org/configuration/dev-server/#devserversockpath)",
-      "sockPort": "should be {Number|String|Null} (https://webpack.js.org/configuration/dev-server/#devserversockport)",
-      "socket": "should be {String} (https://webpack.js.org/configuration/dev-server/#devserversocket)",
-      "staticOptions": "should be {Object} (https://webpack.js.org/configuration/dev-server/#devserverstaticoptions)",
-      "stats": "should be {Object|Boolean} (https://webpack.js.org/configuration/dev-server/#devserverstats-)",
-      "transportMode": "should be {String|Object} (https://webpack.js.org/configuration/dev-server/#devservertransportmode)",
-      "useLocalIp": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserveruselocalip)",
-      "warn": "should be {Function}",
-      "watchContentBase": "should be {Boolean} (https://webpack.js.org/configuration/dev-server/#devserverwatchcontentbase)",
-      "watchOptions": "should be {Object} (https://webpack.js.org/configuration/dev-server/#devserverwatchoptions-)",
-      "writeToDisk": "should be {Boolean|Function} (https://webpack.js.org/configuration/dev-server/#devserverwritetodisk-)"
+      ],
+      "description": "List of files to watch for file changes and serve. https://webpack.js.org/configuration/dev-server/#devserverwatchfiles"
     }
   },
   "additionalProperties": false