Inicio>Recursos para la creación de sitios web>Datos del sitio web
Descargar

Selene: pruebas de navegador de interfaz de usuario web orientadas al usuario en Python

Descripción general de Selene

Selene es una biblioteca concisa y poderosa para escribir pruebas de interfaz de usuario del navegador en Python. Fue construido como un puerto pitónico del popular proyecto Selenide del mundo de Java. Selene ayuda a los desarrolladores a escribir pruebas legibles y mantenibles que "hablan" en inglés común, haciéndolos más fáciles de entender y compartir en todos los equipos.

La fuerza central de Selene es su API orientada a los usuarios, que abstrae la complejidad de trabajar con Selenium WebDriver. Las pruebas se pueden escribir utilizando una sintaxis simple y expresiva y características de soporte como elementos de evaluación perezosa, mecanismos de reintento automático para una espera implícita más inteligente de carga similar a AJAX. Con soporte de PageObject incorporado, permite la reutilización de los elementos web a través de widgets.

Tabla de contenido

  • Características principales
  • Versiones
    • Guía de migración
  • Requisitos previos
  • Instalación
  • Uso
    • Comienzo rápido
    • API central
    • API avanzada
  • Tutoriales
  • Ejemplos expandidos
  • Contribución
  • Colegio de cambios

Características principales

  • API orientada al usuario : escriba scripts de prueba en lenguaje natural con sintaxis simple que se lee como un inglés común.
  • Soporte de carga similar a AJAX : mecanismos de espera y reintento de espera inteligente inteligentes incorporados para manejar elementos web cargados dinámicamente.
  • PageObjects Support : Elementos de evaluación perezosa permite construir PageObjects componiendo elementos sobre selectores o By.* Locadores tipo tupla, lo que permite crear elementos reutilizables para diferentes componentes.
  • Lista extendida de las condiciones esperadas : la lista mucho más grande de condiciones, también conocida como Matchers que en el selenio sin procesar, permite implementar afirmaciones más legibles y concisas en las pruebas.
  • Lista extendida de comandos predefinidos en el elemento : reduce la necesidad de componer comandos personalizados con ActionChains .
  • Soporte fuera del cuadro de marcos y raíz de sombra .
  • Filtrado flexible de colecciones : permite crear localizadores compuestos que reducen la necesidad de selectores XPath complejos y da como resultado mensajes de error mucho más detallados que ayudan con el mantenimiento de las pruebas.
  • Mensajes de error muy detallados : tanto para acciones como para afirmaciones sobre elementos.
  • Gestión automática del controlador : maneja automáticamente la configuración del controlador del navegador y el desmontaje para ejecuciones rápidas y locales.
  • Altamente personalizable : los usuarios avanzados pueden configurar o extender Selene para requisitos específicos. Por ejemplo, puede personalizar sus propias plantillas selectivas. También puede personalizar las mismas opciones (por ejemplo, tiempo de espera) a través de la misma API en todos los niveles: 1) a nivel mundial; 2) en instancia específica del navegador; 3) en elemento específico o colección de elementos almacenados en una variable 4) para una acción o afirmación específica en el elemento.
  • Soporte para controladores locales y remotos : Selene admite una variedad de entornos, incluidos navegadores locales, configuraciones sin cabeza y servicios en la nube como Selenium Grid, de manera similar que Selenium lo admite, al proporcionar las opciones de conductor correspondientes.
  • Soporte multiplataforma : funciona con los controladores móviles o de escritorio de Web y Appium. Sin embargo, algunas opciones en config son específicas de la plataforma.

Versiones

Selene actualmente admite dos versiones principales:

  • Última versión recomendada de prelanzamiento (v2.0.0rc9) :

    • Versiones de Python: 3.8+
    • Soporte de selenio: >=4.12.0
    • Esta versión presenta una API mejorada, un mejor rendimiento y se recomienda para nuevos proyectos.
    • Aunque está en la etapa alfa/beta, refinando la API, mejorando la "migratabilidad" y las pruebas
    • La mayoría de los usuarios activos de Selene ya se actualizaron a 2.0 alfa/beta y lo han estado utilizando en producción durante los últimos 2 años
    • El único riesgo son los cambios de API, algunos comandos están en progreso de la deprecación y el cambio de nombre

  • Versión estable (v1.0.2) :

    • Versiones de Python: 2.7, 3.5, 3.6, 3.7
    • Soporte de selenio: <4.0.0
    • Use esta versión si su proyecto requiere compatibilidad con versiones de Python más antiguas.

Para la migración de v1.x a v2.x, siga la guía de migración.

