click

Cliquer sur un élément.

Cette commande exécute une commande WebDriver click pour l'élément sélectionné, qui généralement fait défiler jusqu'à l'élément puis clique dessus quand aucune option n'est passée. Lorsqu'un objet d'options est passé, elle utilise la classe d'action au lieu du clic WebDriver, ce qui offre des capacités supplémentaires comme le passage du type de bouton, des coordonnées, etc. Par défaut, lors de l'utilisation des options, une commande d'action de relâchement est envoyée après l'exécution de l'action de clic; passez option.skipRelease=true pour ignorer cette action.

info

Si vous avez des éléments à position fixe (comme un en-tête ou un pied de page fixe) qui recouvrent l'élément sélectionné après son défilement dans la fenêtre d'affichage, le clic sera émis aux coordonnées indiquées, mais sera reçu par votre élément fixe (superposé). Dans ces cas, l'erreur suivante est générée :

Element is not clickable at point (x, x). Other element would receive the click: ..."

Pour contourner ce problème, essayez de trouver l'élément superposé et de le supprimer via la commande execute afin qu'il n'interfère pas avec le clic. Vous pouvez également essayer de faire défiler vous-même jusqu'à l'élément en utilisant scroll avec un décalage approprié à votre scénario.

info

La commande de clic peut également être utilisée pour simuler un appui prolongé sur un appareil mobile. Cela se fait en définissant la duration. Voir l'exemple ci-dessous pour plus d'informations.

Utilisation

$(selector).click({ button, x, y, skipRelease, duration })

Paramètres

Nom	Type	Détails
options optionnel	ClickOptions	Options de clic (optionnel)
options.button optionnel	string, number	Peut être l'un des [0, "left", 1, "middle", 2, "right"] WEB UNIQUEMENT (Desktop/Mobile)
options.x optionnel	number	Clique à X pixels horizontalement de l'emplacement de l'élément (depuis le point central de l'élément) WEB et Natif (Desktop/Mobile)
options.y optionnel	number	Clique à Y pixels verticalement de l'emplacement de l'élément (depuis le point central de l'élément) Support WEB et Natif (Desktop/Mobile)
options.skipRelease optionnel	boolean	Booléen (optionnel) WEB UNIQUEMENT (Desktop/Mobile)
options.duration optionnel	number	Durée du clic, aussi appelé "LongPress" APPLICATIONS NATIVES MOBILES UNIQUEMENT (Mobile)

Exemples

example.html

<button id="myButton" onclick="document.getElementById('someText').innerHTML='I was clicked'">Click me</button>
<div id="someText">I was not clicked</div>

click.js

it('should demonstrate the click command', async () => {
    const myButton = await $('#myButton')
    await myButton.click()
    const myText = await $('#someText')
    const text = await myText.getText()
    assert(text === 'I was clicked') // true
})

example.js

it('should fetch menu links and visit each page', async () => {
    const links = await $$('#menu a')
    await links.forEach(async (link) => {
        await link.click()
    })
})

example.html

<button id="myButton">Click me</button>

example.js

it('should demonstrate a click using an offset', async () => {
    const myButton = await $('#myButton')
    await myButton.click({ x: 30 }) // clicks 30 horizontal pixels away from location of the button (from center point of element)
})

example.html

<button id="myButton">Click me</button>

example.js

it('should demonstrate a right click passed as string', async () => {
    const myButton = await $('#myButton')
    await myButton.click({ button: 'right' }) // opens the contextmenu at the location of the button
})
it('should demonstrate a right click passed as number while adding an offset', async () => {
    const myButton = await $('#myButton')
    await myButton.click({ button: 2, x: 30, y: 40 }) // opens the contextmenu 30 horizontal and 40 vertical pixels away from location of the button (from the center of element)
})
it('should skip sending releaseAction command that cause unexpected alert closure', async () => {
    const myButton = await $('#myButton')
    await myButton.click({ button: 2, x: 30, y: 40, skipRelease:true }) // skips sending releaseActions
})

longpress.example.js

it('should be able to open the contacts menu on iOS by executing a longPress', async () => {
    const contacts = await $('~Contacts')
    // opens the Contacts menu on iOS where you can quickly create
    // a new contact, edit your home screen, or remove the app
    await contacts.click({ duration: 2000 })
})