{"canonical_url":"https://engineer.company/uk/glossary/contract-testing/","content_markdown":"# Контрактне тестування\n\n## Що це таке\n\nКонтрактне тестування перевіряє, чи узгоджено очікування двох компонентів щодо запитів,\nвідповідей або повідомлень. Екран відстеження посилок і сервіс можуть працювати окремо. Екран усе\nодно не впорається, якщо очікує поле `status`, а сервіс поверне `state`. Перевірка інтерфейсу\nописує, чим користується екран, і встановлює, що сервіс може це надати.\n\nPact описує підхід, за якого споживач працює з керованою заміною постачальника. Тест записує\nвзаємодії до контракту. Постачальник перевіряє їх через власну реалізацію за певних умов. Для\nобміну повідомленнями перевіряють повідомлення, яке одна сторона створює, а інша читає. Сторони\nможуть розвиватися й випускати версії незалежно, коли докази стосуються саме версій, що\nпрацюватимуть разом.\n\nТакож цей термін може означати перевірку постачальника за його опублікованим описом інтерфейсу,\nнаприклад документом OpenAPI. Це доречно, якщо специфікація є спільною домовленістю. Вона\nвизначає поля, коди стану та припустимі значення. Приклади споживача додатково показують, які їх\nпоєднання використовує певний клієнт і на що він покладається. Обидва методи можна поєднати.\nНаскрізний тест справжньої інтеграції також перевіряє маршрутизацію, доступ і налаштування\nсередовища.\n\n## Чому це важливо\n\nІнтерфейс часто існує довше, ніж його перша реалізація. Команда сервісу може перейменувати поле й\nоновити свої тести, не зачепивши клієнт в іншому проєкті. Мобільний застосунок здатен працювати\nкілька місяців у старій версії. Навіть проста зміна типу важлива, якщо поле визначає показаний\nтекст. Контракт, який можна перевірити, робить залежність видимою до випуску.\n\nКоли версії випускають у різний час, потрібно знати, які з них сумісні. Старий клієнт може\nрозуміти лише кілька станів, а сервісу вже потрібен проміжний. Команди можуть спочатку\nпідготувати клієнт, приймати обидві форми під час переходу й прибрати стару лише тоді, коли її не\nвикористовують підтримувані версії. Безпечний порядок залежить від контрактів, фактичного\nвикористання та правил випуску. Результат для нової пари не доводить сумісності зі старими\nклієнтами.\n\nУ тесті варто описувати важливі домовленості. Якщо придатний будь-який правильно оформлений\nномер, перевірте формат і не фіксуйте значення прикладу. Якщо поле визначає текст для людини,\nважливі тип і зрозумілі клієнту значення. За потреби команда може погодити поведінку для\nнезнайомого значення, наприклад повідомлення «стан недоступний», яке лишає решту сторінки\nпридатною до роботи.\n\n## Як це виглядає на практиці\n\nУявімо застосунок відстеження посилок. Він запитує посилку за номером. Якщо вона існує і прямує\nдо адресата, екран очікує успішну відповідь, номер і текстове значення, яке перетворює на\nпозначку «в дорозі». Для невідомого номера екран очікує іншу відповідь і пропонує перевірити\nвведене значення. Для кожної взаємодії потрібна передумова, наприклад існування посилки в дорозі\nабо відсутність потрібного запису.\n\nЗапустіть реальний код запиту споживача проти визначеної заміни. Перевірте результат, який бачить\nлюдина. Потім відтворіть ті самі взаємодії через шлях формування відповіді постачальника.\nПідготуйте передбачувані дані й відновіть їх між спробами. Якщо тест підміняє базу або\nстороннього перевізника, залиште в перевірці розбір запиту, логіку сервісу і формування\nвідповіді, від якої залежить споживач.\n\nТимчасово замініть `status` на `state`, не змінюючи клієнт. Перевірка має показати, якого поля не\nвистачає і якої взаємодії це стосується. Додаткове необов’язкове поле, яке клієнт ігнорує, може\nбути дозволене. Прив’яжіть перевірку до точних версій. Якщо поєднати результати нового сервісу з\nневідомим старим зразком, незрозуміло, що саме перевірено.\n\nУ [нотатці про відкриття застосунків у мобільних гаманцях\nSolana](/uk/notes/solana-mobile-wallet-deeplinks/) описано інтеграції з різними шляхами посилань\nі правилами кодування параметрів. Перевірка сформованих адрес може захистити узгоджену форму для\nкожного гаманця. Реальний пристрій показує, чи передає браузер посилання встановленому застосунку\nі чи завершується шлях. Нотатка документує різницю та пропонує перевірки на пристроях.\n\n## Де виникають проблеми\n\nКонтракт може стати надто жорстким, коли кожний байт має відповідати одному збереженому прикладу.\nПостачальник може мати право додати невживане поле або інакше відформатувати повідомлення.\nВимагайте порядку, точного тексту або одиниць там, де цього потребує клієнт чи специфікація.\n\nТест втрачає цінність, якщо обходить справжню межу. Рукописний об’єкт JSON може не запустити код\nформування відповіді. Заміна видасть очікуваний приклад навіть тоді, коли клієнт неправильно\nчитає його в реальному процесі. Виконайте код запиту або відповіді для сторони, яку перевіряєте,\nі зафіксуйте замінені залежності.\n\nПрипустімо, клієнт не розпізнає новий стан посилки. Можна спочатку навчити його показувати\nзагальне повідомлення, а згодом додати нову відповідь сервісу. Перед зміною перевірте, які версії\nвстановлено і що вони роблять із новим значенням. Випуск нової версії ще не означає, що всі\nкористувачі її отримали.\n\nОдин успішний випадок мало каже про відсутні дані, невідомі номери чи старі версії. Врахуйте\nпомилки, які клієнт уміє обробляти, і сумісність, яку постачальник обіцяє. Збережіть інтеграційні\nтести налаштувань і маршрутизації. Контракт дає швидший, зосереджений доказ для відповідних змін.\n\n## Що почитати далі\n\n- [Документація Pact про контрактне тестування](https://docs.pact.io/#what-is-contract-testing)\n- [Як Pact перевіряє споживача й\n  постачальника](https://docs.pact.io/getting_started/how_pact_works)\n- [Документація Pact про стани\n  постачальника](https://docs.pact.io/getting_started/provider_states)\n- [Специфікація OpenAPI для опису інтерфейсів HTTP](https://spec.openapis.org/oas/latest.html)\n\n\u003chttps://engineer.company/uk/glossary/contract-testing/\u003e\n","date_modified":"2026-11-19T19:18:49Z","description":"Як контрактне тестування перевіряє вимоги до інтерфейсу між компонентами на прикладі відстеження посилки й незалежного випуску версій.","formats":{"gemtext":"https://engineer.company/uk/glossary/contract-testing/index.gmi","gopher":"https://engineer.company/uk/glossary/contract-testing/gophermap","html":"https://engineer.company/uk/glossary/contract-testing/","json":"https://engineer.company/uk/glossary/contract-testing/index.json","markdown":"https://engineer.company/uk/glossary/contract-testing/index.md","pdf":"https://engineer.company/uk/glossary/contract-testing/index.pdf"},"kind":"page","language":"uk","title":"Що таке контрактне тестування?","url":"https://engineer.company/uk/glossary/contract-testing/","version":1}