Please add more descriptive error message for hostWhitelist property in environment.js

[valk]

Hi I've no idea what that means. I struggled to understand where this hostWhitelist should be defined without success.

My currently dirty environment.js has this:

  var ENV = {
    modulePrefix: 'gitconfig-client',
    environment: environment,
    baseURL: '/',
    locationType: 'auto',
      hostWhitelist: ['localhost'],
    EmberENV: {
      hostWhitelist: ['localhost'],
      FEATURES: {
      hostWhitelist: ['localhost'],
        // Here you can enable experimental features on an ember canary build
        // e.g. 'with-controller': true
      },
      EXTEND_PROTOTYPES: {
      hostWhitelist: ['localhost'],
        Date: false,
      }
    },

    APP: {
      hostWhitelist: ['localhost'],
      // Here you can pass flags/options to your application instance
      // when it is created
    }
  };

And the erro I get when starting FastBoot with:

ember fastboot --port 4200 --host localhost

Is this:

500 Unknown Error: Error: You are using Ember Data with no host defined in your adapter. This will attempt to use the host of the FastBoot request, which is not configured for the current host of this request. Please set the hostWhitelist property for in your environment.js. FastBoot Error: You must provide a hostWhitelist to retrieve the host

[danmcclain]

hostWhitelist is discussed in the User guide here: http://ember-fastboot.com/docs/user-guide
(no link to the proper section, sorry).

[valk]

@danmcclain Ah, thanks! I only read the README 👍

[danmcclain]

The website is the canonical place for usage information, we shifted away from the README, as it would get unwieldy

[danmcclain]

I do believe we can add a link to that error message so we can point users in the correct direction, thanks!

[lupestro]

Will this message also be displayed if there is a whitelist but the host is not on it? Or will there be a different message? If the same message is used for both, providing a more specific message that identifies the host that failed the match would be helpful.

Two small changes to the manual might help with this:

It is very, very easy to put the fastboot:{} in the wrong part of the environment.js. Sounds like the OP was having some confusion about that. In the manual, putting it above the EmberENV: {} and App: {} rather than below them might make it clearer that it has to appear at the let ENV: { ... here ... } level. I had to read it a few times to be sure of that myself.

Also, while ember serve will detect environment.js changes and rebuild the project, I think fastboot may not be picking up its changes under that condition. I had better luck stopping ember serve and restarting it, but I only discovered that by accident after making repeated changes and wondering why I was still getting the error.

[elwayman02]

Any chance of actually updating this error message as @danmcclain suggested? It's 2020 and the error message is still pretty cryptic. :)