modules/mcagar/README.md
mcagar is a tinymce specific wrapping of agar's testing infrastructure. It is only a collection of modules.
mcagar is available as an npm package. You can install it via the npm package @ephox/mcagar
You need to use bun to install the mcagar devDependencies since npm doesn't support package aliasing and that is used in the package.json.
npm install @ephox/mcagar
Only modules inside the api package should be used in other projects. All other modules are implementation detail. There are two types of modules available: BDD and Pipelines.
BDD modules are useful when testing using behavior-driven development testing, such as with Mocha. For information, see the BDD testing documentation.
Pipeline modules are an in-house testing framework that relies on Agar Step and Chains to create a pipeline of actions to perform. The pipeline syntax is, at the time of writing, slowly being removed and will eventually be deprecated. For information, see the Pipeline testing documentation.
The tests can be run using bedrock via bun run test. Note, this will only run the tests on Chrome and will require chromedriver. You can use bedrock directly to test on other browsers. See bedrock for more details.
To run the tests on Chrome:
$ bun run test