Uso del controlador de Internet Explorer para automatizar el modo IE en Microsoft Edge

Si tiene aplicaciones o sitios web heredados críticos para la empresa, es posible que tenga que probar el contenido en el modo Internet Explorer (IE) en Microsoft Edge. En este artículo se describe cómo empezar a trabajar con el controlador de Internet Explorer (IEDriver) para automatizar el modo IE en Microsoft Edge.

El modo IE en Microsoft Edge es una característica para las organizaciones que todavía necesitan Internet Explorer 11 para la compatibilidad con versiones anteriores para sitios web o aplicaciones heredados. Para obtener más información sobre el modo IE, lea ¿Qué es el modo Internet Explorer (IE)?

A partir del 15 de junio de 2022, Internet Explorer 11 ya no se admitirá en determinadas versiones de Windows 10. Para obtener más información, lea Preguntas más frecuentes sobre la retirada de aplicaciones de escritorio de Internet Explorer 11.

Descargar controlador de Internet Explorer (IEDriver)

Para empezar a automatizar las pruebas en modo IE en Microsoft Edge, descargue IEDriver. Asegúrese de que la versión de IEDriver que descargue sea 4.0.0.0 o mayor.

Configuración necesaria

Para configurar IEDriver, Windows y Microsoft Edge correctamente, complete los requisitos para la configuración necesaria de Selenium.

Colocar el archivo ejecutable del controlador en la ruta de acceso

El ejecutable del controlador debe colocarse en la ruta de acceso; consulte Servidor de controladores de IE. La parte superior de esa página dice: "El ejecutable del servidor independiente debe descargarse de la página Descargas y colocarse en la ruta de acceso".

Si la ubicación del controlador no está incluida en la ruta de acceso, debe establecer la ubicación del controlador mediante la propiedad webdriver.ie.driver del sistema Java o de alguna otra manera.

Automatización del modo IE en Microsoft Edge

Las secciones siguientes le guiarán por el uso de Selenium para automatizar el modo IE en Microsoft Edge.

En este artículo se proporcionan instrucciones para usar el marco de Selenium, pero puede usar cualquier biblioteca, marco y lenguaje de programación que admita WebDriver. Para realizar las mismas tareas con otro marco, consulte la documentación del marco de trabajo que prefiera.

Para iniciar Microsoft Edge en modo IE con IEDriver:

1. Defina InternetExplorerOptions con propiedades adicionales que apunten al explorador Microsoft Edge.

2. Inicie una instancia de InternetExplorerDriver y pásela InternetExplorerOptions. IEDriver inicia Microsoft Edge y, a continuación, carga el contenido web en modo IE.

En la sección siguiente se muestra el ejemplo completo y, a continuación, las secciones posteriores se centran en cada uno de los pasos principales que se enumeran anteriormente.

Ejemplo completo

En el ejemplo siguiente se inicia Microsoft Edge en modo IE, se navega a bing.com y, a continuación, se busca "WebDriver".

C#

using System;
using OpenQA.Selenium;
using OpenQA.Selenium.IE;

namespace IEDriverSample
{
    class Program
    {
        static void Main(string[] args)
        {
            var ieOptions = new InternetExplorerOptions();
            ieOptions.AttachToEdgeChrome = true;
            //change the path accordingly
            ieOptions.EdgeExecutablePath = "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe";

            var driver = new InternetExplorerDriver(ieOptions);
            driver.Url = "https://bing.com";
            driver.FindElement(By.Id("sb_form_q")).SendKeys("WebDriver");
            driver.FindElement(By.Id("sb_form")).Submit();

            driver.Quit();
        }
    }
}

Python

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys

ie_options = webdriver.IeOptions()
ie_options.attach_to_edge_chrome = True
ie_options.edge_executable_path = "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe"

driver = webdriver.Ie(options=ie_options)

driver.get("http://www.bing.com")
elem = driver.find_element(By.ID, 'sb_form_q')
elem.send_keys('WebDriver' + Keys.RETURN)

driver.quit()

Java

import org.openqa.selenium.By;
import org.openqa.selenium.Keys;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.ie.InternetExplorerDriver;
import org.openqa.selenium.ie.InternetExplorerOptions;

