Vue Test Utils — Vue 3 Component Testing

On this page

Overview

Vue Test Utils 2.5.1 is the official Vue 3 component-testing utility for mounting components and asserting rendered output, props, emitted events, child components, plugins, and global configuration.

Features and best fit

Based on official documentation; not hands-on tested · Content checked: 2026-10-05

Key features

Mount components and assert behavior through wrappers

Mounted Vue components return wrapper APIs for inspecting DOM output, attributes, text, props, and emitted events.

Sources: [1][2]

Adjust test boundaries with shallow mounting and global configuration

Tests can stub child components or provide plugins, injections, and global components depending on the desired unit-test boundary.

Sources: [1]

Best fit

Fits regression and interaction tests for Vue 3 components

It is useful for forms, dialogs, lists, and component libraries where props, rendered output, and user-triggered events should be verified at component scope.

Sources: [1]

Before adoption

Version 2.5.1 requires Vue 3.x plus compiler and server-renderer peers

Package metadata declares Vue 3.x, @vue/compiler-dom 3.x, and @vue/server-renderer 3.x as peer dependencies.

Sources: [2]

Version 2.5.1 fixes generic SFC findComponent typing and shared build config

The maintenance release fixes findComponent types for generic SFCs and shares configuration across builds, which is relevant to TypeScript-heavy test suites.

Sources: [3]

Official sources

[1]Vue Test Utils v2.5.1 README(2026-10-05)
[2]@vue/test-utils 2.5.1 package metadata(2026-10-05)
[3]Vue Test Utils v2.5.1 release(2026-10-05)
[4]Vue Test Utils MIT license(2026-10-05)

Supplemental curator note

Vue Test Utils 2.5.1 requires Vue 3.x plus @vue/compiler-dom 3.x and @vue/server-renderer 3.x as peer dependencies. Keeping the Vue packages on the same release line simplifies compatibility checks.

Try it in 3 steps

1
Install Vue Test Utils 2.5.1 with aligned Vue 3.5.43 peers
Create an isolated npm project with Vue Test Utils and its Vue peer packages pinned to the same release.
demo=$(mktemp -d "${TMPDIR:-/tmp}/vue-test-utils.XXXXXX") && cd "$demo" && npm init -y >/dev/null && npm install --save-dev --save-exact @vue/test-utils@2.5.1 vue@3.5.43 @vue/compiler-dom@3.5.43 @vue/server-renderer@3.5.43
2
Verify package versions
Require Vue Test Utils and Vue to match the reviewed versions.
test "$(node -e "const fs=require('fs');const v=p=>JSON.parse(fs.readFileSync(p)).version;console.log(v('node_modules/@vue/test-utils/package.json')+'/'+v('node_modules/vue/package.json'))")" = '2.5.1/3.5.43'
3
Check representative testing exports
Verify core mounting and configuration APIs without starting a test runner.
test "$(node -e "const V=require('@vue/test-utils');console.log(['mount','shallowMount','config'].every(k=>k in V))")" = 'true'

Check the official README

Growth

Growth trends · Last 30 days

1,160 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days): 13
Open PRs: 9

Development activity is still being collected.

Built with

TypeScript

Categories and tags

GitHub data

GitHub dataView detailed GitHub data

View on GitHub

Stars: 1,160
Forks: 294
Watchers: 20
Open issues: 24
Contributors: 192
Owner type: Organization
Primary language: TypeScript
License: MIT
Repository last updated: Oct 1, 2026

Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.

After reading this page, do you know what to do next?