Skip to content

testing-library/svelte-testing-library

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Svelte Testing Library

chipmunk

Simple and complete Svelte testing utilities that encourage good testing practices.

Read The Docs | Edit the docs

Build Status Code Coverage version downloads MIT License

All Contributors PRs Welcome Code of Conduct Discord

Watch on GitHub Star on GitHub Tweet


Table of Contents

The Problem

You want to write maintainable tests for your Svelte components.

This Solution

@testing-library/svelte is a lightweight library for testing Svelte components. It provides functions on top of svelte and @testing-library/dom so you can mount Svelte components and query their rendered output in the DOM. Its primary guiding principle is:

The more your tests resemble the way your software is used, the more confidence they can give you.

Installation

This module is distributed via npm which is bundled with node and should be installed as one of your project's devDependencies:

npm install --save-dev @testing-library/svelte

This library supports svelte versions 3, 4, and 5.

You may also be interested in installing @testing-library/jest-dom so you can use the custom jest matchers.

Setup

We recommend using @testing-library/svelte with Vitest as your test runner. To get started, add the svelteTesting plugin to your Vite or Vitest config.

  // vite.config.js
  import { svelte } from '@sveltejs/vite-plugin-svelte'
+ import { svelteTesting } from '@testing-library/svelte/vite'

  export default defineConfig({
    plugins: [
      svelte(),
+     svelteTesting(),
    ]
  });

See the setup docs for more detailed setup instructions, including for other test runners like Jest.

Docs

See the docs over at the Testing Library website.

Issues

Looking to contribute? Look for the Good First Issue label.

πŸ› Bugs

Please file an issue for bugs, missing documentation, or unexpected behavior.

See Bugs

πŸ’‘ Feature Requests

Please file an issue to suggest new features. Vote on feature requests by adding a πŸ‘. This helps maintainers prioritize what to work on.

See Feature Requests

❓ Questions

For questions related to using the library, please visit a support community instead of filing an issue on GitHub.

Contributors

Thanks goes to these people (emoji key):

Ben Monro
Ben Monro

πŸ’» ⚠️ πŸ€” πŸ“–
Emil Tholin
Emil Tholin

πŸ’» ⚠️ πŸ€”
Eduardo Rabelo
Eduardo Rabelo

⚠️ πŸ’» πŸ“– πŸ’‘
Tim Deschryver
Tim Deschryver

πŸ“–
Emanuele
Emanuele

πŸ’» ⚠️ πŸ“–
pngwn
pngwn

πŸ’» ⚠️
Sebastian Silbermann
Sebastian Silbermann

πŸ’»
Rahim Alwer
Rahim Alwer

πŸ’» πŸ“– ⚠️ πŸ‘€
Bob
Bob

πŸ› πŸ’»
Ron Merkin
Ron Merkin

πŸ’»
Ben McCann
Ben McCann

⚠️
John Bowser
John Bowser

πŸ’» ⚠️
Yoann
Yoann

πŸ’»
Yanick Champoux
Yanick Champoux

πŸ’»
Michael Cousins
Michael Cousins

πŸ’»

This project follows the all-contributors specification. Contributions of any kind welcome!