Англійський словник для Detox Mobile Testing

Detox — це сірий блок end-to-end тестування фреймворку для React Native застосунків. Це дозволяє розробникам писати автоматизовані тести, які запускаються безпосередньо на симуляторі або пристрої, взаємодіючи з інтерфейсом так само, як і справжній користувач. Якщо ви працюєте з Detox і співпрацюєте англійською мовою, правильний словник допоможе вам написати чіткіші плани тестування, обговорити невдачі тестування і підтримати практику тестування у вашій команді.

Ключовий словник

Grey-box testing Тестування сірих скриньок відноситься до підходу до тестування, який має певний огляд внутрішньої роботи програми під час тестування, не маючи повного доступу до вихідного коду. Detox описується як grey-box, тому що він може контролювати внутрішній стан програми (наприклад, чи не зайнятий потік JavaScript) для надійної синхронізації тестових взаємодій.

• Приклад: “Подхід Detox з сірою коробкою означає, що він знає, коли програма готова до наступної взаємодії, що робить тести набагато більш надійними, ніж підходи, засновані на часі.” *

Синхронізація У Detox, синхронізація відноситься до здатності фрейму чекати, поки програма досягне стану бездіяльності перед виконанням наступної тестової дії. Це виключає необхідність ручних викликів sleep і робить тести більш стабільними.

• Приклад: « Detox обробляє синхронізацію автоматично — перед переходом до наступного запитання він чекає на завершення мережевих запитів і анімації. » *

• Схоже Відповідник — це запит, який визначає елемент інтерфейсу користувача у тесті Detox. Елементи можна знайти за їхнім ідентифікатором тестування, міткою доступності, текстовим вмістом або іншими атрибутами. Приклад: “Ми використовуємо атрибути testID на наших компонентах, щоб зробити їх легкими для цільового використання в Detox matchers.”

Акція Дія — це взаємодія з елементом інтерфейсу у тесті Detox, наприклад, натискання, переміщення пальцем, введення тексту або прокрутка. Дії застосовуються до елементів, знайдених за допомогою збігів.

• Приклад: « Після знаходження кнопки реєстрації за допомогою відповідника, ми застосовуємо дію натискання, щоб імітувати натискання користувачем цієї кнопки. » *

Ожидание Очікування — це твердження у тесті Detox, яке перевіряє, чи знаходиться інтерфейс користувача у очікуваному стані після виконання дії.

• Приклад: « Після надсилання форми, ми очікуємо, що на екрані буде показано повідомлення про успіх ». *

Поширені сценарії, де використовується ця мова

На встрече по планированию тестов: «Ми додаємо тести Detox для критичних подорожей користувачів — входу, входу і потоку покупок. Я почну з щасливого шляху для кожної подорожі, а потім ми додамо краї випадків у другому проході»

** При обговоренні тесту на лусочки: ** “Тест на детоксикацію checkout-flow неодноразово провалювався в ЦИ. Підозрюю, що це проблема синхронізації — тест взаємодіє з кнопкою оплати до того, як стан завантаження буде очищено. Я додам явне очікування на те, що елемент буде ввімкнено»

В обзоре кода: “Я помітив, що цей тест використовує sleep(2000) замість того, щоб дозволити Detox управляти синхронізацією. Ми повинні вилучити сон — Detox буде чекати автоматично, поки запит мережі завершиться»

** Під час налаштування Detox у новому проекті: ** «Достатньо правильно налаштувати Detox, щоб зробити певні зусилля — вам потрібно налаштувати налаштування тестового запуску, збудувати певний бінарний файл для тестування і налаштувати симулятор. Я можу поєднатися з вами, щоб отримати початкову настройку зроблено.”

Використовується для тестування криптосистем

• «Detox запускає тести end-to-end на реальному симуляторі, взаємодіючи з інтерфейсом, як це зробив би користувач»
• «Ми написали Detox тести для всіх наших критичних потоків користувачів — входу, входу і виходу»
• «Тест є неоднозначним — він провалюється приблизно один раз з десяти в CI. Я думаю, це проблема синхронізації»
• «Ми використовуємо testID реквізити на інтерактивних елементах, щоб зробити їх надійними в тестах»
• «Detox обробляє синхронізацію автоматично, тому нам не потрібні ручні затримки в наших тестах»
• «Порівнювач знаходить елемент за його testID, а потім ми застосовуємо до нього дію натискання»
• «Після дії, ми стверджуємо, що екран успіху видимий за допомогою очікування»
• «Detox тести повільні в порівнянні з тестами модулів — ми запускаємо їх тільки на запити pull до головної гілки.»
• «Ми використовуємо Detox в поєднанні з Maestro для деяких потоків — Detox для JavaScript-важких взаємодій, Maestro для простіших потоків інтерфейсу користувача»
• «The CI job runs the Detox tests on an iOS 17 simulator and an Android 14 emulator.» (англійською)

