Options

Methods

This chapter describes all available configuration properties and options. There are multiple methods for defining configuration and options.

When the same option is defined using multiple methods, the priority is (from lower to higher):

• Defining options programmatically
• Using configuration file
• Using command line arguments

Main options

These options can be defined using command line arguments, the configuration file, and can be changed while the server is running using the settings methods.

• path (String): Path to the folder containing mocks and routes to be used by the server. Default is /mocks
• port (Number): Port number for Mocks Server to be listening at. Default is 3100.
• host (String): Host for the server. Default is 0.0.0.0 (Listen to any local host).
• log (String): Logs level. Can be one of silly, debug, verbose, info, warn or error.
• watch (String): Watch mocks folder and restart server on changes. Default is true. Use false to disable it.
• mock (String): Mock to use when the server is started.
• delay (Number): Responses delay time in milliseconds.

Plugins extra options

Each plugin can add its own options when it is installed. These options can also be defined and changed using the same methods as the main options.

• cli (String): Start interactive CLI. Default is true. Use false to disable it.
• adminApiPath (String): Path for the administration REST API. Default is /admin. You should change it only in case there is any conflict with the api you are mocking.

note

These extra options are added by the @mocks-server/plugin-admin-api and the @mocks-server/plugin-inquirer-cli plugins, which are both included in the Mocks Server main distribution.

For another plugins options, please refer to their own documentation.

Low level configuration

This options can't be modified while the server is running, and can be defined only using the configuration file or programmatically.

• plugins (Array of Plugin): Array of Plugins, defined as described in the plugins chapter.
• addPlugins (Array of Plugin): Array of Plugins to be added. This option does not overwrite previously defined plugins.
• addRoutesHandlers (Array of RouteHandler): Array of RouteHandler to be added. This option does not overwrite previously defined plugins.
• configFile (String): Custom path for the configuration file. If relative, it will be resolved from current working directory. Default is mocks.config.js.
• onlyProgrammaticOptions (Boolean): If true, it disables both command line arguments and configuration file.
• disableCommandLineArguments (Boolean) If true, all command line arguments defining options will be ignored.
• disableConfigFile (Boolean): If true, the configuration file will be ignored.