@stylable/core-test-kit

@stylable/core-test-kit

@stylable/core-test-kit is a collection of utilities aimed at making testing Stylable core behavior and functionality easier.

What's in this test-kit?

Matchers

An assortment of Chai matchers used by Stylable.

• flat-match - flattens and matches passed arguments
• results - test Stylable transpiled style rules output

Diagnostics tooling

A collection of tools aimed at testing Stylable diagnostics messages (warnings and errors).

Testing infrastructure

Used for easily setting up Stylable instances (processor/transformer) and its infrastructure.

Exposes expectTransformOutput utility for creating transformation tests. These are the most common core tests and the recommended way to test the core transform functionality.

Currently only supports testing target selector but when needed the functionality can be expended here to support:

• JavaScript exports output
• Declaration values
• Mixins output

Example

Using the /* @expect selector */ comment to test the root class selector target

expectTransformOutput(
    {
        entry: `/style.st.css`,
        files: {
            '/style.st.css': {
                namespace: 'ns',
                content: `
                /* @expect .ns__root */
                .root {}
            `
        },
    },
    1
);

Match rules

Exposes two utility functions (matchRuleAndDeclaration and matchAllRulesAndDeclarations) used for testing Stylable generated AST representing CSS rules and declarations.

License

Copyright (c) 2019 Wix.com Ltd. All Rights Reserved. Use of this source code is governed by a BSD license.