xcuitest-docs

Provide an offline XCUITest API reference with examples for Swift UI testing.

299|16|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/vabole/apple-skills --skill xcuitest-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xcuitest-docs
Source: https://github.com/vabole/apple-skills/tree/main/skills/xcuitest
Command: npx skills add https://github.com/vabole/apple-skills --skill xcuitest-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This documentation consolidates XCUITest API references to reduce time spent searching official Apple docs and empower faster UI test development.

Core Features & Use Cases

  • API coverage for core XCUITest components such as XCUIApplication, XCUIElement, and XCUIElementQuery.
  • Practical usage guidance for waits, interactions, and element queries in Swift 6 UI tests.
  • Use Case: quickly locate elements, assert states, and capture screenshots during test runs.

Quick Start

Open a UI test target and start using XCUIApplication and XCUIElement APIs to write your first test.

Frequently Asked Questions about xcuitest-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write my first XCUITest UI test in Swift?

To write an XCUITest UI test, open a UI test target and use XCUIApplication to launch your app, then use XCUIElement APIs to locate elements and assert their states. This provides a centralized reference for Swift-based testing.

How do I wait for an element to appear in XCUITest?

XCUITest waits are handled through specific element expectation APIs to manage asynchronous UI updates. This reference provides practical usage guidance for waits, interactions, and element queries in Swift 6 UI tests.

Can I use XCUITest for macOS UI testing or is it iOS only?

XCUITest supports Swift-based UI testing across both iOS and macOS. It handles element queries, waits, coordinates, and permission dialogs for both platforms.

What is the best way to locate UI elements in XCUITest?

The best way to locate elements in XCUITest is using XCUIElementQuery to filter and identify UI components. This reference covers XCUIElementQuery and related types to help you quickly locate and interact with elements.

How do I handle permission dialogs during an XCUITest run?

XCUITest handles permission dialogs through specific system interaction APIs designed for automated UI testing. This reference includes practical guidance for managing these dialogs alongside core interactions and element queries.

Does this XCUITest reference include examples for capturing screenshots during test runs?

Yes, this XCUITest reference includes practical use cases for capturing screenshots during test runs. It provides centralized API examples for XCUIApplication, XCUIElement, and related types to support complete test workflows.