Aller au contenu principal

$

La commande $ est un moyen court et pratique pour récupérer un seul élément sur la page.

info

Contrairement à $ attaché à l'objet browser, cette commande interroge un élément basé sur un élément racine.

Vous pouvez également passer un objet comme sélecteur où l'objet contient une propriété element-6066-11e4-a52e-4f735466cecf avec la valeur d'une référence à un élément. La commande transformera alors la référence en un élément WebdriverIO étendu.

Remarque : enchaîner les commandes $ et $$ n'a de sens que lorsque vous utilisez plusieurs stratégies de sélection. Vous ferez sinon des requêtes inutiles qui ralentissent le test (par exemple, $('body').$('div') déclenchera deux requêtes alors que $('body div') fait littéralement la même chose avec une seule requête)

Vous pouvez enchaîner $ ou $$ sans envelopper les commandes individuelles dans await afin de parcourir l'arbre DOM, par exemple :

const imageSrc = await $$('div')[1].nextElement().$$('img')[2].getAttribute('src')

WebdriverIO traverse facilement les shadow roots lors de l'utilisation des commandes $ ou $$, quel que soit le niveau d'imbrication ou le mode shadow root, par exemple :

await browser.url('https://ionicframework.com/docs/usage/v8/datetime/basic/demo.html?ionic:mode=md')
await browser.$('button[aria-label="Sunday, August 4"]').click()
await browser.$('.aux-input').getValue()
info

Pour plus d'informations sur la sélection d'éléments spécifiques, consultez le guide Sélecteurs.

Utilisation
$(selector).$(selector)
Paramètres
NomTypeDétails
selectorString, Function, Matchersélecteur, fonction JS ou objet Matcher pour récupérer un certain élément
Exemples
example.html
loading...
singleElements.js
loading...
singleElements.js
loading...
singleElements.js
loading...
$.js
it('should use Androids DataMatcher or ViewMatcher selector', async () => {
const menuItem = await $({
"name": "hasEntry",
"args": ["title", "ViewTitle"],
"class": "androidx.test.espresso.matcher.ViewMatchers"
});
await menuItem.click();

const menuItem = await $({
"name": "hasEntry",
"args": ["title", "ViewTitle"]
});
await menuItem.click();
});
Retourne
  • <WebdriverIO.Element>

Welcome! How can I help?

WebdriverIO AI Copilot