Kotlin Academy · Lección

Escritura de pruebas con JUnit5

Estructure las pruebas

Escritura de pruebas con JUnit5 es una lección gratuita de Kotlin Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Kotlin Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Kotlin Academy incluye 4 lecciones en total.

¿Qué es JUnit5?

JUnit5 (JUnit Jupiter) es el framework de testing estándar para la JVM y Kotlin. Proporciona anotaciones para marcar y estructurar el código de prueba.

Las pruebas se encuentran en src/test/kotlin
Cada prueba es una función
El ejecutor las ejecuta e informa de los resultados

Añadir la dependencia

Añada JUnit Jupiter a la configuración de pruebas y habilite la plataforma de JUnit.

dependencies {
    testImplementation("org.junit.jupiter:junit-jupiter:5.10.2")
}

tasks.test {
    useJUnitPlatform()
}

Su primera prueba

Anote una función con @Test. Una prueba comprueba algo sobre su código.

import org.junit.jupiter.api.Test
import org.junit.jupiter.api.Assertions.assertEquals

class MathTest {
    @Test
    fun addsTwoNumbers() {
        assertEquals(4, 2 + 2)
    }
}

Nombres descriptivos para las pruebas

Use @DisplayName para obtener informes de pruebas legibles sin usar nombres de función largos.

import org.junit.jupiter.api.Test
import org.junit.jupiter.api.DisplayName

class OrderTest {
    @Test
    @DisplayName("total includes tax")
    fun totalWithTax() {
        // ...
    }
}

Configuración con @BeforeEach

@BeforeEach se ejecuta antes de cada prueba, por lo que resulta ideal para disponer de fixtures nuevos. @AfterEach se ejecuta después de cada prueba para realizar la limpieza.

import org.junit.jupiter.api.BeforeEach

class CartTest {
    private lateinit var cart: MutableList<String>
    @BeforeEach
    fun setUp() {
        cart = mutableListOf()
    }
}

Configuración a nivel de clase

@BeforeAll y @AfterAll se ejecutan una vez para toda la clase. En Kotlin necesitan un companion object con @JvmStatic (o un ciclo de vida por clase).

import org.junit.jupiter.api.BeforeAll

class DbTest {
    companion object {
        @BeforeAll
        @JvmStatic
        fun connect() {
            // open shared connection
        }
    }
}

Arrange-Act-Assert

estructure cada prueba en tres fases claras:

Arrange — prepare las entradas y el estado
Act — invoque el código que se está probando
Assert — verifique el resultado

Esto mantiene las pruebas legibles y centradas.

Pruebas anidadas

@Nested agrupa pruebas relacionadas y genera un informe en forma de árbol que documenta el comportamiento.

import org.junit.jupiter.api.Nested
import org.junit.jupiter.api.Test

class StackTest {
    @Nested
    inner class WhenEmpty {
        @Test fun isEmpty() { /* ... */ }
    }
}

Pruebas parametrizadas

Ejecute la misma prueba con varias entradas mediante @ParameterizedTest y una fuente de valores.

import org.junit.jupiter.params.ParameterizedTest
import org.junit.jupiter.params.provider.ValueSource
import org.junit.jupiter.api.Assertions.assertTrue

class NumberTest {
    @ParameterizedTest
    @ValueSource(ints = [2, 4, 6])
    fun isEven(n: Int) {
        assertTrue(n % 2 == 0)
    }
}

Deshabilitar y etiquetar

Omita temporalmente una prueba con @Disabled y agrupe las pruebas con @Tag para poder incluirlas o excluirlas en las ejecuciones de CI.

import org.junit.jupiter.api.Disabled
import org.junit.jupiter.api.Tag
import org.junit.jupiter.api.Test

class FlakyTest {
    @Test
    @Disabled("fix later")
    @Tag("slow")
    fun pending() { }
}

Un ejemplo autocontenido

A continuación se muestra una función sencilla de Kotlin puro y la idea en la que se basa su prueba (la prueba se ejecuta bajo JUnit).

fun add(a: Int, b: Int): Int = a + b

fun main() {
    val result = add(2, 3)
    println(if (result == 5) "PASS" else "FAIL")
}

Comprobación rápida

Necesita una lista nueva y vacía antes de cada método de prueba. ¿Qué anotación corresponde?

Resumen

Puede estructurar las pruebas de JUnit5:

@Test marca las pruebas y @DisplayName les asigna un nombre
@BeforeEach / @BeforeAll gestionan la configuración
Arrange-Act-Assert mantiene las pruebas claras
@Nested y @ParameterizedTest organizan y amplían las pruebas

A continuación: aserciones.

Preguntas frecuentes

¿La lección «Escritura de pruebas con JUnit5» es gratis?

Sí — el texto completo de «Escritura de pruebas con JUnit5» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Kotlin Academy, actualiza a CoddyKit PRO. El curso de Kotlin Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Escritura de pruebas con JUnit5»?

Estructure las pruebas Practicas Kotlin Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Kotlin Academy?

No se requiere experiencia previa. Kotlin Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.

¿Cuánto tiempo toma la lección «Escritura de pruebas con JUnit5»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Kotlin Academy?

Sí. Cada lección de Kotlin Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

Escritura de pruebas con JUnit5
Aserciones
Mocking con MockK
Pruebas de coroutines

← Volver a Kotlin Academy