Add a server option to get a reference to the dev server when ready

[genemars]

It can be useful in some circumstances to get a reference to the HTTP server in order to be able to programmatically request a client refresh.
Maybe something like:

eleventyConfig.setServerOptions({
    ....
    ready: (ds) => {
        initCustomWatcher(eleventyConfig, ds);
    }
    ....
}

and then somewhere else: ds.sendUpdateNotification(...).

[j-f1]

I would like this functionality because I want to build my website to a PDF using Puppeteer. That only works properly when the website is served by a server (rather than with a file: URL). Previously, here’s what I did:

eleventyConfig.setBrowserSyncConfig({
  snippet: false,
  callbacks: {
    async ready(err, bs) {
      port = bs.server.address().port;
      await (
        await renderPDF
      )(port);
      if (process.env.BAND_BOOK_ONESHOT) {
        // stop the server immediately when running `npm run build`
        process.exit(0);
      }
    },
  },
});

source