<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@csstools/postcss-tape](./postcss-tape.md)

## postcss-tape package

A test suite for PostCSS plugins.

## Example


```sh
node --test
```

```js
// test/_tape.mjs
import { postcssTape } from '@csstools/postcss-tape';
import plugin from '<your plugin package name>';

postcssTape(plugin)({
	basic: {
		message: "supports basic usage",
	},
	'basic:color': {
		message: "supports { color: '<a color>' }",
		options: {
			color: 'purple'
		}
	},
});
```

## Functions

<table><thead><tr><th>

Function


</th><th>

Description


</th></tr></thead>
<tbody><tr><td>

[postcssTape(pluginCreator, runOptions)](./postcss-tape.postcsstape.md)


</td><td>

Create a test suite for a PostCSS plugin.


</td></tr>
</tbody></table>

## Interfaces

<table><thead><tr><th>

Interface


</th><th>

Description


</th></tr></thead>
<tbody><tr><td>

[TestCaseOptions](./postcss-tape.testcaseoptions.md)


</td><td>

Options for a test case.


</td></tr>
</tbody></table>

## Variables

<table><thead><tr><th>

Variable


</th><th>

Description


</th></tr></thead>
<tbody><tr><td>

[atRuleClonerPlugin](./postcss-tape.atruleclonerplugin.md)


</td><td>

A dummy PostCSS plugin that clones any at rule with params `to-clone` to a new at rule with params `cloned`<!-- -->.


</td></tr>
<tr><td>

[declarationClonerPlugin](./postcss-tape.declarationclonerplugin.md)


</td><td>

A dummy PostCSS plugin that clones any declaration with the property `to-clone` to a new declaration with the property `cloned`<!-- -->.


</td></tr>
<tr><td>

[ruleClonerPlugin](./postcss-tape.ruleclonerplugin.md)


</td><td>

A dummy PostCSS plugin that clones any rule with the selector `to-clone` to a new rule with the selector `cloned`<!-- -->.


</td></tr>
</tbody></table>

## Type Aliases

<table><thead><tr><th>

Type Alias


</th><th>

Description


</th></tr></thead>
<tbody><tr><td>

[Options](./postcss-tape.options.md)


</td><td>

General options for `@csstools/postcss-tape`<!-- -->. These affect the entire test run, not individual test cases.


</td></tr>
</tbody></table>