public class IEDriverSample {
    public static void main(String[] args) {        
        InternetExplorerOptions ieOptions = new InternetExplorerOptions();
        ieOptions.attachToEdgeChrome();
        ieOptions.withEdgeExecutablePath("C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe");
        
        WebDriver driver = new InternetExplorerDriver(ieOptions);

        driver.get("http://www.bing.com");
        WebElement elem = driver.findElement(By.id("sb_form_q"));
        elem.sendKeys("WebDriver", Keys.RETURN);

        driver.close();
    }
}

JavaScript

const {Builder, By, Key, until} = require('selenium-webdriver');
const {Options} = require('selenium-webdriver/ie');

(async () => {
  let ieOptions = new Options();
  ieOptions.setEdgeChromium(true);
  ieOptions.setEdgePath('C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe');

  let driver = await new Builder().
                         forBrowser('ie').
                         setIeOptions(ieOptions).
                         build();
  try {
    await driver.get('http://www.bing.com');
    let elem = await driver.findElement(By.id('sb_form_q'));
    await elem.sendKeys('WebDriver', Key.RETURN);
    await driver.wait(until.titleIs('WebDriver - Bing'), 1000);
  } finally {
    await driver.quit();
  }
})();

En las secciones siguientes se explican los pasos de este ejemplo con más detalle.

Definición de InternetExplorerOptions con propiedades adicionales para Microsoft Edge

Defina InternetExplorerOptions con propiedades adicionales que apunten al explorador Microsoft Edge.

C#

1. Defina una nueva variable, ieOptions, llamando a InternetExplorerOptions().

2. Establezca ieOptions.AttachToEdgeChrome la propiedad en truey ieOptions.EdgeExecutablePath en la ruta de acceso del archivo ejecutable de Microsoft Edge.

var ieOptions = new InternetExplorerOptions();
ieOptions.AttachToEdgeChrome = true;
//change the path accordingly
ieOptions.EdgeExecutablePath = "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe";

Python

1. Defina una nueva variable, ie_options, llamando a webdriver.IeOptions().

2. Establezca la ie_options.attach_to_edge_chrome propiedad en Truey ie_options.edge_executable_path en la ruta de acceso del archivo ejecutable de Microsoft Edge.

ie_options = webdriver.IeOptions()
ie_options.attach_to_edge_chrome = True
ie_options.edge_executable_path = "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe"

Java

1. Defina una nueva variable ieOptions de tipo InternetExplorerOptions, llamando a new InternetExplorerOptions().

2. Llame a ieOptions.attachToEdgeChrome() y ieOptions.withEdgeExecutablePath() con la ruta de acceso del ejecutable de Microsoft Edge.

InternetExplorerOptions ieOptions = new InternetExplorerOptions();
ieOptions.attachToEdgeChrome();
ieOptions.withEdgeExecutablePath("C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe");

JavaScript

1. Defina una nueva variable, ieOptions, llamando a Options().

2. Llame a ieOptions.setEdgeChromium() con el valor true y ieOptions.setEdgePath() con la ruta de acceso del archivo ejecutable de Microsoft Edge.

let ieOptions = new Options();
ieOptions.setEdgeChromium(true);
ieOptions.setEdgePath('C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe');

Iniciar IEDriver

Inicie IEDriver. IEDriver inicia Microsoft Edge y, a continuación, carga el contenido web en modo IE.

C#

Inícielo InternetExplorerDriver y páselo el definido ieOptionsanteriormente. IEDriver inicia Microsoft Edge en modo IE. Toda la navegación por páginas y las interacciones posteriores se producen en modo IE.

var driver = new InternetExplorerDriver(ieOptions);

Python

Inicie IEDriver llamando a webdriver.Ie y pasando el objeto definido ie_optionsanteriormente. IEDriver inicia Microsoft Edge en modo IE. Toda la navegación por páginas y las interacciones posteriores se producen en modo IE.

driver = webdriver.Ie(options=ie_options)

Java

Inicie IEDriver llamando a new InternetExplorerDriver() y pasando el objeto definido ieOptionsanteriormente. IEDriver inicia Microsoft Edge en modo IE. Toda la navegación por páginas y las interacciones posteriores se producen en modo IE.

WebDriver driver = new InternetExplorerDriver(ieOptions);

JavaScript

