{"canonical_url":"https://engineer.company/es/glossary/contract-testing/","content_markdown":"# Pruebas de contrato\n\n## Qué es\n\nLas pruebas de contrato comprueban que dos componentes coinciden en sus expectativas sobre las\nsolicitudes, respuestas o mensajes que intercambian. Una pantalla de seguimiento de envíos y su\nservicio pueden superar sus pruebas por separado. Aun así, la pantalla fallará si busca un campo\nllamado `status` y el servicio envía `state`. Una prueba de la interfaz expresa qué necesita la\npantalla y verifica que el servicio puede proporcionarlo.\n\nPact describe un método en el que el consumidor utiliza un sustituto controlado del proveedor. Su\nprueba registra las interacciones en un contrato. El proveedor verifica a continuación ese\ncontrato mediante su implementación real en unas condiciones determinadas. Para los mensajes, la\nevidencia equivalente corresponde al mensaje que un lado produce y otro consume. Los dos pueden\ntrabajar y publicar versiones de forma independiente, siempre que la evidencia identifique las\nversiones que en realidad se usarán juntas.\n\nOtros equipos llaman prueba de contrato a verificar un proveedor a partir de una descripción\npublicada de la interfaz, como un documento OpenAPI. Sirve cuando esa especificación es el\nacuerdo compartido. Puede precisar campos, códigos de estado y valores permitidos. Los ejemplos\nguiados por el consumidor muestran además qué combinaciones utiliza un cliente y qué supuestos\nincorpora. El equipo se puede servir de los dos métodos. Una prueba a través de la integración\nreal comprueba cuestiones adicionales, como el encaminamiento y la configuración del entorno.\n\n## Por qué importa\n\nUna interfaz suele durar más que el código que la introdujo. El equipo del servicio puede\nrenombrar un campo y cambiar sus pruebas sin actualizar un cliente que se mantiene aparte. Una\naplicación móvil puede seguir usando una versión anterior durante meses. Incluso un cambio de\ntipo importa si determina el mensaje que aparecerá en pantalla. Un contrato verificable permite\nver esas dependencias antes de publicar.\n\nCon versiones independientes, interesa saber cuáles siguen siendo compatibles. Quizá un cliente\nantiguo solo comprende unos pocos estados y el servicio necesita incorporar uno intermedio. Los\nequipos pueden preparar primero al consumidor, aceptar las dos formas durante la transición y\nretirar una de ellas cuando dejen de usarla las versiones relevantes. El orden seguro depende de\nlos contratos registrados, del uso real y de la política de publicación del sistema. El resultado\nfavorable de una pareja reciente no cubre todos los clientes que siguen en uso.\n\nLas pruebas deberían expresar lo que de verdad se acuerda. Si vale cualquier referencia con\nformato correcto, verifica el formato sin exigir el valor exacto del ejemplo. Si un campo\ndetermina qué ve la persona usuaria, comprueba el tipo y los valores que el cliente entiende. Un\nejemplo bien escogido protege el comportamiento compartido y deja al proveedor margen para\nmodificar los detalles internos.\n\n## Cómo se aplica en la práctica\n\nConsideremos una aplicación ficticia de seguimiento de paquetes. Pide un envío por su referencia.\nSi el paquete existe y está en camino, la pantalla espera una respuesta de éxito, una referencia\ny un valor de texto que pueda convertir en una etiqueta. Si no se encuentra el paquete, espera\nuna respuesta distinta y ofrece revisar la referencia. Cada intercambio parte de una condición,\npor ejemplo, que el envío solicitado se encuentre en tránsito o que no exista ningún registro con\nese identificador.\n\nHaz que el código real del consumidor formule la solicitud contra el sustituto controlado.\nVerifica que la aplicación muestra el resultado adecuado para cada ejemplo. Aplica después los\nintercambios a la ruta real de respuesta del proveedor. Prepara datos deterministas para el\nestado correspondiente y restablécelos entre pruebas. Si se sustituye la base de datos o la red\ndel transportista, conserva en ejecución el análisis de la solicitud, la lógica del servicio y la\ngeneración de la respuesta que utiliza el consumidor.\n\nCambia provisionalmente el campo `status` a `state` sin modificar el cliente. La verificación\ndebería señalar que falta el campo y nombrar el intercambio afectado. La presencia de un campo\nopcional que el consumidor ignora puede ser válida si el acuerdo lo permite. Vincula la evidencia\na sus versiones. Mezclar un resultado del proveedor nuevo con una copia del contrato antiguo sin\ndejar constancia del origen impide saber qué combinación se verificó.\n\nEn nuestra [nota sobre enlaces a aplicaciones dentro de billeteras móviles de\nSolana](/es/notes/solana-mobile-wallet-deeplinks/), varias integraciones esperan rutas y\ncodificaciones distintas. La nota registra esas diferencias e incluye comprobaciones con\ndispositivos. Una comprobación de los enlaces generados podría proteger la forma acordada para\ncada billetera. Un ensayo real permite observar si el navegador entrega el enlace a la aplicación\ninstalada y termina el recorrido. Cada prueba responde una pregunta distinta.\n\n## Dónde surgen los problemas\n\nUn contrato se vuelve rígido si exige que coincidan todos los bytes de una respuesta. Puede ser\nválido añadir un campo sin uso o cambiar el formato de un mensaje auxiliar. Exige un valor, un\norden o una unidad cuando el consumidor dependa de ellos o la especificación pública los\nestablezca. Deja que los aspectos accidentales puedan variar.\n\nLas pruebas también pierden valor si sortean la interfaz. Verificar un archivo de ejemplo escrito\na mano puede dejar sin ejecutar el código que genera la respuesta. Comprobar que el sustituto\ndevuelve un dato preparado tampoco demuestra que el consumidor pueda interpretarlo. Ejecuta el\ncódigo real de la parte que estás comprobando y registra qué dependencias se han sustituido.\n\nPor último, un único recorrido normal deja dudas sobre los datos ausentes, los identificadores\ndesconocidos y los clientes antiguos. Localiza los errores que el cliente sabe presentar y las\nversiones que el proveedor se compromete a admitir. Conserva pruebas de integración para ejercer\nel encaminamiento y la configuración. El contrato aporta una comprobación más rápida y enfocada\nque el equipo puede repetir ante cada cambio pertinente.\n\n## Lecturas adicionales\n\n- [Documentación de Pact sobre qué comprueban las pruebas de\n  contrato](https://docs.pact.io/#what-is-contract-testing)\n- [Comprobación de consumidores y proveedores en\n  Pact](https://docs.pact.io/getting_started/how_pact_works)\n- [Estados del proveedor en Pact](https://docs.pact.io/getting_started/provider_states)\n- [Especificación OpenAPI para describir interfaces\n  HTTP](https://spec.openapis.org/oas/latest.html)\n\n\u003chttps://engineer.company/es/glossary/contract-testing/\u003e\n","date_modified":"2026-11-19T19:18:49Z","description":"Cómo comprobar acuerdos entre componentes con un ejemplo de seguimiento de paquetes, estados del proveedor y versiones independientes.","formats":{"gemtext":"https://engineer.company/es/glossary/contract-testing/index.gmi","gopher":"https://engineer.company/es/glossary/contract-testing/gophermap","html":"https://engineer.company/es/glossary/contract-testing/","json":"https://engineer.company/es/glossary/contract-testing/index.json","markdown":"https://engineer.company/es/glossary/contract-testing/index.md","pdf":"https://engineer.company/es/glossary/contract-testing/index.pdf"},"kind":"page","language":"es","title":"¿Qué son las pruebas de contrato?","url":"https://engineer.company/es/glossary/contract-testing/","version":1}