# Pruebas de contrato

## Qué es

Las pruebas de contrato comprueban que dos componentes coinciden en sus expectativas sobre las
solicitudes, respuestas o mensajes que intercambian. Una pantalla de seguimiento de envíos y su
servicio pueden superar sus pruebas por separado. Aun así, la pantalla fallará si busca un campo
llamado `status` y el servicio envía `state`. Una prueba de la interfaz expresa qué necesita la
pantalla y verifica que el servicio puede proporcionarlo.

Pact describe un método en el que el consumidor utiliza un sustituto controlado del proveedor. Su
prueba registra las interacciones en un contrato. El proveedor verifica a continuación ese
contrato mediante su implementación real en unas condiciones determinadas. Para los mensajes, la
evidencia equivalente corresponde al mensaje que un lado produce y otro consume. Los dos pueden
trabajar y publicar versiones de forma independiente, siempre que la evidencia identifique las
versiones que en realidad se usarán juntas.

Otros equipos llaman prueba de contrato a verificar un proveedor a partir de una descripción
publicada de la interfaz, como un documento OpenAPI. Sirve cuando esa especificación es el
acuerdo compartido. Puede precisar campos, códigos de estado y valores permitidos. Los ejemplos
guiados por el consumidor muestran además qué combinaciones utiliza un cliente y qué supuestos
incorpora. El equipo se puede servir de los dos métodos. Una prueba a través de la integración
real comprueba cuestiones adicionales, como el encaminamiento y la configuración del entorno.

## Por qué importa

Una interfaz suele durar más que el código que la introdujo. El equipo del servicio puede
renombrar un campo y cambiar sus pruebas sin actualizar un cliente que se mantiene aparte. Una
aplicación móvil puede seguir usando una versión anterior durante meses. Incluso un cambio de
tipo importa si determina el mensaje que aparecerá en pantalla. Un contrato verificable permite
ver esas dependencias antes de publicar.

Con versiones independientes, interesa saber cuáles siguen siendo compatibles. Quizá un cliente
antiguo solo comprende unos pocos estados y el servicio necesita incorporar uno intermedio. Los
equipos pueden preparar primero al consumidor, aceptar las dos formas durante la transición y
retirar una de ellas cuando dejen de usarla las versiones relevantes. El orden seguro depende de
los contratos registrados, del uso real y de la política de publicación del sistema. El resultado
favorable de una pareja reciente no cubre todos los clientes que siguen en uso.

Las pruebas deberían expresar lo que de verdad se acuerda. Si vale cualquier referencia con
formato correcto, verifica el formato sin exigir el valor exacto del ejemplo. Si un campo
determina qué ve la persona usuaria, comprueba el tipo y los valores que el cliente entiende. Un
ejemplo bien escogido protege el comportamiento compartido y deja al proveedor margen para
modificar los detalles internos.

## Cómo se aplica en la práctica

Consideremos una aplicación ficticia de seguimiento de paquetes. Pide un envío por su referencia.
Si el paquete existe y está en camino, la pantalla espera una respuesta de éxito, una referencia
y un valor de texto que pueda convertir en una etiqueta. Si no se encuentra el paquete, espera
una respuesta distinta y ofrece revisar la referencia. Cada intercambio parte de una condición,
por ejemplo, que el envío solicitado se encuentre en tránsito o que no exista ningún registro con
ese identificador.

Haz que el código real del consumidor formule la solicitud contra el sustituto controlado.
Verifica que la aplicación muestra el resultado adecuado para cada ejemplo. Aplica después los
intercambios a la ruta real de respuesta del proveedor. Prepara datos deterministas para el
estado correspondiente y restablécelos entre pruebas. Si se sustituye la base de datos o la red
del transportista, conserva en ejecución el análisis de la solicitud, la lógica del servicio y la
generación de la respuesta que utiliza el consumidor.

Cambia provisionalmente el campo `status` a `state` sin modificar el cliente. La verificación
debería señalar que falta el campo y nombrar el intercambio afectado. La presencia de un campo
opcional que el consumidor ignora puede ser válida si el acuerdo lo permite. Vincula la evidencia
a sus versiones. Mezclar un resultado del proveedor nuevo con una copia del contrato antiguo sin
dejar constancia del origen impide saber qué combinación se verificó.

En nuestra [nota sobre enlaces a aplicaciones dentro de billeteras móviles de
Solana](/es/notes/solana-mobile-wallet-deeplinks/), varias integraciones esperan rutas y
codificaciones distintas. La nota registra esas diferencias e incluye comprobaciones con
dispositivos. Una comprobación de los enlaces generados podría proteger la forma acordada para
cada billetera. Un ensayo real permite observar si el navegador entrega el enlace a la aplicación
instalada y termina el recorrido. Cada prueba responde una pregunta distinta.

## Dónde surgen los problemas

Un contrato se vuelve rígido si exige que coincidan todos los bytes de una respuesta. Puede ser
válido añadir un campo sin uso o cambiar el formato de un mensaje auxiliar. Exige un valor, un
orden o una unidad cuando el consumidor dependa de ellos o la especificación pública los
establezca. Deja que los aspectos accidentales puedan variar.

Las pruebas también pierden valor si sortean la interfaz. Verificar un archivo de ejemplo escrito
a mano puede dejar sin ejecutar el código que genera la respuesta. Comprobar que el sustituto
devuelve un dato preparado tampoco demuestra que el consumidor pueda interpretarlo. Ejecuta el
código real de la parte que estás comprobando y registra qué dependencias se han sustituido.

Por último, un único recorrido normal deja dudas sobre los datos ausentes, los identificadores
desconocidos y los clientes antiguos. Localiza los errores que el cliente sabe presentar y las
versiones que el proveedor se compromete a admitir. Conserva pruebas de integración para ejercer
el encaminamiento y la configuración. El contrato aporta una comprobación más rápida y enfocada
que el equipo puede repetir ante cada cambio pertinente.

## Lecturas adicionales

- [Documentación de Pact sobre qué comprueban las pruebas de
  contrato](https://docs.pact.io/#what-is-contract-testing)
- [Comprobación de consumidores y proveedores en
  Pact](https://docs.pact.io/getting_started/how_pact_works)
- [Estados del proveedor en Pact](https://docs.pact.io/getting_started/provider_states)
- [Especificación OpenAPI para describir interfaces
  HTTP](https://spec.openapis.org/oas/latest.html)

<https://engineer.company/es/glossary/contract-testing/>