Запис описів тестів

Хороші описи тестів Detox допомагають команді зрозуміти, що тестується і чому невдача має значення. Використовуйте формат « даний/ коли/ тоді » або опис природньою мовою, який чітко визначає сценарій.

Слабкий: it('should work correctly') 10000000000000000♠0,0000000000000000000♠0,000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

Назва тесту повинна бути достатньо конкретною, щоб, якщо запуск CI зазнає невдачі, людина, яка переглядає звіт про помилку, негайно зрозуміла, що не працює і на яку поведінку користувача це впливає.

Під час написання коментаря, у якому пояснюється складне налаштування тесту, будьте чіткими: « Нам потрібно перейти до вікна параметрів перед цим тестом, оскільки функція, яку ми тестуємо, доступна лише з цього вікна. Блок beforeEach обробляє цю навігацію»

Практичні рекомендації

Пройдіться критичним шляхом користувача у мобільній програмі, якою ви регулярно користуєтесь, наприклад, створіть обліковий запис, надішліть повідомлення або зробіть покупку. Написати план тестування Detox англійською мовою (не код, а структурований опис простою мовою), який міститиме: мету тестування, попередні умови, покрокові дії користувача, які слід імітувати, твердження, які слід зробити після кожної дії, і всі відомі краї випадків для тестування. Такий тип документа планування тестів є цінним як для написання тестів, так і для перегляду їх з нетехнічними зацікавленими сторонами.

Навигація по лінії — практичний підхід

Погляньмо правді в очі, навіть з сильним розумінням концепцій Detox, таких як інструменти і взаємодія пристроїв, ефективне спілкування в команді розробників є ключовим. Часто нерозуміння виникають не з технічних труднощів, а з тонких відмінностей у тому, як ми виражаємо себе, особливо при обговоренні результатів тестів або запитів на зміни. Не-рідні носії англійської мови можуть знайти швидкий обмін зворотнім зв’язком особливо складним. Це більше, ніж просто точний опис того, що * сталося *; це про оформлення вашого запитання про ясність і продемонструвати активний підхід до вирішення проблем.

Розглянемо цей сценарій: Сара, молодший тестувальник мобільних додатків, помічає нерівний тест під час автоматичного запуску. Замість того, щоб просто сказати: «Цей тест не витримує», вона могла б надати багатший контекст. Ефективнішим підходом було б щось на зразок: «Я спостерігав періодичні невдачі в login_flow тесті Детокс. Здається, що він періодично перевищує час очікування — можливо, пов’ язано з затримкою мережі або неоднозначним станом пристрою. Я збираюся далі досліджувати, запускаючи його на декількох пристроях і зосереджуючись на початкових кроках налаштування. “Це демонструє, що Сара розуміє * чому * може статися невдача, показує ініціативу (дослідження) і чітко сформулює проблему. Аналогічно, коли ви отримуєте зворотній зв’язок від рецензента, замість того, щоб реагувати оборонно, спробуйте сформулювати свою відповідь з власником: “Дякую за вказівку на непослідовні дані в результатах тесту. Я розгляну інтеграцію джерела даних і забезпечу належну синхронізацію»

Інша поширена ситуація під час перегляду коду. Розробник може залишити коментар на зразок « Потрібно більш надійне оброблення помилок ». Краще було б сказати: « Чи не могли б ми додати блоки try- catch навколо мережевих запитів, щоб елегантно обробляти потенційні помилки? Це покращить стабільність тестування і надає більш чітку діагностичну інформацію, якщо щось не так». Друга фраза конструктивна, конкретна і пропонує чіткий шлях вперед. Пам’ятайте, що мета полягає не тільки в тому, щоб виправити негайну проблему, але і побудувати стійкість до ваших тестів - ключовий принцип мобільного тестування.

Нарешті, під час написання описів PR уникайте нечітких тверджень на зразок « Виправлено вади ». Замість цього будьте точні: « Впроваджено поліпшену логіку повторних спроб для викликів API у потоці payment_processing, щоб вирішити проблему переривчастих перевиконань часу очікування, спостережених під час тестування навантаження ». Це надає контекст і дозволяє рецензентам швидко зрозуміти обсяг змін.

Ось приклад використання Detox для діагностики тесту на лущення:

detox per-test run --preset=login_flow --tag=flaky

Ця команда спеціально призначена для набору login_flow, фільтрує тести з позначкою « flaky » і виконує їх окремо. Аналіз виводу (зазвичай, записаного у журнал консолі) дасть вам цінну інформацію щодо часу аварій, можливих станів пристроїв або станів мережі, які спричинили проблему. Перегляд цих журналів разом з налаштуваннями тестування надає важливі дані для розв’ язання проблем.