migration-v6.md

Migration guide

This document serves as a migration guide for webpack-dev-server@6.0.0.

⚠ Breaking Changes

• Minimum supported Node.js version is 20.9.0.

• Support for SockJS in the WebSocket transport has been removed. Now, only native WebSocket is supported, or custom client and server implementations can be used.

• The options for passing to the proxy have changed. Please refer to the http-proxy-middleware migration guide for details.

• Remove support for the spdy server type. Use the http2 server type instead; however, since Express does not work correctly with it, a custom server (e.g., Connect or Hono) should be used.

  v4:

  module.exports = {
    // ...
    devServer: {
      server: "spdy",
    },
  };

  v5:

  const connect = require("connect");
  
  module.exports = {
    // ...
    devServer: {
      server: {
        server: "http2",
        app: () => connect(),
      },
    },
  };

Deprecations

• The static methods internalIP and internalIPSync were removed. Use findIp instead.

  v4:

  const ip = Server.internalIP("v4");

  v5:

  const ip = Server.findIp("v4", true);

• The following CLI options were deprecated and have now been removed. Please use the recommended alternatives:

  • http2 -> server
  • https -> server
  • https-ca -> server.options.ca
  • https-ca-reset -> server.options.ca
  • https-cacert -> server.options.ca
  • https-cert -> server.options.cert
  • https-cert-reset -> server.options.cert
  • https-crl -> server.options.crl
  • https-crl-reset -> server.options.crl
  • https-key -> server.options.key
  • https-key-reset -> server.options.key
  • https-passphrase -> server.options.passphrase
  • https-pfx -> server.options.pfx
  • https-pfx-reset -> server.options.pfx
  • https-request-cert -> server.options.requestCert
  • open-app -> --open-app-name
  • server-options-cacert -> server.options.ca
  • server-options-cacert-reset -> server.options.ca
  • web-socket-server -> web-socket-server-type