Inicie IEDriver llamando a Builder.forBrowser('ie') y setIeoptions(ieOptions). IEDriver inicia Microsoft Edge en modo IE. Toda la navegación por páginas y las interacciones posteriores se producen en modo IE.

let driver = await new Builder().
                       forBrowser('ie').
                       setIeOptions(ieOptions).
                       build();

Limitaciones conocidas

En esta sección se tratan escenarios conocidos que anteriormente funcionaban con IEDriver y la aplicación de escritorio IE11, pero que requieren soluciones alternativas al usar IEDriver con Microsoft Edge en modo IE.

Apertura de nuevas ventanas

Si el código de prueba crea una nueva ventana del explorador con uno de los métodos siguientes, es posible que tenga que agregar una operación de espera breve después para asegurarse de que IEDriver ha detectado la nueva ventana:

• Para abrir una nueva ventana, llame a window.open desde <script> en la página.
• Abrir una nueva ventana mediante el comando Nueva ventana de WebDriver.

Para asegurarse de que la nueva ventana se ha creado correctamente e IEDriver la ha detectado, debe comprobar continuamente el resultado del comando Obtener identificadores de ventana hasta que contenga un identificador para la nueva ventana.

En el ejemplo siguiente se muestra una posible manera de esperar a que se detecten nuevos identificadores de ventana al abrir nuevas ventanas.

C#

Después de llamar al Click método en un botón que abre una nueva ventana, el código de prueba debe esperar hasta driver.WindowHandles que contenga el nuevo identificador de ventana.

var initialHandleCount = driver.WindowHandles.Count;
driver.FindElement(By.Id("<Id of the button that will open a new window>")).Click();
var newHandles = driver.WindowHandles;
while (newHandles.Count == initialHandleCount)
{
    newHandles = driver.WindowHandles;
}

Python

Después de llamar al click método en un botón que abre una nueva ventana, el código de prueba debe esperar hasta driver.window_handles que contenga el nuevo identificador de ventana.

initial_handle_count = len(driver.window_handles)
driver.find_element(By.ID, "<Id of the button that will open a new window>").click()
new_handles = driver.window_handles
while len(new_handles) == initial_handle_count:
    new_handles = driver.window_handles

Java

Después de llamar al click método en un botón que abre una nueva ventana, el código de prueba debe esperar hasta driver.getWindowHandles() que contenga el nuevo identificador de ventana.

int initialHandleCount = driver.getWindowHandles().size();
driver.findElement(By.id("<Id of the button that will open a new window>")).click();        
Set<String> newHandles = driver.getWindowHandles();
while (newHandles.size() == initialHandleCount) {
    newHandles = driver.getWindowHandles();
}

JavaScript

Después de llamar al click método en un botón que abre una nueva ventana, IEDriver debe esperar con await driver.getAllWindowHandles().

const initialHandleCount = (await driver.getAllWindowHandles()).length;
const elem = await driver.findElement(By.id("<Id of the button that will open a new window>"));
await elem.click();
let newHandles = await driver.getAllWindowHandles();
while (newHandles.length == initialHandleCount) {
    newHandles = await driver.getAllWindowHandles();
}

Creación y cambio entre pestañas

Si el código de prueba cambia entre varias pestañas de la misma ventana de Microsoft Edge, es posible que las pestañas que se inactivan no se incluyan en la lista de identificadores devueltos por Obtener identificadores de ventana. En la aplicación de escritorio de Internet Explorer 11, IEDriver devolverá identificadores para todas las pestañas de IE, independientemente del estado de activación.

Al usar Microsoft Edge en modo IE, si la prueba cambia el foco de una pestaña determinada y desea poder volver a esa pestaña más adelante, debe almacenar una copia del identificador de ventana de la pestaña.

Vea también

• Uso de WebDriver para automatizar Microsoft Edge : información general sobre la automatización de Microsoft Edge con el protocolo WebDriver.
• Documentación de Selenium : información sobre WebDriver en el contexto de Selenium y cómo escribir pruebas automatizadas de WebDriver mediante Selenium.
• Póngase en contacto con el equipo de Microsoft Edge DevTools para enviar comentarios sobre el uso de WebDriver, marcos de pruebas de WebDriver (como Selenium) y Microsoft Edge.