Opzioni dei Metodi
Le opzioni dei metodi sono le opzioni che possono essere impostate per ciascun metodo. Se l'opzione ha la stessa chiave di un'opzione che è stata impostata durante l'istanziazione del plugin, questa opzione del metodo sovrascriverà il valore dell'opzione del plugin.
Opzioni di Salvataggio
disableBlinkingCursor
- Tipo:
boolean
- Obbligatorio: No
- Predefinito:
false
- Supportato: Web, App Ibrida (Webview)
Abilita/Disabilita il "lampeggiamento" del cursore in tutti gli input
, textarea
, [contenteditable]
nell'applicazione. Se impostato su true
, il cursore sarà impostato su transparent
prima di scattare uno screenshot e ripristinato al termine
disableCSSAnimation
- Tipo:
boolean
- Obbligatorio: No
- Predefinito:
false
- Supportato: Web, App Ibrida (Webview)
Abilita/Disabilita tutte le animazioni CSS nell'applicazione. Se impostato su true
, tutte le animazioni saranno disabilitate prima di scattare uno screenshot e ripristinate al termine
enableLayoutTesting
- Tipo:
boolean
- Obbligatorio: No
- Predefinito:
false
- Usato con: Tutti i metodi
- Supportato: Web
Questo nasconderà tutto il testo in una pagina in modo che solo il layout venga utilizzato per il confronto. Il nascondimento sarà fatto aggiungendo lo stile 'color': 'transparent !important'
a ciascun elemento.
Per l'output vedi Test Output
Utilizzando questa flag, ogni elemento che contiene testo (quindi non solo p, h1, h2, h3, h4, h5, h6, span, a, li
, ma anche div|button|..
) riceverà questa proprietà. Non esiste un'opzione per personalizzare questo comportamento.
hideScrollBars
- Tipo:
boolean
- Obbligatorio: No
- Predefinito:
true
- Usato con: Tutti i metodi
- Supportato: Web, App Ibrida (Webview)
Nasconde la/le barra/e di scorrimento nell'applicazione. Se impostato a true, tutte le barre di scorrimento saranno disabilitate prima di scattare uno screenshot. È impostato a true
di default per prevenire problemi aggiuntivi.
hideElements
- Tipo:
array
- Obbligatorio: no
- Usato con: Tutti i metodi
- Supportato: Web, App Ibrida (Webview), App Nativa
Questo metodo può nascondere uno o più elementi aggiungendo la proprietà visibility: hidden
fornendo un array di elementi.
removeElements
- Tipo:
array
- Obbligatorio: no
- Usato con: Tutti i metodi
- Supportato: Web, App Ibrida (Webview), App Nativa
Questo metodo può rimuovere uno o più elementi aggiungendo la proprietà display: none
fornendo un array di elementi.
resizeDimensions
- Tipo:
object
- Obbligatorio: no
- Predefinito:
{ top: 0, right: 0, bottom: 0, left: 0}
- Usato con: Solo per
saveElement
ocheckElement
- Supportato: Web, App Ibrida (Webview), App Nativa
Un oggetto che deve contenere un numero di pixel top
, right
, bottom
e left
che devono rendere il ritaglio dell'elemento più grande.
fullPageScrollTimeout
- Tipo:
number
- Obbligatorio: No
- Predefinito:
1500
- Usato con: Solo per
saveFullPageScreen
osaveTabbablePage
- Supportato: Web
Il timeout in millisecondi da attendere dopo uno scorrimento. Questo può aiutare a identificare pagine con caricamento lazy.
hideAfterFirstScroll
- Tipo:
array
- Obbligatorio: no
- Usato con: Solo per
saveFullPageScreen
osaveTabbablePage
- Supportato: Web
Questo metodo nasconderà uno o più elementi aggiungendo la proprietà visibility: hidden
fornendo un array di elementi.
Questo sarà utile quando una pagina, ad esempio, contiene elementi sticky che scorrono con la pagina quando questa viene scorsa ma daranno un effetto fastidioso quando viene fatto uno screenshot a pagina intera
waitForFontsLoaded
- Tipo:
boolean
- Obbligatorio: No
- Predefinito:
true
- Usato con: Tutti i metodi
- Supportato: Web, App Ibrida (Webview)
I font, inclusi i font di terze parti, possono essere caricati in modo sincrono o asincrono. Il caricamento asincrono significa che i font potrebbero caricarsi dopo che WebdriverIO ha determinato che una pagina è stata completamente caricata. Per prevenire problemi di rendering dei font, questo modulo, per impostazione predefinita, attenderà che tutti i font siano caricati prima di scattare uno screenshot.
Opzioni di Confronto (Check)
Le opzioni di confronto sono opzioni che influenzano il modo in cui il confronto, di ResembleJS, viene eseguito.
- Tutte le opzioni dalle Opzioni di Salvataggio possono essere utilizzate per i metodi di Confronto
- Tutte le opzioni di confronto possono essere utilizzate durante l'istanziazione del servizio o per ogni singolo metodo di controllo. Se un'opzione del metodo ha la stessa chiave di un'opzione impostata durante l'istanziazione del servizio, l'opzione di confronto del metodo sovrascriverà il valore dell'opzione di confronto del servizio.
- Tutte le opzioni possono essere utilizzate per:
- Web
- App Ibrida
- App Nativa
ignoreAlpha
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Confronta le immagini e scarta l'alpha.
blockOutSideBar
- Tipo:
boolean
- Predefinito:
true
- Obbligatorio: no
- Nota: Può essere utilizzato solo per
checkScreen()
. Questo è solo per iPad
Blocca automaticamente la barra laterale per iPad in modalità orizzontale durante i confronti. Questo previene errori sul componente nativo tab/private/bookmark.
blockOutStatusBar
- Tipo:
boolean
- Predefinito:
true
- Obbligatorio: no
- Nota: Questo è solo per Mobile
Blocca automaticamente la barra di stato e la barra degli indirizzi durante i confronti. Questo previene errori su ora, wifi o stato della batteria.
blockOutToolBar
- Tipo:
boolean
- Predefinito:
true
- Obbligatorio: no
- Nota: Questo è solo per Mobile
Blocca automaticamente la barra degli strumenti.
ignoreAntialiasing
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Confronta le immagini e scarta l'anti-aliasing.
ignoreColors
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Anche se le immagini sono a colori, il confronto confronterà 2 immagini in bianco e nero
ignoreLess
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Confronta le immagini con red = 16, green = 16, blue = 16, alpha = 16, minBrightness=16, maxBrightness=240
ignoreNothing
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Confronta le immagini con red = 0, green = 0, blue = 0, alpha = 0, minBrightness=0, maxBrightness=255
rawMisMatchPercentage
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Se true la percentuale di ritorno sarà come 0.12345678
, di default è 0.12
returnAllCompareData
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Questo restituirà tutti i dati di confronto, non solo la percentuale di mancata corrispondenza
saveAboveTolerance
- Tipo:
number
- Predefinito:
0
- Obbligatorio: no
Valore ammissibile di misMatchPercentage
che impedisce il salvataggio delle immagini con differenze
largeImageThreshold
- Tipo:
number
- Predefinito:
0
- Obbligatorio: no
Il confronto di immagini di grandi dimensioni può portare a problemi di prestazioni.
Quando si fornisce un numero per il numero di pixel qui (maggiore di 0), l'algoritmo di confronto salta i pixel quando la larghezza o l'altezza dell'immagine è maggiore di largeImageThreshold
pixel.
scaleImagesToSameSize
- Tipo:
boolean
- Predefinito:
false
- Obbligatorio: no
Scala 2 immagini alla stessa dimensione prima dell'esecuzione del confronto. Altamente raccomandato abilitare ignoreAntialiasing
e ignoreAlpha
Opzioni delle cartelle
La cartella di base e le cartelle degli screenshot (attuale, differenza) sono opzioni che possono essere impostate durante l'istanziazione del plugin o del metodo. Per impostare le opzioni della cartella su un particolare metodo, passa le opzioni della cartella all'oggetto opzioni del metodo. Questo può essere utilizzato per:
- Web
- App Ibrida
- App Nativa
import path from 'node:path'
const methodOptions = {
actualFolder: path.join(process.cwd(), 'customActual'),
baselineFolder: path.join(process.cwd(), 'customBaseline'),
diffFolder: path.join(process.cwd(), 'customDiff'),
}
// Puoi usare questo per tutti i metodi
await expect(
await browser.checkFullPageScreen("checkFullPage", methodOptions)
).toEqual(0)
actualFolder
- Tipo:
string
- Obbligatorio: no
Cartella per lo snapshot catturato nel test.
baselineFolder
- Tipo:
string
- Obbligatorio: no
Cartella per l'immagine di base che viene utilizzata per il confronto.
diffFolder
- Tipo:
string
- Obbligatorio: no
Cartella per la differenza di immagine renderizzata da ResembleJS.