Guía de migración

De 1.0.2 a 2.0.0rc<LATEST> :

  • Actualizar a Python 3.8+
  • Actualizar a Selene a 2.0.0rc<LATEST>
    • Reemplace el método collection.first() de .first() a .first
    • Asegúrese de que todas las condiciones como text('foo') usen el be.* O have.* Sintaxis
    • Actualizar otros métodos desaprobados según sea necesario

Ejemplos de refactorización potencial durante la migración:

  • encontrar y reemplazar todo
    • (text('foo')) a (have.text('foo'))
    • (visible) para (be.visible)
  • más inteligente buscar y reemplazar (con alguna refactorización manual)
    • .should(x, timeout=y) a .with_(timeout=y).should(x)
    • .should_not(be.*) para .should(be.not_.*) o .should(be.*.not_)
    • .should_not(have.*) para .should(have.no.*) o .should(have.*.not_)
    • .should_each(condition) para .should(condition.each)
  • y agregar las importaciones correspondientes: from selene import be, have

Requisitos previos

Se requiere Python 3.8+.

Dado que se instala pyenv, instalar la versión necesaria de Python es simple: 

$ pyenv install 3.8.13
$ pyenv global 3.8.13
$ python -V
Python 3.8.13

Instalación

Vía poesía + pyenv (recomendado)

Asegúrese de que se instalen poesía y pyenv, luego: 

poetry new my-tests-with-selene
cd my-tests-with-selene
pyenv local 3.8.13
poetry add selene --allow-prereleases  # for pre-release version
poetry install

a través de Pip

Para la versión previa a la liberación (recomendado para nuevos proyectos): 

pip install selene --pre

Para la última versión estable: 

pip install selene

de fuentes

Si prefiere instalar Selene directamente desde el código fuente: 

git clone https://github.com/yashaka/selene.git
cd selene
python setup.py install

O usar poesía: 

poetry add git+https://github.com/yashaka/selene.git

O usando PIP: 

pip install git+https://github.com/yashaka/selene.git

Uso

Comienzo rápido

Automatice una búsqueda simple de Google usando Selene: 

 from selene import browser , be , have

browser . open ( 'https://google.com/ncr' )
browser . element ( '[name=q]' ). should ( be . blank )
    . type ( 'selenium' ). press_enter ()
browser . all ( '#rso>div' ). should ( have . size_greater_than ( 5 ))
    . first . should ( have . text ( 'Selenium automates browsers' ))

# not mandatory, because will be closed automatically:
# browser.quit()

API central

  • Selene proporciona una API intuitiva para interactuar con elementos web que usan módulos como be , have o by .

  • Elementos perezosos y dinámicos: los elementos Selene son perezosos y dinámicos, lo que significa que se encuentran cada vez que se realiza una acción. Esto garantiza la interacción con el elemento más actualizado.

  • Aquí hay una interacción de elementos básicos: 

 from selene import browser , by , be

# because elements are "lazy",
# you can store them in variable:
search_box = browser . element ( by . name ( 'q' ))

# – even before the actual page will be loaded:
browser . open ( 'https://google.com/ncr' )
search_box . should ( be . blank ). type ( 'Selenium' ). press_enter ()

Selección de localizadores de elementos

