Cypress App

Svelte Component Testing

info

What you'll learn

• How to set up component tests in Svelte
• How to configure Cypress for Svelte projects
• How to test Svelte components with Vite and a custom Webpack config

Framework Support

Cypress Component Testing supports Svelte 5 in a variety of different frameworks:

• Svelte with Vite
• Svelte with Webpack

caution

Svelte is currently in alpha support for component testing.

Tutorial

Visit the Getting Started Guide for a step-by-step tutorial on adding component testing to any project and how to write your first tests.

Installation

To get up and running with Cypress Component Testing in Svelte, install Cypress into your project:

npm

npm install cypress --save-dev

Yarn

yarn add cypress --dev

pnpm

pnpm add --save-dev cypress

Bun

bun add --dev cypress

Open Cypress:

npm

npx cypress open

Yarn

yarn cypress open

pnpm

pnpm cypress open

Bun

bunx cypress open

Choose Component Testing

The Cypress Launchpad will guide you through configuring your project.

info

For a step-by-step guide on how to create a component test, refer to the Getting Started guide.

For usage and examples, visit the Svelte Examples guide.

Framework Configuration

Cypress Component Testing works out of the box with Vite, and a custom Webpack config. Cypress will automatically detect one of these frameworks during setup and configure them properly.

For a full explanation of how the dev server and bundler work — including automatic config detection and override options — see Component Testing Configuration — Dev Server and Bundler.

The examples below are for quick reference.

Svelte with Vite

Cypress Component Testing works with Svelte apps that use Vite 5+ as the bundler.

Vite Configuration

cypress.config.js

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  component: {
    devServer: {
      framework: 'svelte',
      bundler: 'vite',
    },
  },
})

cypress.config.ts

import { defineConfig } from 'cypress'

export default defineConfig({
  component: {
    devServer: {
      framework: 'svelte',
      bundler: 'vite',
    },
  },
})

Svelte Vite Sample Apps

• Svelte 5 Vite with Typescript

Svelte with Webpack

Cypress Component Testing works with Svelte apps that use Webpack 5+ as the bundler.

Webpack Configuration

cypress.config.js

const { defineConfig } = require('cypress')
const webpackConfig = require('./webpack.config')

module.exports = defineConfig({
  component: {
    devServer: {
      framework: 'svelte',
      bundler: 'webpack',
      // optionally pass in webpack config
      webpackConfig,
    },
  },
})

cypress.config.ts

import { defineConfig } from 'cypress'
import webpackConfig from './webpack.config'

export default defineConfig({
  component: {
    devServer: {
      framework: 'svelte',
      bundler: 'webpack',
      // optionally pass in webpack config
      webpackConfig,
    },
  },
})

If you don't provide one, Cypress will try to infer your webpack config. If Cypress cannot or you want to make modifications to your config, you can pass it in manually via the webpackConfig option.

Svelte Webpack Sample Apps

• Svelte 5 Webpack 5 with Typescript

See also

• Component Testing code coverage