Compartir vía

Tutorial: Prueba de una biblioteca de clases de .NET con Visual Studio Code

  • Artículo

En este tutorial se muestra cómo automatizar las pruebas unitarias mediante la adición de un proyecto de prueba a una solución.

Requisitos previos

Creación de un proyecto de prueba unitaria

Las pruebas unitarias proporcionan pruebas de software automatizadas durante el desarrollo y la publicación. El marco de trabajo de pruebas que se usa en este tutorial es MSTest. MSTest es uno de los tres marcos de pruebas que puede elegir. Los demás son xUnit y nUnit.

  1. Inicie Visual Studio Code.

  2. Abra la solución ClassLibraryProjects que creó en Crear una biblioteca de clases de .NET usando Visual Studio Code.

  3. En Explorador de soluciones, seleccione Nuevo proyecto o, en la paleta de comandos, seleccione .NET: Nuevo proyecto.

  4. Seleccione Proyecto de prueba de MSTest, asígneles el nombre "StringLibraryTest", seleccione el directorio predeterminado y seleccione Crear proyecto.

    La plantilla de proyecto crea un archivo UnitTest1.cs con el código siguiente:

    namespace StringLibraryTest;

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestMethod1()
    {
    }
}

    El código fuente creado por la plantilla de prueba unitaria hace lo siguiente:

    Cada método etiquetado con [TestMethod] en una clase de prueba etiquetada con [TestClass] se ejecuta automáticamente cuando se invoca la prueba unitaria.

Agregar una referencia de proyecto

Para que el proyecto de prueba funcione con la clase StringLibrary, agregue una referencia del proyecto StringLibraryTest al proyecto StringLibrary.

  1. En el Explorador de soluciones haga clic con el botón derecho en el proyecto "StringLibraryTest" y seleccione Agregar referencia de proyecto.

  2. Seleccione "StringLibrary".

Adición y ejecución de métodos de prueba unitaria

Cuando Visual Studio invoca una prueba unitaria, ejecuta cada método marcado con el atributo TestMethodAttribute en una clase que está marcada con el atributo TestClassAttribute. Un método de prueba finaliza cuando se encuentra el primer error, o cuando todas las pruebas contenidas en el método se han realizado correctamente.

Las pruebas más comunes llaman a los miembros de la clase Assert. Muchos métodos de aserción incluyen al menos dos parámetros, uno de los cuales es el resultado esperado de la prueba y el otro es el resultado real de la prueba. Algunos de los métodos Assert a los que se llama con más frecuencia se muestran en la tabla siguiente:

Métodos de aserción Función
Assert.AreEqual Comprueba que dos valores u objetos son iguales. La aserción da error si los valores o los objetos no son iguales.
Assert.AreSame Comprueba que dos variables de objeto hacen referencia al mismo objeto. La aserción da error si las variables hacen referencia a objetos diferentes.
Assert.IsFalse Comprueba si una condición es false. La aserción produce un error si la condición es true.
Assert.IsNotNull Comprueba que un objeto no sea null. La aserción da error si el objeto es null.

También puede usar el método Assert.ThrowsException (o Assert.Throws y Assert.ThrowsExactly si usa MSTest 3.8 y versiones posteriores) en un método de prueba para indicar el tipo de excepción que se espera que se produzca. La prueba dará error si no se inicia la excepción especificada.

Al probar el método StringLibrary.StartsWithUpper, quiere proporcionar varias cadenas que comienzan con un carácter en mayúsculas. Espera que el método devuelva true en estos casos, por lo que puede llamar al método Assert.IsTrue. Del mismo modo, quiere proporcionar un número de cadenas que comiencen con algo que no sea un carácter en mayúsculas. Espera que el método devuelva false en estos casos, por lo que puede llamar al método Assert.IsFalse.

Como el método de biblioteca controla cadenas, también se recomienda asegurarse de que controla correctamente una cadena vacía (String.Empty) y una cadena null. Una cadena vacía es aquella que no tiene ningún carácter y cuyo valor de Length es 0. Una cadena null es aquella que no se ha inicializado. Se puede llamar a StartsWithUpper directamente como un método estático y pasar un argumento String único. También puede llamar a StartsWithUpper como método de extensión en una variable de string asignada a null.

Definirá tres métodos, cada uno de los cuales llama a un método Assert para cada elemento de una matriz de cadenas. Llamará a una sobrecarga de método que le permite especificar que se muestre un mensaje de error en caso de error en la prueba. El mensaje identifica la cadena que causó el error.