Elegir los localizadores de elementos correctos es crucial para pruebas confiables. Aquí hay algunos consejos:

  1. Inspeccione el elemento: haga clic derecho en el elemento web y seleccione Inspeccione para ver su HTML en las herramientas de desarrollador del navegador.

  2. Use atributos únicos: busque atributos únicos como ID, nombre o atributos personalizados para usar en sus selectores. La mejor práctica es negociar con los desarrolladores sobre el uso data-* atributos específicamente para las necesidades de prueba, como data-test-id .

  3. Construya selectores CSS o XPATH: cree selectores que identifiquen de manera única elementos. Por ejemplo, utilizando Conciser CSS-Selectores #elementId , .className o [name="q"] , o usando XPATH para cosas que CSS no puede manejar: //*[text()="Submit"]/.. Selene detectará automáticamente si proporciona un selector CSS o XPath.

  4. Utilice los ayudantes selectores de Selene (opcional): si necesita la mayoría del código legible por humanos, puede usar by.name('q') , by.text('Submit') y otros ayudantes. by.* Observe que alguien preferiría el selector de CSS crudo como [name=q] by.name('q') con el propósito del principio de beso.

  5. Desglose los selectores largos en partes más pequeñas para una mejor legibilidad y capacidad de mantenimiento: si para encontrar un elemento tiene un selector complejo como en: browser.element('//*[@role="row" and contains(.,"Jon")]//*[@data-field="select-row"]') para las colecciones de selene para las colecciones de filtraciones de selene para las colecciones de selene para las colecciones de Selene para las colecciones de filtraciones de Selene para browser.all('[role=row]').element_by(have.text('Jon')).element('[data-field=select-row]') hará que sea más fácil de entender y mantener, porque si algo cambia en la estructura de la página, y su prueba falla, verá exactamente dónde falla entre las "partes descompuestas" del selector, mientras que en el caso de más tiempo, solo verá que solo verá en el que falla el lugar de la mitad de la mitad de la mitad de la mitad de la mitad de la mitad de la mitad de la mitad de la mitad de la selección. Selector con la siguiente necesidad de verificar cada doble razón de falla.

  6. Cree una estrategia selectora personalizada (opcional): imagine que sus desarrolladores frontend siguen las mejores prácticas y usan atributos de data-test-id para todos los elementos que deben cubrirse en las pruebas, y hay una convención de nombres seguida para que dicho elemento sea Snake_Case_or-KeBab-Case-Words. Con la opción de Selene's browser.config.selector_to_by_strategy , puede definir una estrategia selectora personalizada para detectar automáticamente todos los localizadores "snake_kebab-words" pasados ​​como selectores y transformarlos en [data-test-id="snake_kebab-words"] . Luego, un ejemplo como browser.all('[data-testid=result]').first.element('[data-testid=result-title-a]').click() puede simplificarse para browser.all('result').first.element('result-title-a').click() . ¿Vea cómo simplificar la búsqueda por IDS de prueba? Guía para más detalles.

    ❗ Esta característica estará disponible en el próximo lanzamiento de Selene. fue

Gestión automática de controladores y navegadores

Selene puede administrar automáticamente el controlador del navegador para usted, pero puede personalizarlo si es necesario.

Administración automática de controladores

  • Use la instancia de navegador predefinida sin crear manualmente un controlador: 
 from selene import browser

browser . config . base_url = 'https://google.com'
browser . config . timeout = 2

browser . open ( '/ncr' )

Configuración de controlador personalizado

  • Si necesita configuraciones de controladores personalizados, como usar un controlador remoto o agregar opciones, configure el controlador en consecuencia: 
 from selenium import webdriver
from selene import browser

options = webdriver . ChromeOptions ()
options . add_argument ( '--headless' )
# Add other options as needed

# Selene will automatically detect the browser type (Chrome, Firefox, etc.)
# based on the options passed
browser . config . driver_options = options
browser . config . driver_remote_url = 'http://localhost:4444/wd/hub'
browser . config . base_url = 'https://google.com'
browser . config . timeout = 2

browser . open ( '/ncr' )
  • Alternativamente, cree y asigne su propia instancia de controlador: 
 from selenium import webdriver
from selene import browser

options = webdriver . ChromeOptions ()
options . add_argument ( '--headless' )
# Add other options as needed

browser . config . driver = webdriver . Remote (
    command_executor = 'http://localhost:4444/wd/hub' ,
    options = options
)

browser . config . base_url = 'https://google.com'
browser . config . timeout = 2

browser . open ( '/ncr' )

Tutoriales

  • Selene: comienzo rápido
  • Selene en acción
  • Selene para PageObjects

Consejos para la automatización de pruebas efectivas

  • Use selectores legibles y estables: apunte a selectores que sean únicos, expresivos y mínimamente junto con la estructura DOM para que sus pruebas sean más mantenibles.

  • Componentes reutilizables de encapsulación: utilice el modelo de objeto de página para encapsular elementos y acciones, promoviendo la reutilización del código.

  • Aproveche la espera incorporada: Selene espera automáticamente a que los elementos estén en el estado deseado, reduciendo la necesidad de esperas explícitas.

  • Explore la API: sumérjase en el código fuente o documentación de Selene para comprender mejor los métodos y configuraciones disponibles.

Contribución

¡Agradecemos las contribuciones a Selene! Así es como puedes involucrarte:

  1. Bifurca el repositorio y clona localmente.
  2. Asegúrese de seguir el estilo y las convenciones del proyecto.
  3. Envíe una solicitud de extracción (PR) con una descripción clara de los cambios.

Para obtener más detalles, consulte nuestra Guía de contribución.

Colegio de cambios

Vea el ChangeLog para obtener más detalles sobre actualizaciones recientes.

Expandir
Información adicional
Aplicaciones relacionadas
Recomendado para ti
Información relacionada Todo