Casos de prueba Gherkin

Un caso escribe sus pasos en uno de dos formatos. Los pasos Clásico tienen una acción, datos opcionales y un resultado esperado. Los pasos Gherkin tienen una palabra clave y su texto, con un Doc String o una Data Table opcionales como argumento, y no tienen resultado esperado. Usa Gherkin cuando tu equipo describe el comportamiento como escenarios o cuando esos escenarios ya viven en archivos .feature.

Elegir el formato de un caso

Usa el selector Clásico / Gherkin, arriba de los pasos en el editor de casos: en la página de caso nuevo, en el panel de detalle y en el diálogo ampliado. Al cambiarlo, los pasos se convierten en su lugar:

Mientras el caso use pasos compartidos, su formato no puede cambiar. Conviértelos o quítalos primero.

Escribir pasos Gherkin

La vista Filas es la predeterminada: una fila por paso, con una palabra clave, el texto del paso y un argumento opcional. El argumento es un Doc String (texto entre dos líneas """) o una Data Table (filas que empiezan con |).

La vista Texto edita todos los pasos como texto. Solo está disponible para casos Gherkin y se desactiva mientras el caso usa pasos compartidos. Mientras está abierta, agregas pasos escribiendo líneas nuevas; los botones de pasos vuelven en Filas. Cada paso ocupa una línea: la palabra clave y después su texto. Un Doc String va entre líneas """, y una Data Table empieza con | en las líneas que siguen a su paso:

Given estos usuarios existen
| name | role   |
| Ana  | admin  |
| Ben  | member |
When Ana inicia sesión
Then se abre el panel

Probara marca las líneas que no puede leer, por ejemplo una línea sin palabra clave, un paso sin texto o un Doc String sin cerrar. No guarda hasta que corriges esas líneas.

Parámetros

Un caso Gherkin lee los marcadores ${nombre} y <nombre> en su título, su descripción, sus pasos, sus Doc Strings y sus Data Tables. Los Examples de un Scenario Outline son los parámetros del caso, así que un <nombre> en un paso coincide con una columna de Examples. Consulta Casos de prueba parametrizados.

Formato por defecto del proyecto

En la configuración del proyecto, la pestaña Repositorio tiene Formato de pasos por defecto, con los valores Clásico o Gherkin. Un caso nuevo lo toma, salvo que quien lo crea elija otro formato. Cambiarlo deja los casos existentes como están.

Pasos compartidos

Un paso compartido tiene un único formato. Lo eliges con Formato de pasos en el diálogo de creación, y no cambia después. Un caso Gherkin solo puede usar pasos compartidos Gherkin: el selector de inserción muestra solo los conjuntos de su formato, y la API rechaza una discrepancia con 422. Crear paso compartido con la selección da al nuevo conjunto el formato del caso. Consulta Pasos compartidos.

Ejecuciones e historial

En el panel de ejecución, un paso Gherkin muestra su palabra clave antes de su texto, y su argumento bajo Argumento en lugar de Datos. No tiene resultado esperado. Los intentos anteriores muestran la misma disposición. Una ejecución conserva las palabras clave con las que se creó, como el resto del contenido de un paso, hasta que aplicas la última versión del caso.

Los Examples de un outline crean un caso de ejecución por cada combinación, y cada caso de ejecución registra sus propios resultados.

La comparación de versiones muestra los cambios en la palabra clave de un paso y en el formato de pasos del caso.

Importar y exportar archivos .feature

Importar

Elige Gherkin (.feature) como origen en el asistente de importación. El archivo debe tener la extensión .feature y contener un solo Feature. Probara solo lee palabras clave en inglés. Un archivo que vive en un repositorio conviene mantenerlo sincronizado, para que sus casos sigan al archivo: consulta Sincronizar archivos .feature desde Git.

Un archivo falla completo, y el error indica la línea, cuando una línea no se puede interpretar. Tres casos lo provocan: una segunda línea Feature:, un bloque Examples: que no sigue a un Scenario Outline, y una línea # language: para un idioma distinto del inglés.

Un bloque de Examples que las reglas de parámetros no pueden sostener, por ejemplo una columna simple con más de 100 filas, no hace fallar el archivo. El caso se importa sin sus parámetros, y la importación muestra el aviso «Parámetros no aplicados — el caso se importó sin ellos».

Exportar

Elige Gherkin (.feature, zip) en el diálogo de exportación. La descarga es un zip con un archivo .feature por suite, y solo incluye casos Gherkin. Una selección sin ningún caso Gherkin se rechaza.

Un caso con parámetros se exporta como un Scenario Outline con una tabla Examples: una columna por cada nombre de parámetro y una fila por cada combinación que ejecuta el caso. Una exportación .feature escribe las combinaciones que ejecuta el caso como una sola tabla Examples; las combinaciones excluidas y la división entre parámetros simples y grupos no se conservan. Por eso, al volver a importar el archivo, el caso recibe un grupo llamado Examples, o un parámetro simple si la tabla tiene una sola columna.

Cada escenario empieza con un comentario que lleva el ID de su caso, por ejemplo # SHOP-12. Probara no vuelve a leer ese comentario: para actualizar los casos de los que salió un archivo, impórtalo con Reemplazar casos de prueba coincidentes activado, que asocia cada escenario con el caso del mismo título en la suite destino. La sincronización desde Git tampoco lee ese comentario: vincula un escenario con su caso mediante una etiqueta @probara:SHOP-12. Reemplazar coincidencias omite los casos sincronizados desde Git, así que importar una exportación no los cambia.

Sincronizado desde Git

Un caso sincronizado desde un archivo .feature de un repositorio muestra la insignia Sincronizado desde Git, con la ruta y la línea del archivo. Su título, su descripción, sus pasos, su precondición y las etiquetas que le da su archivo son de solo lectura: cambia el escenario en el archivo, mediante un pull request. Sus pasos no se pueden convertir en un paso compartido, y su formato de pasos no puede cambiar. El responsable, la prioridad, los campos personalizados, los defectos, los comentarios, los planes y las ejecuciones siguen siendo editables. Consulta Sincronizar archivos .feature desde Git.

Los Examples de un outline sincronizado son sus parámetros. Un cambio en ellos dentro del archivo cambia el caso mediante la sincronización. Un escenario cuyos Examples las reglas de parámetros no pueden sostener se rechaza completo, y la sincronización nombra el escenario y su línea.

Límites

• Los adjuntos no se importan, igual que en cualquier otro formato.
• Los parámetros siguen los mismos límites que cualquier otro formato: por ejemplo, 20 nombres de parámetro por caso y 1.024 combinaciones por caso. Consulta Casos de prueba parametrizados.

API y MCP

La API acepta stepFormat al crear o actualizar un caso, keyword en cada paso y defaultStepFormat en un proyecto. También acepta parameters y excludedCombinations en un caso. Un guardado que cambie el escenario de un caso sincronizado responde 409 test_case_synced_read_only. Consulta la referencia de la API y la referencia de herramientas MCP.