Para crear los métodos de prueba:

  1. Abra StringLibraryTest/UnitTest1.cs y reemplace todo el código por el siguiente.

    using Microsoft.VisualStudio.TestTools.UnitTesting;
using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result,
                       string.Format("Expected for '{0}': true; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = { string.Empty, null };
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word == null ? "<null>" : word, result));
            }
        }
    }
}

    La prueba de caracteres en mayúsculas en el método TestStartsWithUpper incluye la letra mayúscula griega alfa (U + 0391) y la letra mayúscula cirílica EM (U + 041C). La prueba de caracteres en minúsculas en el método TestDoesNotStartWithUpper incluye la letra griega minúscula alfa (U + 03B1) y la letra cirílica minúscula Ghe (U + 0433).

  2. Guarda los cambios.

Compile y ejecute su prueba.

  1. En el Explorador de soluciones, haga clic con el botón derecho en la solución y seleccione Compilar o en la paleta de comandos, seleccione .NET: Build.

  2. Seleccione la ventana Pruebas, seleccione Ejecutar pruebas o, en la paleta de comandos, seleccione Prueba: ejecutar todas las pruebas.

    Explorador de pruebas de Visual Studio Code del Explorador de pruebas de Visual Studio Code

Gestionar fallos de prueba

Si está realizando el desarrollo controlado por pruebas (TDD), escribe las pruebas primero y fallan la primera vez que las ejecuta. Después, agregará un código a la aplicación para que la prueba se realice correctamente. En este tutorial, creaste la prueba después de escribir el código de la aplicación que valida, por lo que no has visto fallar la prueba. Para asegurarse de que una prueba genera un error cuando espera que lo haga, agregue un valor no válido a la entrada de prueba.

  1. Modifique la matriz words en el método TestDoesNotStartWithUpper para incluir la cadena "Error".

    string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

  2. Ejecute las pruebas haciendo clic en el error verde situado junto a la prueba en el editor.

    La salida muestra que la prueba falla y proporciona un mensaje de error para la prueba fallida: "Assert.IsFalse failed. Se esperaba para "Error": false; real: True". Debido al error, no se probaron todas las cadenas de la matriz después de "Error".

    Prueba fallida de Visual Studio Code

  3. Quite la cadena "Error" que agregó en el paso.

  4. Vuelva a ejecutar la prueba y se superarán las pruebas.

Probar la versión de lanzamiento de la biblioteca

Ahora que se han superado todas las pruebas al ejecutar la versión de depuración de la biblioteca, ejecute las pruebas una vez más con la versión de lanzamiento de la biblioteca. Varios factores, como las optimizaciones del compilador, a veces pueden producir un comportamiento diferente entre las compilaciones de depuración y versión.

  1. Ejecute las pruebas con la configuración de compilación Release:

    dotnet test StringLibraryTest/StringLibraryTest.csproj --configuration Release

    Las pruebas se superan.

Depuración de pruebas

Si usa Visual Studio Code como IDE, puede utilizar el mismo proceso que se muestra en Tutorial: Depuración de una aplicación de consola de .NET con Visual Studio Code para depurar código mediante el proyecto de prueba unitaria. En lugar de iniciar el proyecto de aplicación Showcase, abra StringLibraryTest/UnitTest1.cs y seleccione Depurar pruebas de archivo actual entre las líneas 7 y 8. Si no puede encontrarlo, pulse Ctrl+Mayús+P para abrir la paleta de comandos y escriba Recargar ventana.

Visual Studio Code inicia el proyecto de prueba con el depurador asociado. La ejecución se detendrá en cualquier punto de interrupción que haya agregado al proyecto de prueba o al código de la biblioteca subyacente.

Recursos adicionales

Pasos siguientes

En este tutorial, ha realizado una prueba unitaria de una biblioteca de clases. Puede poner la biblioteca a disposición de otros usuarios si la publica en NuGet como un paquete. Para obtener información sobre cómo hacerlo, realice este tutorial de NuGet:

Creación y publicación de un paquete con la CLI de dotnet

Si publica una biblioteca como un paquete NuGet, otros usuarios pueden instalarla y usarla. Para obtener información sobre cómo hacerlo, realice este tutorial de NuGet:

Instalar y usar un paquete con la CLI de dotnet

No es necesario distribuir una biblioteca como un paquete. Se puede integrar con una aplicación de consola que la utilice. Para aprender a publicar una aplicación de consola, vea el tutorial anterior de esta serie:

Publicación de una aplicación de consola de .NET con Visual Studio Code

El kit de desarrollo de C# de la extensión de Visual Studio Code proporciona más herramientas para desarrollar aplicaciones y bibliotecas de C#:

Kit de desarrollo de C#