Saltar al contenido principal

Opciones de Métodos

Las opciones de métodos son las opciones que se pueden establecer por método. Si la opción tiene la misma clave que una opción que se ha establecido durante la instanciación del plugin, esta opción de método anulará el valor de la opción del plugin.

Opciones de Guardado​

disableBlinkingCursor​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: false
  • Soportado en: Web, Aplicación Híbrida (Webview)

Habilita/Deshabilita el "parpadeo" del cursor en todos los elementos input, textarea, [contenteditable] en la aplicación. Si se establece como true, el cursor se establecerá como transparent antes de tomar una captura de pantalla y se restablecerá cuando se complete

disableCSSAnimation​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: false
  • Soportado en: Web, Aplicación Híbrida (Webview)

Habilita/Deshabilita todas las animaciones CSS en la aplicación. Si se establece como true, todas las animaciones se deshabilitarán antes de tomar una captura de pantalla y se restablecerán cuando se complete

enableLegacyScreenshotMethod​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: false
  • Soportado en: Web, Aplicación Híbrida (Webview)

Utilice esta opción para volver al método de captura de pantalla "antiguo" basado en el protocolo W3C-WebDriver. Esto puede ser útil si sus pruebas dependen de imágenes de referencia existentes o si está ejecutando en entornos que no admiten completamente las capturas de pantalla basadas en BiDi más nuevas. Tenga en cuenta que habilitar esto puede producir capturas de pantalla con una resolución o calidad ligeramente diferentes.

enableLayoutTesting​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: false
  • Usado con: Todos los métodos
  • Soportado en: Web

Esto ocultará todo el texto en una página para que solo se utilice el diseño para la comparación. El ocultamiento se realizará añadiendo el estilo 'color': 'transparent !important' a cada elemento.

Para la salida, consulte Salida de Prueba

información

Al usar esta bandera, cada elemento que contiene texto (no solo p, h1, h2, h3, h4, h5, h6, span, a, li, sino también div|button|..) obtendrá esta propiedad. NO hay opción para personalizar esto.

hideScrollBars​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: true
  • Usado con: Todos los métodos
  • Soportado en: Web, Aplicación Híbrida (Webview)

Ocultar barra(s) de desplazamiento en la aplicación. Si se establece como true, todas las barras de desplazamiento se deshabilitarán antes de tomar una captura de pantalla. Esto está establecido por defecto como true para prevenir problemas adicionales.

hideElements​

  • Tipo: array
  • Obligatorio: no
  • Usado con: Todos los métodos
  • Soportado en: Web, Aplicación Híbrida (Webview), Aplicación Nativa

Este método puede ocultar 1 o múltiples elementos agregando la propiedad visibility: hidden a ellos proporcionando un array de elementos.

removeElements​

  • Tipo: array
  • Obligatorio: no
  • Usado con: Todos los métodos
  • Soportado en: Web, Aplicación Híbrida (Webview), Aplicación Nativa

Este método puede eliminar 1 o múltiples elementos agregando la propiedad display: none a ellos proporcionando un array de elementos.

resizeDimensions​

  • Tipo: object
  • Obligatorio: no
  • Predeterminado: { top: 0, right: 0, bottom: 0, left: 0}
  • Usado con: Solo para saveElement o checkElement
  • Soportado en: Web, Aplicación Híbrida (Webview), Aplicación Nativa

Un objeto que debe contener una cantidad de píxeles top, right, bottom y left que necesitan hacer que el recorte del elemento sea más grande.

userBasedFullPageScreenshot​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: false
  • Soportado en: Web, Aplicación Híbrida (Webview)

Cuando se establece como true, esta opción habilita la estrategia de desplazamiento y unión para capturar capturas de pantalla de página completa. En lugar de utilizar las capacidades nativas de captura de pantalla del navegador, se desplaza a través de la página manualmente y une múltiples capturas de pantalla. Este método es especialmente útil para páginas con contenido cargado de forma perezosa o diseños complejos que requieren desplazamiento para renderizarse completamente.

fullPageScrollTimeout​

El tiempo de espera en milisegundos después de un desplazamiento. Esto puede ayudar a identificar páginas con carga perezosa.

NOTA: Esto solo funciona cuando userBasedFullPageScreenshot está establecido como true

hideAfterFirstScroll​

Este método ocultará uno o varios elementos agregando la propiedad visibility: hidden a ellos proporcionando un array de elementos. Esto será útil cuando una página, por ejemplo, tiene elementos fijos que se desplazarán con la página si la página se desplaza pero dará un efecto molesto cuando se realice una captura de pantalla de página completa.

NOTA: Esto solo funciona cuando userBasedFullPageScreenshot está establecido como true

