Matchers
Assertions expressives
Matchers est une leçon Scala for Backend Engineering & Functional Programming gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Scala for Backend Engineering & Functional Programming, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Scala for Backend Engineering & Functional Programming comprend 4 leçons au total.
Que sont les matchers ?
Les matchers de ScalaTest fournissent une syntaxe expressive, proche de l’anglais, pour les assertions. Au lieu d’écrire assert(x == 3), vous écrivez x shouldBe 3, ce qui produit des tests lisibles et des messages d’échec clairs.
Mélanger les matchers
Ajoutez le trait Matchers à votre spécification pour activer la DSL. Il peut être combiné avec n’importe quel style de test.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class DemoSpec extends AnyFlatSpec with Matchers {
"A value" should "equal itself" in {
val x = 3
x shouldBe 3
}
}Matchers d’égalité
Vérifiez l’égalité avec shouldBe ou should equal. Les deux utilisent ==, tout en se lisant naturellement.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class EqSpec extends AnyFlatSpec with Matchers {
"sum" should "be correct" in {
(2 + 2) shouldBe 4
(2 + 2) should equal (4)
}
}Comparateurs d’égalité
Les comparaisons numériques se lisent comme une phrase : should be >, should be <=, et les intervalles avec be within pour définir une tolérance sur les nombres à virgule flottante.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class CmpSpec extends AnyFlatSpec with Matchers {
"a number" should "compare" in {
7 should be > 3
7 should be <= 7
2.0 shouldBe 2.0 +- 0.01
}
}Comparateurs de chaînes
Les comparateurs de chaînes comprennent startWith, endWith, include et les expressions régulières avec fullyMatch regex.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class StrSpec extends AnyFlatSpec with Matchers {
"a string" should "match parts" in {
"hello world" should startWith ("hello")
"hello world" should include ("o w")
"hello world" should endWith ("world")
}
}Comparateurs de collections
Inspectez les collections de manière fluide : have size, contain, contain allOf, et vérifiez qu’elles sont vides avec shouldBe empty.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class ColSpec extends AnyFlatSpec with Matchers {
"a list" should "have expected contents" in {
List(1, 2, 3) should have size 3
List(1, 2, 3) should contain (2)
List.empty[Int] shouldBe empty
}
}Comparateurs de booléens et d’options
Comparez directement les valeurs booléennes et le contenu des Option : shouldBe true, shouldBe defined et should contain pour la valeur interne.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class OptSpec extends AnyFlatSpec with Matchers {
"an option" should "be inspected" in {
Some(5) shouldBe defined
Some(5) should contain (5)
None shouldBe empty
}
}Combinaison de comparateurs
Combinez des attentes avec and / or pour créer des assertions composées.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class CombineSpec extends AnyFlatSpec with Matchers {
"a number" should "satisfy both" in {
7 should (be > 0 and be < 10)
}
}Tester les exceptions
Utilisez an [Exception] should be thrownBy { ... } ou assertThrows pour vérifier qu’un code échoue comme prévu.
import org.scalatest.flatspec.AnyFlatSpec
import org.scalatest.matchers.should.Matchers
class ExSpec extends AnyFlatSpec with Matchers {
"dividing by zero" should "throw" in {
an [ArithmeticException] should be thrownBy (1 / 0)
}
}Pourquoi les comparateurs sont utiles
En plus d’améliorer la lisibilité, les comparateurs produisent des messages d’échec descriptifs. L’échec de List(1,2) should have size 3 indique la taille attendue et la taille réelle, contrairement à un simple assert, qui indique seulement que le booléen était faux.
shouldBe ou should equal
Ils sont presque identiques ; shouldBe est plus concis et produit des messages légèrement plus clairs pour une égalité simple, tandis que should equal prend en charge des instances Equality personnalisées pour les comparaisons avancées.
Vérification rapide
Vérifiez vos connaissances sur les comparateurs.
Récapitulatif
Vous avez découvert les comparateurs de ScalaTest :
- Ajoutez
Matcherspour utiliser le DSL. - Égalité :
shouldBe,should equal; comparaisons avecbe >,+- tolerance. - Chaînes :
startWith,include; collections :have size,contain. - Exceptions :
should be thrownBy. - Les comparateurs produisent des échecs clairs et descriptifs.
Apprends Scala avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 39
- Leçons
- 143
Questions Fréquemment Posées
La leçon « Matchers » est-elle gratuite ?
Oui — le texte complet de « Matchers » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Scala for Backend Engineering & Functional Programming, passe à CoddyKit PRO. Le cours Scala for Backend Engineering & Functional Programming comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Matchers » ?
Assertions expressives Tu pratiques Scala for Backend Engineering & Functional Programming avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Scala for Backend Engineering & Functional Programming ?
Aucune expérience préalable n'est requise. Scala for Backend Engineering & Functional Programming sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Matchers » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Scala for Backend Engineering & Functional Programming ?
Oui. Chaque leçon Scala for Backend Engineering & Functional Programming inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.