DEV Community

loading...
Cover image for Master Unit Testing Vue.js (Very Simple).

Master Unit Testing Vue.js (Very Simple).

hamzanouali profile image Hamza Nouali ・3 min read

How much time have you spent trying to understand what to test in Vue.js? what is testing? How to unit test Vue.js application!

There are a lot of articles and videos out there talking about Vue.js testing with jest, mocha, etc. But many of them assume that people are already familiar with unit testing and know exactly what to test.

Table of Content

  • What is Unit Testing in Vue.js? Why do I need it?
  • What to Test in Vue.js application?
  • Tips
  • Resources to dig deeper

What is Unit Testing in Vue.js? Why do I need it?

Let's make it simple. Always when you create a new component, you are going to test it manually:

  1. import that component to your code.
  2. you open your browser and start asserting that all features are working.

Quick Example:

You've created a ProductViewer component, this component receives the product details to show it in an HTML card.
Alt Text

Your Component Receives:

  1. product name.
  2. product link on Amazon.
  3. product image.

Your Component Outputs:

HTML card that shows the product name, image and when you click on it, it redirects you to the product's page on Amazon.

Your manual test is like this:

  1. you import this component to your Vue app.
  2. you open your browser to assert that the HTML card is working, the name and image are rendered correctly and when you click on this card it redirects you to the correct link.

This test is essential, but fragile!

Imagine that your component is working 100% well. one day, you want to add more product details or any kind of feature, you write, update or remove existing code. you go to your browser to check that everything is working but you forgot to click on the card.
After a while, some users tells you that clicking on the product is not working! you are not redirecting any users! you are wasting money!

Actually, you are able to avoid this mistake by unit testing your code, let me show you.

Unit Testing in Practice

Before we start testing, you have to know:

What to test?

In Vue.js particularly, don't test logic, don't test methods, functions, watchers ,etc (even filters, don't test it).
Just look at your component from the sky and treat it as a factory that receives inputs to return outputs.

Big NOTE:

Don't test code that you didn't write!, don't test something other people have already tested it.
Example: don't test v-model, don't try to assert that clicking on <a href="google.com"></a> will redirect you to google.com, etc.
Now, let's get back to our subject.

Take a look at ProductViewer component.

Alt Text

Take a look at its code:

Alt Text
Alt Text

What inputs do we have?

  1. name and link
  2. slot

What output should be tested?

  1. We must assert that the name of the product exists and equals to our props name.
  2. We must assert that the image exists and contains the same src of the given slot.
  3. we must assert that the a tag exists and contains our link in the href attribute (by using css selector like this a[href=${link}]).

Tips

  • Go to open-source projects and start testing, there are people will review your tests and gives you feedback.
  • Download open-source projects and take a look at their tests.
  • Read the next section down below.

Resources:

Discussion (2)

pic
Editor guide
Collapse
martyonthefly profile image
Sylvain Marty

Hi Hamza! If I want to add unit tests to an existing Vue project which doesn't use any, where should I start ?

Collapse
hamzanouali profile image
Hamza Nouali Author • Edited

What do you mean where should I start ?. Basically, you should start testing your components (Input & outputs).