waitForFontsLoaded​

  • Tipo: boolean
  • Obligatorio: No
  • Predeterminado: true
  • Usado con: Todos los métodos
  • Soportado en: Web, Aplicación Híbrida (Webview)

Las fuentes, incluidas las fuentes de terceros, pueden cargarse de forma sincrónica o asincrónica. La carga asincrónica significa que las fuentes podrían cargarse después de que WebdriverIO determine que una página se ha cargado completamente. Para evitar problemas de renderizado de fuentes, este módulo, por defecto, esperará a que todas las fuentes se carguen antes de tomar una captura de pantalla.

Opciones de Comparación (Verificación)​

Las opciones de comparación son opciones que influyen en la forma en que se ejecuta la comparación, mediante ResembleJS.

NOTA
  • Todas las opciones de las Opciones de Guardado pueden usarse para los métodos de Comparación
  • Todas las opciones de comparación pueden usarse durante la instanciación del servicio o para cada método de verificación individual. Si una opción de método tiene la misma clave que una opción que se ha establecido durante la instanciación del servicio, entonces la opción de comparación del método anulará el valor de la opción de comparación del servicio.
  • Todas las opciones pueden usarse para:
    • Web
    • Aplicación Híbrida
    • Aplicación Nativa

ignoreAlpha​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Compara imágenes y descarta el alfa.

blockOutSideBar​

  • Tipo: boolean
  • Predeterminado: true
  • Obligatorio: no
  • Observación: Solo puede usarse para checkScreen(). Esto es solo para iPad

Bloquea automáticamente la barra lateral para iPads en modo horizontal durante las comparaciones. Esto evita fallos en el componente nativo de pestaña/privado/marcador.

blockOutStatusBar​

  • Tipo: boolean
  • Predeterminado: true
  • Obligatorio: no
  • Observación: Esto es solo para Móvil

Bloquea automáticamente la barra de estado y la barra de direcciones durante las comparaciones. Esto evita fallos por hora, wifi o estado de la batería.

blockOutToolBar​

  • Tipo: boolean
  • Predeterminado: true
  • Obligatorio: no
  • Observación: Esto es solo para Móvil

Bloquea automáticamente la barra de herramientas.

ignoreAntialiasing​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Compara imágenes y descarta el anti-aliasing.

ignoreColors​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Aunque las imágenes están en color, la comparación comparará 2 imágenes en blanco/negro

ignoreLess​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Compara imágenes con red = 16, green = 16, blue = 16, alpha = 16, minBrightness=16, maxBrightness=240

ignoreNothing​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Compara imágenes con red = 0, green = 0, blue = 0, alpha = 0, minBrightness=0, maxBrightness=255

rawMisMatchPercentage​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Si es true, el porcentaje devuelto será como 0.12345678, por defecto es 0.12

returnAllCompareData​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Esto devolverá todos los datos de comparación, no solo el porcentaje de diferencia

saveAboveTolerance​

  • Tipo: number
  • Predeterminado: 0
  • Obligatorio: no

Valor permitido de misMatchPercentage que evita guardar imágenes con diferencias

largeImageThreshold​

  • Tipo: number
  • Predeterminado: 0
  • Obligatorio: no

Comparar imágenes grandes puede provocar problemas de rendimiento. Al proporcionar un número para la cantidad de píxeles aquí (mayor que 0), el algoritmo de comparación omite píxeles cuando el ancho o alto de la imagen es mayor que largeImageThreshold píxeles.

scaleImagesToSameSize​

  • Tipo: boolean
  • Predeterminado: false
  • Obligatorio: no

Escala 2 imágenes al mismo tamaño antes de la ejecución de la comparación. Se recomienda encarecidamente habilitar ignoreAntialiasing e ignoreAlpha

Opciones de carpeta​

La carpeta de referencia y las carpetas de capturas de pantalla (actual, diff) son opciones que se pueden establecer durante la instanciación del plugin o método. Para establecer las opciones de carpeta en un método particular, pase las opciones de carpeta al objeto de opciones de métodos. Esto se puede usar para:

  • Web
  • Aplicación Híbrida
  • Aplicación 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'),
}

// Puedes usar esto para todos los métodos
await expect(
    await browser.checkFullPageScreen("checkFullPage", methodOptions)
).toEqual(0)

actualFolder​

  • Tipo: string
  • Obligatorio: no

Carpeta para la instantánea que se ha capturado en la prueba.

baselineFolder​

  • Tipo: string
  • Obligatorio: no

Carpeta para la imagen de referencia que se está utilizando para comparar.

diffFolder​

  • Tipo: string
  • Obligatorio: no

Carpeta para la diferencia de imagen renderizada por ResembleJS.

Welcome! How can I help?

WebdriverIO AI Copilot