Matcher Personalizzati
WebdriverIO utilizza una libreria di asserzioni expect in stile Jest che include funzionalità speciali e matcher personalizzati specifici per l'esecuzione di test web e mobile. Sebbene la libreria di matcher sia ampia, non è certo adatta a tutte le situazioni possibili. Pertanto, è possibile estendere i matcher esistenti con quelli personalizzati definiti da te.
Anche se attualmente non c'è differenza nel modo in cui vengono definiti i matcher specifici per l'oggetto browser o un'istanza element, questo potrebbe certamente cambiare in futuro. Tieni d'occhio webdriverio/expect-webdriverio#1408 per ulteriori informazioni su questo sviluppo.
Matcher Personalizzati per il Browser
Per registrare un matcher personalizzato per il browser, chiama extend sull'oggetto expect direttamente nel tuo file spec o come parte, ad esempio, dell'hook before nel tuo wdio.conf.js:
loading...
Come mostrato nell'esempio, la funzione matcher prende l'oggetto atteso, ad esempio l'oggetto browser o elemento, come primo parametro e il valore atteso come secondo. Puoi quindi utilizzare il matcher come segue:
loading...
Matcher Personalizzati per Elementi
Simili ai matcher personalizzati per il browser, i matcher per elementi non differiscono. Ecco un esempio di come creare un matcher personalizzato per verificare l'aria-label di un elemento:
loading...
Questo ti permette di chiamare l'asserzione come segue:
loading...
Supporto TypeScript
Se stai utilizzando TypeScript, è necessario un ulteriore passaggio per garantire la sicurezza dei tipi dei tuoi matcher personalizzati. Estendendo l'interfaccia Matcher con i tuoi matcher personalizzati, tutti i problemi di tipo scompaiono:
loading...
Se hai creato un matcher asimmetrico personalizzato, puoi allo stesso modo estendere i tipi expect come segue:
declare global {
namespace ExpectWebdriverIO {
interface AsymmetricMatchers {
myCustomMatcher(value: string): ExpectWebdriverIO.PartialMatcher;
}
}
}
