Common Issues

Quick fixes for common test issues.

---

Element Not Found

If an element isn't being found:

1. Add more context – Describe position or appearance

2. Scroll first – Element may be off-screen

3. Check exact text – Quoted text must match exactly

4. Wait for load – Add a wait step before locating

Example fix:

❌ Tap "Submit"

✅ Swipe up to view the submit button
✅ Tap the "Submit" button at the bottom of the form

---

Action Not Registering

If an action doesn't work:

1. Add a wait – UI may not be ready

2. Check for overlays – Dialogs, popups may block the element

3. Be more specific – Add color, position, or other context

Example fix:

❌ Tap "Login"

✅ Wait for 2 seconds
✅ Tap the blue "Login" button at the bottom

---

Timing Issues

If tests fail inconsistently:

1. Increase wait – Slow operations need more time

2. Add waits after animations – UI transitions take time

3. Wait before verification – Content must load first

Example fix:

❌ Tap "Submit"
❌ Verify success message displays

✅ Tap "Submit"
✅ Wait for 3 seconds
✅ Verify the success message displays

---

Cross-App Issues

If switching between apps fails:

1. Use explicit launch – Always use Launch [app name]

2. Add waits after launch – Apps need time to open

3. Return explicitly – Launch your app again after interacting with another

Example fix:

❌ Tap "Import Photo"
❌ Tap the first photo
❌ Verify photo is imported

✅ Tap "Import Photo"
✅ Launch the Gallery app
✅ Wait for 2 seconds
✅ Tap the first photo
✅ Tap "Select"
✅ Launch MyApp
✅ Wait for 2 seconds
✅ Verify the photo is displayed