From bf70971dbc323340009a0d392933eab2e72e44dd Mon Sep 17 00:00:00 2001 From: Afranio Alves Date: Tue, 24 Oct 2023 21:11:09 +0000 Subject: [PATCH 1/5] chore: Translate IE Driver Server to Portuguese --- .../ie_driver_server/_index.pt-br.md | 321 +++++++++--------- 1 file changed, 160 insertions(+), 161 deletions(-) diff --git a/website_and_docs/content/documentation/ie_driver_server/_index.pt-br.md b/website_and_docs/content/documentation/ie_driver_server/_index.pt-br.md index 568be580486c..602f4fcdef24 100755 --- a/website_and_docs/content/documentation/ie_driver_server/_index.pt-br.md +++ b/website_and_docs/content/documentation/ie_driver_server/_index.pt-br.md @@ -1,184 +1,183 @@ --- -title: "IE Driver Server" -linkTitle: "IE Driver Server" +title: "Servidor de drivers do IE" +linkTitle: "Servidor de drivers do IE" weight: 8 description: > - The Internet Explorer Driver is a standalone server that implements the WebDriver specification. + O Internet Explorer Driver é um servidor autónomo que implementa a especificação WebDriver. --- -This documentation previously located [on the wiki](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver-Internals) +Esta documentação estava anteriormente localizada [on the wiki](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver-Internals) -The `InternetExplorerDriver` is a standalone server which implements WebDriver's wire protocol. -This driver has been tested with IE 11, and on Windows 10. It might work with older versions -of IE and Windows, but this is not supported. +O `InternetExplorerDriver` é um servidor autónomo que implementa o protocolo wire do WebDriver. +Este driver foi testado com o IE 11 e no Windows 10. Ele pode funcionar com versões mais antigas +do IE e do Windows, mas isso não é suportado. -The driver supports running 32-bit and 64-bit versions of the browser. The choice of how to -determine which "bit-ness" to use in launching the browser depends on which version of the -IEDriverServer.exe is launched. If the 32-bit version of `IEDriverServer.exe` is launched, -the 32-bit version of IE will be launched. Similarly, if the 64-bit version of -IEDriverServer.exe is launched, the 64-bit version of IE will be launched. +O controlador suporta a execução de versões de 32 e 64 bits do browser. A escolha de como +determinar qual o "bit-ness" a utilizar no lançamento do browser depende de qual a versão do +IEDriverServer.exe é lançada. Se a versão de 32 bits do `IEDriverServer.exe` for iniciada, +a versão de 32 bits do IE será iniciada. Da mesma forma, se a versão de 64 bits do +IEDriverServer.exe for iniciada, a versão de 64 bits do IE será iniciada. -## Installing +## Instalação -You do not need to run an installer before using the `InternetExplorerDriver`, though some -configuration is required. The standalone server executable must be downloaded from -the [Downloads](https://www.selenium.dev/downloads/) page and placed in your -[PATH](http://en.wikipedia.org/wiki/PATH_(variable)). +Não é necessário executar um instalador antes de usar o `InternetExplorerDriver`, embora seja necessária alguma +configuração seja necessária. O executável do servidor standalone deve ser baixado da página +da página [Downloads](https://www.selenium.dev/downloads/) e colocado no seu +[PATH](http://en.wikipedia.org/wiki/PATH_(variável)). ## Pros -* Runs in a real browser and supports JavaScript +* Funciona num browser real e suporta JavaScript ## Cons -* Obviously the InternetExplorerDriver will only work on Windows! -* Comparatively slow (though still pretty snappy :) +* Obviamente, o InternetExplorerDriver só funciona no Windows! +* Comparativamente lento (embora ainda bastante rápido :) ## Command-Line Switches -As a standalone executable, the behavior of the IE driver can be modified through various -command-line arguments. To set the value of these command-line arguments, you should -consult the documentation for the language binding you are using. The command line -switches supported are described in the table below. All -``, --`` -and /`` are supported. +Como um executável autónomo, o comportamento do controlador IE pode ser modificado através de vários +argumentos de linha de comando. Para definir o valor destes argumentos da linha de comandos, deve +consultar a documentação do language binding que está a utilizar. As opções de linha de comando +suportadas são descritas na tabela abaixo. Todas as opções -``, --`` +e /`` são suportados. -| Switch | Meaning | +| Switch | Significado | |:-------|:--------| -| --port=`` | Specifies the port on which the HTTP server of the IE driver will listen for commands from language bindings. Defaults to 5555. | -| --host=`` | Specifies the IP address of the host adapter on which the HTTP server of the IE driver will listen for commands from language bindings. Defaults to 127.0.0.1. | -| --log-level=`` | Specifies the level at which logging messages are output. Valid values are FATAL, ERROR, WARN, INFO, DEBUG, and TRACE. Defaults to FATAL. | -| --log-file=`` | Specifies the full path and file name of the log file. Defaults to stdout. | -| --extract-path=`` | Specifies the full path to the directory used to extract supporting files used by the server. Defaults to the TEMP directory if not specified. | -| --silent | Suppresses diagnostic output when the server is started. | +| Especifica a porta na qual o servidor HTTP do driver IE escutará os comandos das associações de idioma. O padrão é 5555. | +| Especifica o endereço IP do adaptador de anfitrião no qual o servidor HTTP do controlador IE irá escutar os comandos das Language Bindings. O padrão é 127.0.0.1. | +| --log-level=`` | Especifica o nível em que as mensagens de registo são emitidas. Os valores válidos são FATAL, ERROR, WARN, INFO, DEBUG e TRACE. O padrão é FATAL. | +| --log-file=`` | Especifica o caminho completo e o nome do arquivo de log. O padrão é stdout. | +| --extract-path=`` | Especifica o caminho completo para o diretório usado para extrair arquivos de suporte usados pelo servidor. O padrão é o diretório TEMP se não for especificado. | +| --silent | Suprime a saída de diagnóstico quando o servidor é iniciado. | -## Important System Properties +## Propriedades importantes do sistema -The following system properties (read using `System.getProperty()` and set using -`System.setProperty()` in Java code or the "`-DpropertyName=value`" command line flag) -are used by the `InternetExplorerDriver`: +As seguintes propriedades do sistema (lidas usando `System.getProperty()` e definidas usando +`System.setProperty()` no código Java ou o sinalizador de linha de comando "`-DpropertyName=value`") +são utilizados pelo `InternetExplorerDriver`: -| **Property** | **What it means** | +| **Propriedade** | **O que significa** | |:-------------|:------------------| -| `webdriver.ie.driver` | The location of the IE driver binary. | -| `webdriver.ie.driver.host` | Specifies the IP address of the host adapter on which the IE driver will listen. | -| `webdriver.ie.driver.loglevel` | Specifies the level at which logging messages are output. Valid values are FATAL, ERROR, WARN, INFO, DEBUG, and TRACE. Defaults to FATAL. | -| `webdriver.ie.driver.logfile` | Specifies the full path and file name of the log file. | -| `webdriver.ie.driver.silent` | Suppresses diagnostic output when the IE driver is started. | -| `webdriver.ie.driver.extractpath` | Specifies the full path to the directory used to extract supporting files used by the server. Defaults to the TEMP directory if not specified. | - -## Required Configuration - -* The `IEDriverServer` executable must be [downloaded](https://www.selenium.dev/downloads/) and placed in your [PATH](http://en.wikipedia.org/wiki/PATH_(variable)). -* On IE 7 or higher on Windows Vista, Windows 7, or Windows 10, you must set the Protected Mode settings for each zone to be the same value. The value can be on or off, as long as it is the same for every zone. To set the Protected Mode settings, choose "Internet Options..." from the Tools menu, and click on the Security tab. For each zone, there will be a check box at the bottom of the tab labeled "Enable Protected Mode". -* Additionally, "Enhanced Protected Mode" must be disabled for IE 10 and higher. This option is found in the Advanced tab of the Internet Options dialog. -* The browser zoom level must be set to 100% so that the native mouse events can be set to the correct coordinates. -* For Windows 10, you also need to set "Change the size of text, apps, and other items" to 100% in display settings. -* For IE 11 _only_, you will need to set a registry entry on the target computer so that the driver can maintain a connection to the instance of Internet Explorer it creates. For 32-bit Windows installations, the key you must examine in the registry editor is `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE`. For 64-bit Windows installations, the key is `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE`. Please note that the `FEATURE_BFCACHE` subkey may or may not be present, and should be created if it is not present. **Important:** Inside this key, create a DWORD value named `iexplore.exe` with the value of 0. - -## Native Events and Internet Explorer - -As the `InternetExplorerDriver` is Windows-only, it attempts to use so-called "native", or OS-level -events to perform mouse and keyboard operations in the browser. This is in contrast to using -simulated JavaScript events for the same operations. The advantage of using native events is that -it does not rely on the JavaScript sandbox, and it ensures proper JavaScript event propagation -within the browser. However, there are currently some issues with mouse events when the IE -browser window does not have focus, and when attempting to hover over elements. - -### Browser Focus - -The challenge is that IE itself appears to not fully respect the Windows messages we send the -IE browser window (`WM\_MOUSEDOWN` and `WM\_MOUSEUP`) if the window doesn't have the focus. -Specifically, the element being clicked on will receive a focus window around it, but the click -will not be processed by the element. Arguably, we shouldn't be sending messages at all; rather, -we should be using the `SendInput()` API, but that API explicitly requires the window to have the -focus. We have two conflicting goals with the WebDriver project. - -First, we strive to emulate the user as closely as possible. This means using native events -rather than simulating the events using JavaScript. - -Second, we want to not require focus of the browser window being automated. This means that -just forcing the browser window to the foreground is suboptimal. - -An additional consideration is the possibility of multiple IE instances running under multiple -WebDriver instances, which means any such "bring the window to the foreground" solution will -have to be wrapped in some sort of synchronizing construct (mutex?) within the IE driver's -C++ code. Even so, this code will still be subject to race conditions, if, for example, the -user brings another window to the foreground between the driver bringing IE to the foreground -and executing the native event. - -The discussion around the requirements of the driver and how to prioritize these two -conflicting goals is ongoing. The current prevailing wisdom is to prioritize the former over -the latter, and document that your machine will be unavailable for other tasks when using -the IE driver. However, that decision is far from finalized, and the code to implement it is -likely to be rather complicated. - -### Hovering Over Elements - -When you attempt to hover over elements, and your physical mouse cursor is within the boundaries -of the IE browser window, the hover will not work. More specifically, the hover will appear -to work for a fraction of a second, and then the element will revert back to its previous -state. The prevailing theory why this occurs is that IE is doing hit-testing of some sort -during its event loop, which causes it to respond to the physical mouse position when the -physical cursor is within the window bounds. The WebDriver development team has been unable -to discover a workaround for this behavior of IE. - -### Clicking `