> For the complete documentation index, see [llms.txt](https://cubbles.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cubbles.gitbook.io/docs/develop/coder-devtools-cdt/user-guide/generate-art-wct-scaffold.md).

# Generate a test environment for a component

The [CDT](/docs/develop/coder-devtools-cdt.md) offers the `_generateArtifactWctScaffold` task to generate unit tests for your Cubbles components, which is based on [web-component-tester v. 4.2.2](https://www.npmjs.com/package/web-component-tester/v/4.2.2). You can test your cubbles components using [Mocha](https://mochajs.org/) as test framework and [Chai](https://www.chaijs.com/) for assertions.

## Purpose

To show how to generate a test environment for your Cubbles components using the `_generateArtifactWctScaffold` and how to test them.

## Steps

First, you should run the task within the CDT folder (normally it is called *devtools*) as follows:

```bash
grunt _generateArtifactWctScaffold
```

Then, a list of the components of the [current active webpackage](/docs/develop/coder-devtools-cdt/user-guide/change-active-webpackage.md) will be displayed. You should choose the component to be tested typing its index. In the example below, we have chosen to generate a test environment for the second component of the list:

```bash
? Please choose the artifact
  1) elem-one
  2) compound-two
(Move up and down to reveal more choices)
  Answer: 2
```

## Outcome

A folder called *test* will be generated in the folder of the selected component.

![Component test generated folder](https://2317523455-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LFauslHG_3YIQtbtVZG%2F-LOEfli8P0bCatL2Itbg%2F-LOEfmCzubXgJ9-OAk_a%2Fcomponent_test_folder.png?generation=1538935170951113\&alt=media)

The folder will contain the following files:

* **index.html**: the index webpage to run the tests in a browser.
* **\[artifactId]-test.html**: a webpage containing the component to be tested and importing the required scripts.
* **\[artifactId\[-test.js**: script to write the unit tests of your component.
* **grunt-wct-test-config.js**, **mocha-config.js** and **wct.conf.js**: configuration files for the test environment of the component.

After generating the files, you will get a message similar to the one presented below:

```bash
info: finished generation files in: ../../my-first-project/webpackages/my-second-webpackage/compound-two/test
```

## The npm module version

You can use an npm module that serves the same purposes called [cubx-wct-scaffolder](https://www.npmjs.com/package/cubx-wct-scaffolder). The module can be used from the command line or in a node script.

## Further details

To know how to write unit tests for you components check [this tutorial](/docs/develop/coder-devtools-cdt/user-guide/testing-components.md).