---
title: "Toucher un élément dans un test smartphone"
sidebarTitle: "Toucher"
description: Appuyer sur un élément de l'application, localisé par selector, description IA ou coordonnées d'écran.
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Appuyez sur un élément à l'écran : un bouton, un élément de liste, un onglet. Localisez-le avec un selector XPath ou une description IA, ou passez le step en mode **Coordinates** pour appuyer sur une position X/Y exacte lorsqu'aucun élément ne peut être ciblé.

## Paramètres

| Paramètre | Requis | Description |
| ----------- | -------- | ------------- |
| Élément cible | Oui en mode Selector, sauf si un selector manuel est défini | Description en langage naturel de l'élément. L'IA l'utilise pour trouver l'élément. |
| Selector manuel | Non | Selector XPath dans l'arbre UI de l'application, utilisé lorsque l'IA est désactivée ou comme selector enregistré. |
| Approche | Non | `0` = Selector (par défaut), `1` = Coordinates. Basculez dans le panneau de détails du step. |
| Position X, Position Y | Oui en mode Coordinates | Position à l'écran pour le tap, en pixels depuis le coin supérieur gauche. |
| Utilisation de l'IA | Non | `smart` (par défaut), `always` ou `inherit`. |
| Activer l'IA | Non | Par défaut : désactivé. Activez-le pour localiser l'élément à partir de la description. |
| Ignorer l'erreur sur ce step | Non | L'exécution continue avec le step suivant si celui-ci échoue. Par défaut : désactivé. |

## Résultats et métriques

- **Timing** : début, fin et durée (en secondes) enregistrés dans le résultat du step.
- **Statut** : succès, avertissement ou échec, avec le message d'erreur en cas d'échec.
- **Capture d'écran** : prise après le tap, montrant l'écran résultant.
- **Utilisation de l'IA** : si l'IA a localisé l'élément, le selector corrigé est enregistré sur le test et le coût IA est ajouté à l'exécution.

## Et ensuite ?

<Columns cols={2}>
  <Card title="Long press" icon="hand-pointer" href="/fr/tests/actions/smartphone/longpress">

    Maintenir l'appui pour ouvrir les actions contextuelles

</Card>
  <Card title="Verify element" icon="eye" href="/fr/tests/actions/smartphone/verifyelement">

    Vérifier le résultat du tap avant de continuer

</Card>
</Columns>