---
title: XCUIDevice
framework: xcuiautomation
role: symbol
role_heading: Class
path: xcuiautomation/xcuidevice
---

# XCUIDevice

A proxy that can simulate physical buttons, device orientation, and Siri interaction for an iOS, watchOS, or tvOS device.

## Declaration

```swift
@MainActor class XCUIDevice
```

## Overview

Overview Use the XCUIDevice shared instance to perform the following interactions with a simulated iOS, watchOS, or tvOS device during a UI test: Press the volume, home, camera, and action buttons. Rotate the device. Turn the Digital Crown on a watchOS device. Determine whether the iOS device supports pointer interaction. Activate Siri. This example shows a test that determines whether the action button is available on the shared device and, if it is, simulates pressing the button: @MainActor func testPressingActionButton() throws {     let device = XCUIDevice.shared     try XCTSkipUnless(device.hasHardwareButton(.action),                   "The device doesn't have an action button.")     let app = XCUIApplication()     app.launch()     device.press(.action)     // Assert that your app responds correctly. } XCUIDevice is available in iOS, watchOS, and tvOS.

## Topics

### Accessing the current device

- [shared](xcuiautomation/xcuidevice/shared.md)
- [supportsPointerInteraction](xcuiautomation/xcuidevice/supportspointerinteraction.md)
- [supportsHandGestures](xcuiautomation/xcuidevice/supportshandgestures.md)

### Interacting with buttons and the Digital Crown

- [press(_:)](xcuiautomation/xcuidevice/press(_:).md)
- [hasHardwareButton(_:)](xcuiautomation/xcuidevice/hashardwarebutton(_:).md)
- [XCUIDevice.Button](xcuiautomation/xcuidevice/button.md)
- [rotateDigitalCrown(delta:)](xcuiautomation/xcuidevice/rotatedigitalcrown(delta:).md)
- [rotateDigitalCrown(delta:velocity:)](xcuiautomation/xcuidevice/rotatedigitalcrown(delta:velocity:).md)

### Performing gestures

- [perform(handGesture:)](xcuiautomation/xcuidevice/perform(handgesture:).md)
- [XCUIDeviceHandGesture](xcuiautomation/xcuidevicehandgesture.md)

### Rotating and changing location

- [orientation](xcuiautomation/xcuidevice/orientation.md)
- [location](xcuiautomation/xcuidevice/location.md)
- [XCUILocation](xcuiautomation/xcuilocation.md)

### Interacting with the OS

- [system](xcuiautomation/xcuidevice/system.md)
- [appearance](xcuiautomation/xcuidevice/appearance-swift.property.md)
- [XCUIDevice.Appearance](xcuiautomation/xcuidevice/appearance-swift.enum.md)

### Interacting with Siri

- [siriService](xcuiautomation/xcuidevice/siriservice.md)

### Deprecated

- [init()](xcuiautomation/xcuidevice/init().md)

### Instance Properties

- [voiceOverService](xcuiautomation/xcuidevice/voiceoverservice.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [Sendable](swift/sendable.md)

## See Also

### Device simulation

- [XCUISystem](xcuiautomation/xcuisystem.md)
- [XCUISiriService](xcuiautomation/xcuisiriservice.md)