Aserciones

Una aserción es el núcleo de una prueba. Expresa un hecho que debe ser verdadero. Si lo es, la prueba continúa. Si no, busted registra un fallo con un mensaje útil.

busted utiliza la biblioteca luassert, a la que se accede mediante la tabla global assert.

assert.are.equal comprueba la igualdad mediante el operador ==. El primer argumento es el valor esperado y el segundo es el valor real.

Funciona con números, cadenas y booleanos, pero con las tablas compara la identidad, no el contenido.

Para comparar profundamente el contenido de dos tablas, use assert.are.same. Comprueba de forma recursiva que las dos tablas contengan los mismos valores.

Use same para estructuras de datos y equal para primitivas o comprobaciones de identidad.

assert.is_true y assert.is_false comprueban que los valores sean exactamente booleanos. assert.is_truthy acepta cualquier valor que no sea nil ni false.

Elija la variante estricta cuando espere específicamente un resultado booleano.

assert.is_nil verifica que un valor sea nil, y assert.is_not_nil verifica que esté presente. Estas comprobaciones son habituales al consultar valores.

Dejan más clara la intención que comparar con nil mediante equal.

La mayoría de las aserciones se pueden negar insertando is_not o usando la forma are_not. Esto expresa que algo debe ser diferente.

Por ejemplo, assert.are_not.equal pasa cuando los dos valores son diferentes.

Para comprobar que el código genera un error, inclúyalo en una función y pásela a assert.has_error. busted llama a la función y confirma que haya generado un error.

También puede comprobar el mensaje de error pasando una cadena esperada como segundo argumento.

La comprobación opuesta es assert.has_no.errors. Pasa cuando la función incluida se ejecuta sin generar errores.

Resulta útil para confirmar que una llamada del flujo correcto no falla, incluso cuando no comprueba su valor de retorno.

Puede añadir un mensaje a la mayoría de las aserciones para aclarar los errores. Páselo como argumento adicional para que el informe explique lo que se esperaba.

Los mensajes claros convierten un error críptico en uno que indica cómo actuar.

luassert proporciona modificadores y matchers para realizar comprobaciones más completas. Por ejemplo, assert.matches comprueba una cadena con respecto a un patrón de Lua.

Esto resulta práctico cuando una comprobación de igualdad exacta es demasiado estricta para una salida variable.

Elija la aserción más específica para que la intención quede clara. Use same para tablas, equal para primitivas, has_error para errores y comprobaciones de valores de verdad para booleanos.

Las aserciones específicas producen mejores mensajes de error, lo que agiliza la depuración.

luassert proporciona la tabla assert de busted. Use are.equal para primitivas, are.same para comparar tablas en profundidad y comprobaciones de valores de verdad o de nil cuando corresponda.

Compruebe los errores con has_error y los casos correctos con has_no.errors. Niegue las aserciones con is_not y añada mensajes para obtener informes más claros.