Course Introduction

Introduction

Introduction to module 1 - Plugin features and set up

Intro to module 1

Main features and options

In this course we won't be building an app from scratch, but fixing existing examples and apps containing errors. We need to download and setup the provided sample codes to be able to work with them in the corresponding lessons.

Working with the provided sample codes

Get instant feedback by setting ESLint in your code editor

Integrating ESLint into your code editor

Install and configure eslint-plugin-testing-library in your codebase

Setting the plugin up in your project

The advanced config to lint only what's necessary

Run the plugin only on test files

Guidelines to migrate from a previous version to the latest v5

Migrating the plugin to v5

How to take advantage of the plugin when working in a Create React App project

Using the plugin in a Create React App project

Plugin features and set up

Introduction to module 2 - Rules for following best practices

Intro to module 2

Understanding the errors reported by the rule `no-manual-cleanup`

no-manual-cleanup rule

Understanding the errors reported by the rule `prefer-screen-queries`

prefer-screen-queries rule

Understanding the errors reported by the rule `no-await-sync-query`

no-await-sync-query rule

Rules for following best practices

Rules for preventing errors

Rules for style guidelines & Advanced Features

Testing Library is a great bunch of utils to write tests for your UI. It has become the favorite testing choice of many users since it encourages you to write more maintainable and reliable tests, encourages best practices, and doesn't focus on implementation but behavior.

However, testing your app correctly with Testing Library is not always straightforward. _What query variant fits better for this situation? How should I check appearance/disappearance? What is the best way to handle async behaviors? Why am I seeing this particular error or warning? Why am I not getting the expected element?_ These are very typical questions while writing tests with Testing Library.

You are not alone! This course aims to help you master these situations with the assistance of `eslint-plugin-testing-library`: the official ESLint plugin for Testing Library.

The course will boost your Testing Library skills by using this plugin
as a companion when writing tests. You will get instant feedback by linting your tests code, so you can **follow best practices and anticipate common mistakes for Testing Library**, as well as better understand its utils and their main purposes.

Get ready to say goodbye to flaky tests!

Master writing Testing Library tests with eslint-plugin-testing-library by anticipating common mistakes and following best practices

Master Testing Library with ESLint Plugin

How to set up eslint-plugin-testing-library in your codebase

Getting ESLint feedback directly in your code editor and your terminal

ESLint advanced config for getting more granular control over the linting process

Better understanding of Testing Library errors

Following best practices for Testing Library tests

Welcome to the "Master Testing Library with ESLint Plugin" course!

Testing Library is a great bunch of utils to write tests for your UI.
It has become the favorite testing choice of many users since it encourages you to write more maintainable and reliable tests, encourages best practices, and doesn't focus on implementation but behavior.

However, testing your app correctly with Testing Library is not always straightforward. 

What query variant fits better for this situation? How should I check appearance/disappearance? What is the best way to handle async behaviors? Why am I seeing this particular error or warning? Why am I not getting the expected element?

 These are very typical questions while writing tests with Testing Library.

You are not alone! This course aims to help you master these situations with the assistance of 

: the ESLint plugin, to follow best practices and anticipate common mistakes when writing tests with Testing Library.

You will learn how to set up ESLint and this plugin, get the motivation
behind its rules, and understand all the feedback from them. This way,
the course will boost your Testing Library skills by using this plugin
as a companion when writing tests.

This course has 4 modules that will cover:

You will get the most out of this course if you have:

---
title: Course Introduction
description: What is this course about?
role: 'INTRODUCTION'
isPublicLesson: true
---

# Introduction

## About the course

Welcome to the "Master Testing Library with ESLint Plugin" course!

Testing Library is a great bunch of utils to write tests for your UI.
It has become the favorite testing choice of many users since it encourages you to write more maintainable and reliable tests, encourages best practices, and doesn't focus on implementation but behavior.

However, testing your app correctly with Testing Library is not always straightforward. _What query variant fits better for this situation? How should I check appearance/disappearance? What is the best way to handle async behaviors? Why am I seeing this particular error or warning? Why am I not getting the expected element?_ These are very typical questions while writing tests with Testing Library.

You are not alone! This course aims to help you master these situations with the assistance of `eslint-plugin-testing-library`: the ESLint plugin, to follow best practices and anticipate common mistakes when writing tests with Testing Library.

You will learn how to set up ESLint and this plugin, get the motivation
behind its rules, and understand all the feedback from them. This way,
the course will boost your Testing Library skills by using this plugin
as a companion when writing tests.

This course has 4 modules that will cover:

1.  `eslint-plugin-testing-library` features and setup
2.  Rules for following best practices
3.  Rules for preventing errors
4.  Rules for style guidelines & Advanced Features

## Prerequisites

You will get the most out of this course if you have:

-   Essential knowledge of the terminal and npm usage for managing dependencies and running commands:

    -   node v16 or greater
    -   npm v8.3 or greater
-   An IDE or code editor already setup (WebStorm or VSCode recommended)
-   Knowledge of basic ESLint usage
-   Understanding about how to read tests written with jest. Testing Library works with many other runners, but the course tests are written with jest.
-   Experience with Testing Library fundamentals

    -   querying elements
    -   firing events
    -   async methods
    -   rendering components

## What we won't do

-   **Installing and setting up ESLint**. We are providing basic config in the demo project, and assuming most of the users already have ESLint in place in their projects. You could look at [ESLint official docs](https://eslint.org/docs/user-guide/getting-started) to know more about it if necessary.
-   **Explaining fundamentals of Testing Library**. Going through this could take another course! Although you will learn new things about Testing Library utils with this course (even the more experienced users), we expect users taking the course to have some experience with Testing Library so we can start writing tests from minute one. If you are not comfortable with Testing Library, you could look at [Testing JavaScript](https://testingjavascript.com/).
-   **Giving an explanation of [jest](https://jestjs.io/en/)**. Same as Testing Library, we assume the users have some experience in this field so we can start writing tests from the very beginning. [Testing JavaScript](https://testingjavascript.com/) is a good resource for learning more about this too.