https://github.com/symfony/stimulus-testing

Testing-library integration for Symfony UX
https://github.com/symfony/stimulus-testing

javascript symfony

Last synced: about 1 month ago
JSON representation

Testing-library integration for Symfony UX

• Host: GitHub
• URL: https://github.com/symfony/stimulus-testing
• Owner: symfony
• Created: 2020-11-30T09:52:52.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-10-03T16:03:52.000Z (about 1 year ago)
• Last Synced: 2024-09-30T17:20:57.381Z (about 1 month ago)
• Topics: javascript, symfony
• Language: JavaScript
• Homepage: https://symfony.com/ux
• Size: 16.6 KB
• Stars: 23
• Watchers: 8
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Symfony UX Stimulus testing

Symfony UX Stimulus testing is a low-level package to help write tests for Stimulus controllers

in applications and reusable packages.

Symfony UX Stimulus testing is currently considered **experimental**.

## Installation

```sh

yarn add @symfony/stimulus-testing

```

## Usage

Symfony UX Stimulus testing ships several tools to help write tests for Stimulus controllers:

* it uses [Jest](https://jestjs.io/) as test runner ;

* it relies internally on [jsdom](https://github.com/jsdom/jsdom) and mutationobserver-shim to emulate a DOM

  implementation and allow to execute Stimulus controllers in the console ; 

* it provides an integration of [Testing Library](https://testing-library.com/) ;

* it provides helper functions to ease Stimulus tests development in Symfony projects and bundles ;

To start using Symfony UX Testing, you first need to configure a testing environment:

1. Create a `assets/test` directory ;

2. Create a `assets/test/setup.js` file to initialize Symfony UX Testing:   

```js

import '@symfony/stimulus-testing/setup';

```

3. Create a `assets/jest.config.js` file for Jest configuration:

 

```js

module.exports = {

    'testRegex': 'test/.*\\.test.js',

    'setupFilesAfterEnv': ['./test/setup.js']

};

```

4. Create a `assets/.babelrc` file for Babel configuration (you may need to install Babel, 

`@babel/plugin-proposal-class-properties` and `@babel/preset-env` if you haven't already):

```json

{

    "presets": ["@babel/preset-env"],

    "plugins": ["@babel/plugin-proposal-class-properties"]

}

```

5. Finally, create your first test, for instance `hello_controller.test.js`:

```js

import { Application } from '@hotwired/stimulus';

import { clearDOM, mountDOM } from '@symfony/stimulus-testing';

import HelloController from '../controllers/hello_controller.js';

const startStimulus = () => {

    const application = Application.start();

    application.register('hello', HelloController);

};

describe('HelloController', () => {

    let container;

    beforeEach(() => {

        container = mountDOM('
');

    });


    afterEach(() => {

        clearDOM();

    });

    it('connect', async () => {

        startStimulus();

        // Write a test here ...

    });

    // You can create other tests here

});

```