Configuration file: Reference

'jasmine' | 'mocha' | 'qunit' | 'ava'
Please check: Supported testing frameworks

Testing framework to run your tests with.
Format: 'name@version' | 'name'

Delays to specify how much time wait before proceeding to the next stage of the automated test run workflow.

If Debugging is 'true', produces a detailed wallaby.js log viewable in the Wallaby Console.

If Preserve Comments setting is 'true', preserves comments in the instrumented files that wallaby generates.

If property Report console.error as test run error is 'true', reports your tests as failed, if as a result of a test run some 'console.error' calls were made.

Set Maximum console messages logged per test to increase the limit of console messages logged per test.

Use setting slowTestThreshold to set the time above which the executed test duration is reported as slow.

• 'automatic' makes your current Wallaby session start a test run whenever code is changed in your editor or when code is saved on disk
• 'onsave' starts a test run ONLY when your code is saved to disk.

Please note: you may also need to change your editor settings to not save files automatically in order to use this feature, see Run Mode Setting.

Use setting lowCoverageThreshold to set the value below which the coverage is reported as low.

To change the displayed project name.

To exclude the file from code coverage calculation, and still be able to see its coverage indicators, inline errors and messages, etc., when it is opened.

To change the behaviour when running in node.js environment, wallaby.js reports all unhandled promise rejections as errors, the Unhandled promise rejections setting should be set as 'false'.

To run all tests in the test file every time when one/multiple test(s) of the file are affected by your code changes, the setting should be set as 'true'.

To ignore file loading chains for files dependency tracking purposes, so that wallaby only re-runs tests that are directly using affected files exported functionality, the setting should be set as 'true'.

If the Maximum Log Entry Size setting is 'true', changes the maximum number of characters.

If you are running your tests using Chrome or PhantomJs then you may use an editor command to show a screen shot of the last test that was executed by Wallaby, the setting should be set as 'true'.

The files array property specifies an array of source files or file name patterns.

Exceptions:

• the 'node_modules' folder does not need to be included in the 'files' list.
• if you are using a module bundler for browser tests, such as 'webpack' or 'browserify' you do not need to include folders with your external modules in the files list (unless you would like to load some modules globally as opposed to 'require/import' them).

• if you are using a middleware function for your browser tests and making an embedded web server to some of your local folders with libraries, like 'node_modules', then you do not need to include those folders in the 'files' list.

Please check about an object additional properties details here.

To specify an array of test files or test file name patterns, use the tests array property.

IMPORTANT:

Please check about an object additional properties details here.

The env property to specify a different test runner or change the runner settings. Please see runner settings.

To allow for compilation from anything to JavaScript (ES6 or earlier), wallaby.js supports compilers that run before instrumentation and preprocessors.

Wallaby.js has three built-in compilers: TypeScript, CoffeeScript and Babel.

All files that satisfy 'files' and 'tests' patterns will be tested against the 'compilers' pattern, and those that match will be compiled.

Function middleware to just specify some file(s) or a folder that wallaby.js will serve ‘as is,’ without copying it to its local cache, or instrumenting or processing it.

You may serve anything by specifying 'middleware' function that takes 2 arguments: express application instance and express instance, and allows you to set and use any middleware.

The workers property specifies the degree of parallelism used to run your tests and controls the way wallaby.js re-uses workers.

Use the property Pattern to represent the file name or pattern. Each file is checked against patterns from the top of the list to the bottom.

Use the property Ignore to completely exclude the file from being processed by wallaby.js.

Setting the property Instrument to 'false' stops the file from being compiled, disables file code coverage reporting, and prevents file changes from triggering automatic test execution.

Setting the property Load to 'false' is useful if you are using some alternative script loading mechanism, such as RequireJs or Webpack/Browserify.

NOTE: if your browser tests or code load some files dynamically and you don’t want them to be loaded into your sandbox immediately via script tags, you still need them in your files list, with load: 'false' flag so that wallaby.js can serve them on its embedded web server.

The property Binary tells wallaby whether the file is binary (this affects how the file gets copied to wallaby cache).

To use 'node.js' should be set 'node', to use a browser environment (PhantomJs or Electron) should be set 'browser'

The setting env.options is to pass an object of Electron BrowserWindow options.

The env.runner property should be set to your local node/phantomJs/electron path, or just node/phantomjs (or any other command) that is mapped to your test runner binary. If 'env.type' is set to 'node' but 'env.runner' is not set, wallaby.js will use its own version of node.js or the system default one.

The env.params.runner property to set space-separated spawned runner process flags.

The env.params.env property to set semicolon-separated spawned runner process environment variables.

The env.viewportSize property to set PhantomJs/Electron page viewport size.

The env.report404AsError property allows you to report any 404 server hits as errors to Wallaby Console.

• Use 'logger.debug()' to log any debugging information that will only be reported with 'debug': 'true' setting.
• Use 'logger.trace()' to log any debugging information that will only be reported with 'trace': 'true' setting.
• Use 'logger.error/logger.warn' to report errors.

Return the id of a worker that runs tests.

Use the 'initial' property to specify the number of parallel processes to use to run your tests when your start/restart wallaby.js.

Use the 'regular' property to specify the number of parallel processes to use to run your tests every time your code changes.

• When set to 'true', wallaby.js will restart processes for each run.
• When set to 'false', wallaby.js will forever keep using processes that were started once, relying on your test cleanup code).

To exclude a file from code coverage calculation reported in the Wallaby App use the 'filesWithNoCoverageCalculated' setting.

Use the 'ignoreCoverageForFile' setting to ignore a file for coverage purposes by using comment hints.