diff --git a/docs_source_files/content/driver_idiosyncrasies/_index.de.md b/docs_source_files/content/driver_idiosyncrasies/_index.de.md index 8a6f40579453..59c7c06119bf 100644 --- a/docs_source_files/content/driver_idiosyncrasies/_index.de.md +++ b/docs_source_files/content/driver_idiosyncrasies/_index.de.md @@ -6,3 +6,4 @@ weight: 10 # Eigenheiten des Drivers + diff --git a/docs_source_files/content/driver_idiosyncrasies/driver_specific_capabilities.de.md b/docs_source_files/content/driver_idiosyncrasies/driver_specific_capabilities.de.md index 6c809c146545..06a860a3b401 100644 --- a/docs_source_files/content/driver_idiosyncrasies/driver_specific_capabilities.de.md +++ b/docs_source_files/content/driver_idiosyncrasies/driver_specific_capabilities.de.md @@ -3,17 +3,13 @@ title: "Driver spezifische Capabilities" weight: 2 --- -{{% notice info %}} - Diese Seite wird von Englisch -auf Deutsch übersetzt. Sprichst Du Deutsch? Hilf uns die Seite -zu übersetzen indem Du uns einen Pull Reqeust schickst! - {{% /notice %}} ## Firefox -### Define Capabilities using `FirefoxOptions` +### Definerte Capabilities in den `FirefoxOptions` -`FirefoxOptions` is the new way to define capabilities for the Firefox -browser and should generally be used in preference to DesiredCapabilities. +`FirefoxOptions` ist die neue Methode um Capabilities für den Firefoxbrowser +zu definieren und sollte bevorzugt verwendet werden statt den DesiredCapabilities +and should generally be used in preference to DesiredCapabilities. {{< code-tab >}} {{< code-panel language="java" >}} @@ -56,9 +52,10 @@ driver = RemoteWebDriver(options) {{< / code-tab >}} -### Setting a custom profile +### Erstellen eines benutzerdefinierten Profils -It is possible to create a custom profile for Firefox as demonstrated below. +Wie hier demonstriert ist es möglich ein benutzerdefiniertes +Profil für Firefox zu erstellen. {{< code-tab >}} {{< code-panel language="java" >}} @@ -108,11 +105,13 @@ driver = RemoteWebDriver(options) ## Internet Explorer -### fileUploadDialogTimeout +### Timeout betreffend Dateiupload -In some environments, Internet Explorer may timeout when opening the -File Upload dialog. IEDriver has a default timeout of 1000ms, but you -can increase the timeout using the fileUploadDialogTimeout capability. +Unter Umständen kann es vorkommen das der Internet Explorer in ein +Timout läuft während der Dateiupload-Dialog geöffnet wird. Der IEDriver +hat ein standardmässiges Timeout von 1000ms, jedoch dieses kann +erhöht werden indem die capability mit dem Namen fileUploadDialogTimeout +definiert wird. {{< code-tab >}} {{< code-panel language="java" >}} @@ -158,16 +157,16 @@ val driver = RemoteWebDriver(options) ### ensureCleanSession -When set to `true`, this capability clears the _Cache, -Browser History and Cookies_ for all running instances -of InternetExplorer including those started manually -or by the driver. By default, it is set to `false`. +Ist die Capability auf `true` gesetzt, wird der _Cache, +Browser History and Cookies_ für alle laufenden Instanzen des +InternetExplorer inklusive aller die manuell oder vom WebDriver +gestartet werden. Standardmäßig ist der Wert mit _false_ vorbelegt. -Using this capability will cause performance drop while -launching the browser, as the driver will wait until the cache -gets cleared before launching the IE browser. +Die Verwendung dieser Capability führt zu Performanceeinbußen +während des starten des Browsers, da der driver wartet bis +der Cache geleert wird bevor der InternetExplorer gestartet wird. -This capability accepts a Boolean value as parameter. +Es wird ein Wert vom Typ Boolean erwartet. {{< code-tab >}} {{< code-panel language="java" >}} @@ -213,11 +212,12 @@ val driver = RemoteWebDriver(options) ### ignoreZoomSetting -InternetExplorer driver expects the browser zoom level to be 100%, -else the driver will throw an exception. This default behaviour -can be disabled by setting the _ignoreZoomSetting_ to _true_. - -This capability accepts a Boolean value as parameter. +Der InternetExplorer erwartet das das Browser Zoomlevel auf 100% +eingestellt ist, andernfalls wird eine Fehlermeldung (=Exception) +ausgelöst. Dieses Standardverhalten kann deaktiviert werden in dem +die Einstellung _ignoreZoomSetting_ auf _true_ gesetzt wird. + +Die Capability erwartet einen Booleanwert als Parameter. {{< code-tab >}} {{< code-panel language="java" >}} @@ -263,21 +263,21 @@ val driver = RemoteWebDriver(options) ### ignoreProtectedModeSettings -Whether to skip the _Protected Mode_ check while launching -a new IE session. +Legt fest ob die Prüfung des _Protected Mode_ beim Starten +einer neuen IE Sitzung übersprungen werden soll. -If not set and _Protected Mode_ settings are not same for -all zones, an exception will be thrown by the driver. +Der driver löst eine Exception aus falls der _Proteced Mode_ +nicht definiert wurde oder nicht für alle Umgebungen gleich ist. -If capability is set to `true`, tests may -become flaky, unresponsive, or browsers may hang. -However, this is still by far a second-best choice, -and the first choice should *always* be to actually -set the Protected Mode settings of each zone manually. -If a user is using this property, -only a "best effort" at support will be given. +Wenn diese capability auf `true` gesetzt wird, können Tests +instabil werden, bzw. kann der Browser abstürzen oder nicht +reagieren. Diese Einstellung ist nicht zu bevorzugen und sollte +nur als zweite Wahl genutzt werden. Mit Sicherheit sollte +der Protected Mode für jede Zone *immer* manuell definiert werden. +Falls jemand diese Einstellung nutzt kann kein umfassender Support +garantiert werden. -This capability accepts a Boolean value as parameter. +Die capability erwartet einen Booleanwert als Parameter. {{< code-tab >}} {{< code-panel language="java" >}} @@ -323,10 +323,10 @@ val driver = RemoteWebDriver(options) ### silent -When set to `true`, this capability suppresses the -diagnostic output of the IEDriverServer. +Ist diese capability auf `true` gesetzt, werden alle +Diagnosemeldungen des IEDriverServer unterdrückt. -This capability accepts a Boolean value as parameter. +Als Parameter wird ein Booleanwert erwartet. {{< code-tab >}} {{< code-panel language="java" >}} @@ -395,20 +395,20 @@ fun main() { ### IE Command-Line Options -Internet Explorer includes several command-line options -that enable you to troubleshoot and configure the browser. +Der Internet Explorer akzeptiert eine Reihe von Kommandozeilenparameter +die die Fehlersuche erleichtern und um den Browser zu konfigurieren. -The following describes few supported command-line options +Folgend sind einige der Kommandozeilenparameter angeführt -* _-private_ : Used to start IE in private browsing mode. This works for IE 8 and later versions. +* _-private_ : Wird genutzt um den IE im Inkognitomodus zu starten. Diese Option wird ab IE Version 8 unterstützt. -* _-k_ : Starts Internet Explorer in kiosk mode. -The browser opens in a maximized window that does not display the address bar, the navigation buttons, or the status bar. +* _-k_ : Startet den Internet Explorer im Kiosk Modus. +Der Browser öffnet sich mit maximerten Fenster, indem die Navigationsleiste, das Adressfeld und die Statusbar verborgen sind. -* _-extoff_ : Starts IE in no add-on mode. -This option specifically used to troubleshoot problems with browser add-ons. Works in IE 7 and later versions. +* _-extoff_ : Startet den IE ohne Addons. +Diese Option wird verwendet um Problemen mit Browser Addons vorzubeugen. Dies wird ab Version 7 unterstützt. -Note: __forceCreateProcessApi__ should to enabled in-order for command line arguments to work. +Bemerkung: __forceCreateProcessApi__ sollte aktiviert werden damit die Kommandozeilenparameter unterstützt werden. {{< code-tab >}} {{< code-panel language="java" >}} @@ -511,11 +511,11 @@ fun main() { ### forceCreateProcessApi -Forces launching Internet Explorer -using the CreateProcess API. The default value is false. +Forciert beim Starten des Internet Explorers die Verwendung der +CreateProcess API. Standardwert ist false (=deaktiviert). -For IE 8 and above, this option requires the -"TabProcGrowth" registry value to be set to 0. +Ab IE Version 8 ist für diese Einstellung es notwendig den +"TabProcGrowth" Wert auf 0 zu setzen. {{< code-tab >}} {{< code-panel language="java" >}} diff --git a/docs_source_files/content/driver_idiosyncrasies/shared_capabilities.de.md b/docs_source_files/content/driver_idiosyncrasies/shared_capabilities.de.md index 1dede0339370..092132423e67 100644 --- a/docs_source_files/content/driver_idiosyncrasies/shared_capabilities.de.md +++ b/docs_source_files/content/driver_idiosyncrasies/shared_capabilities.de.md @@ -1,150 +1,153 @@ --- -title: "Geteilte capabilities" +title: "Allgemeine capabilities" weight: 1 --- -{{% notice info %}} - Diese Seite wird von Englisch -auf Deutsch übersetzt. Sprichst Du Deutsch? Hilf uns die Seite -zu übersetzen indem Du uns einen Pull Reqeust schickst! - {{% /notice %}} - -In-order to create a new session by Selenium WebDriver, -local end should provide the basic capabilities to remote end. -The remote end uses the same set of capabilities to -create a session and describes the current session features. +Um eine neue Sitzung mit dem Selenium WebDriver zu erstellen, +ist es notwendig das die Grundlegenden capabilites zur Verfügung +gestellt werden. -WebDriver provides capabilities that each remote -end will/should support the implementation. -Following are the capabilities that WebDriver supports: +Das Zielsystem benutzt dabei die gleichen Einstellungen in den +capabilities um eine Sitzung zu erstellen und ermöglich Details +dieser Sitzung abzufragen. + +WebDriver stellt capabilites zur Verfügung und jeder Adapter +sollte diese Implementierung unterstützen. Folgende capabilites +werden von WebDriver unterstützt: ## browserName: -This capability is used to set the `browserName` for a given session. -If the specified browser is not installed at the -remote end, the session creation will fail +Diese Capability wird verwendet um den `browserName` für eine +Sitzung zu definieren. Ist der Browser auf dem Zielsystem nicht +installiert, schlägt die Erstellung der Sitzung fehl. ## browserVersion: -This capability is optional, this is used to -set the available browser version at remote end. -For Example, if ask for Chrome version 75 on a system that -only has 80 installed, the session creation will fail +Diese capability ist optional, sie dient dazu die Version +des Webbrowsers am Zielsystem zu definieren. Wird versucht +eine Sitzung z.B. mit Chrome in der Version 75 zu initialisieren, +auf dem lediglich Version 80 installiert ist, wird dies fehlschlagen. -## pageLoadStrategy: +## Strategien das Websitenladehaltens betreffend (pageLoadingStrategy) -When navigating to a new page via URL, by default Selenium will wait -until the page has fully loaded before responding. This works well for -beginners, but can cause long wait times on pages that load a large -number of third party resources. Using a non default strategy can make -test execution faster in cases like this, but can also introduce flakiness -where elements on the page change position as elements load in and change -size. - -The page load strategy queries the -[document.readyState](//developer.mozilla.org/de/docs/Web/API/Document/readyState) -as described in the table below: +Standarmäßig wartet Selenium bis eine Seite vollständig geladen ist wenn +zu einer neuen Seiten via URL navigiert wird. Dies funktioniert wunderbar +für Anfänger, kann jedoch lange Wartezeiten verursachen, für Webseiten die +mehrere Drittanbieter Ressourcen beinhalten. Dies kann jedoch in einem +solchen Fall beschleunigt werden, wenn nicht die Standardstrategie verwendet +wird. Jedoch können dadurch die Tests instabil werden, da Elemente auf der Website sowohl + die Position, als auch die Größe, während des Ladens verändern können. + + Die definierte Wartestrategie prüft den + [document.readyState](//developer.mozilla.org/de/docs/Web/API/Document/readyState) +wie in der Tabelle angeführt: -| Strategy | Ready State | Notes | +| Strategie | Status | Bemerkung | | -------- | ----------- | ----- | -| normal | complete | Used by default, waits for all resources to download | -| eager | interactive | DOM access is ready, but other resources like images may still be loading | -| none | Any | Does not block WebDriver at all | +| normal | komplett | Standardwert, wartet bis alle Ressourcen geladen wurden | +| eager | interaktiv | DOM Zugriff ist bereit, allerdings können andere Elemente wie Bilder noch unvollständig geladen sein | +| none | beliebig | Blockiert den WebDriver gar nicht | + ## platformName -This identifies the operating system at the remote-end, -fetching the `platformName` returns the OS name. +Dient zur Definition des Betriebssystems am Zielsystem. Wird +die capability abgefragt erhält man den Namen des Betriebssystems. -In cloud-based providers, -setting `platformName` sets the OS at the remote-end. +Auf cloud-basierten Systemen wird mittels `platformName` das +Betriebssystem des Zielsystems definiert. ## acceptInsecureCerts -This capability checks whether an expired (or) -invalid `TLS Certificate` is used while navigating -during a session. +Diese capability legt fest ob abgelaufene oder ungültige +`TLS Certificate` verwendet werden benutzt werden können. -If the capability is set to `false`, an +Wenn die capability den Wert `false` gesetzt hat, wird ein [insecure certificate error](//developer.mozilla.org/de/docs/Web/WebDriver/Errors/InsecureCertificate) -will be returned as navigation encounters any domain -certificate problems. If set to `true`, invalid certificate will be -trusted by the browser. - -All self-signed certificates will be trusted by this capability by default. -Once set, `acceptInsecureCerts` capability will have an -effect for the entire session. +als Rückgabewert geliefert falls Domain Zertifikatsprobleme +auftauchen. Ist der Wert auf `true` gesetzt, werden ungültige + Zertifikate vom Webbrowser akzeptiert. + +Allen selbstsignierten Zertifikaten werden standardmässig vertraut +mit dieser capability. Ist die capability `acceptInsecureCerts` +gesetzt, hat dies für die gesamte Sitzung Auswirkungen. -## Session timeouts +## Sitzungstimeouts (Session timeouts) -A WebDriver `session` is imposed with a certain `session timeout` -interval, during which the user can control the behaviour -of executing scripts or retrieving information from the browser. +Einer WebDriver `session` ist ein bestimmtes `session timeout` +Intervall zugeordnet, während diesem kann der Benutzer +kontrollieren ob Scripts ausgeführen werden oder Informationen +vom Webbrowser empfangen werden sollen. -Each session timeout is configured with -combination of different `timeouts` as described below: +Jedes Session Timeout is mittels einer Kombination +der folgenden unterschiedlichen `timeouts` definiert: ### Script Timeout: -Specifies when to interrupt an executing script in -a current browsing context. The default timeout **30,000** -is imposed when a new session is created by WebDriver. - -### Page Load Timeout: -Specifies the time interval in which web page -needs to be loaded in a current browsing context. -The default timeout **300,000** is imposed when a -new session is created by WebDriver. If page load limits -a given/default time frame, the script will be stopped by -_TimeoutException_. - -### Implicit Wait Timeout -This specifies the time to wait for the -implicit element location strategy when -locating elements. The default timeout **0** -is imposed when a new session is created by WebDriver. +Spezifiziert wann die Ausführung eines Scriptes im aktuellen +Browserkontext abgebrochen werden soll. Standardmäßig ist das +Timeout auf **30** Sekunden festgelegt und wird festgelegt +sobald eine neue Sitzung des WebDrivers erstellt wird. + +### Seitenlade Timeout: +Damit wird die Zeitspanne festgelegt in dem die Webseite +geladen werden muss im aktuellen Webbrowser Kontext. +Der Standardwert liegt bei **300** Sekunden und wird +beim Erstellen einer WebDriver Sitzung festgelegt. Wird das +festgelegte Zeitfenster überschritten wird das Script mit einer +_TimeoutException_ gestoppt. + +### Impliziertes Wait Timeout + +Spezifiziert die Zeitspanne die gewartet wird um +bei der implizierten Suche nach Elementen. Der Standard +Wert ist **0** und wird festgelegt bei der Initialisierung +des WebDrivers. ## unhandledPromptBehavior -Specifies the state of current session's `user prompt handler`. -Defaults to **dismiss and notify state** +Legt den Status der aktullen Sitzung fest `user prompt handler`. +Standardwert ist **dismiss and notify state** (=Verwerfen und Status melden) -### User Prompt Handler +### unhandledPromptBehaviour -This defines what action must take when a -user prompt encounters at remote-end. This is defined by -`unhandledPromptBehavior` capability and has the following states: +Definiert welche Aktion wenn eine Anfrage auf dem Zielsystem +eine Aktion erfordert. Dies wird mittels `unhandledPromptBehavior` +capability definiert und hat einen der folgenden Stati: -* dismiss -* accept -* dismiss and notify -* accept and notify -* ignore +* dismiss (=verwerfen) +* accept (=akzeptieren) +* dismiss and notify (=verwerfen und benachrichtigen) +* accept and notify (=akzeptieren und benachrichtigen) +* ignore (=ignorieren) ## setWindowRect -This command alters the size and position of the current -browsing context window. This command acts as setter -to `getWindowRect` command which accepts **width**, **height**, -**x**, **y** as _optional_ arguments. +Mit Hilfe dieses Kommandos wird die Größe und die Position +des Webbrowserfensters verändert. Der Befehl agiert als setter +für `getWindowRect` und hat als Parameter **breite**, **höhe**, +**x**, **y** als _optionale_ Parameter. + -During automation, the current browsing context will be associated -with window states, that describe visibility -state of the browser window. The window states are +Während der Automatisierung, wird der aktuelle Webbrowserkontext +mit Status des Fensters assoziert, welcher die Sichtbarkeit des +Webbrowserfensters beschreibt. Folgende Statis des Fensters gibt es: -* maximized -* minimized +* maximized (= maximiert) +* minimized (= minimiert) * normal -* fullscreen +* fullscreen (=Vollbild) -Setting _Width_ or _Height_ does not guaranteed that the resulting -window size will exactly match that which was quested. This is because -some drivers may not be able to resize in single-pixel increments. -Due to this, fetching the window state/details by `getWindowRect` -may not equally match the values set to the browser. +Allerdings kann das festlegen der _Breite_ oder _Höhe_ des +Fensters nicht garantieren das dieses die exakte Größe aufweist. +Grund dafür ist, dass manche driver es nicht ermöglichen +Größenänderungen für einzelne Pixel vorzunehmen. Dadurch können +auch Ungenauigkeiten beim Abrufen der Fensterdetails mit `getWindowRect` +auftreten, wenn diese Werte zuvor gesetzt wurden. ## strictFileInteractability -The new capabilitiy indicates if strict interactability checks -should be applied to _input type=file_ elements. As strict interactability -checks are off by default, there is a change in behaviour -when using _Element Send Keys_ with hidden file upload controls. \ No newline at end of file +Mit dieser neuen Capability kann festgelegt werden ob die +strikte Methode für Eingabefelder die das Tag _input type=file_ haben +angewandt wird. Die strike Methode ist standardmäßig nicht aktiv. +Das Verhalten hat sich disbezüglich geändert wenn die _Element Send Keys_ +Funktion auf versteckte Dateiuploads Kontrollfelder angewandt wird. \ No newline at end of file diff --git a/docs_source_files/content/getting_started_with_webdriver/_index.de.md b/docs_source_files/content/getting_started_with_webdriver/_index.de.md index 41ca1d624605..c7f794f9e176 100644 --- a/docs_source_files/content/getting_started_with_webdriver/_index.de.md +++ b/docs_source_files/content/getting_started_with_webdriver/_index.de.md @@ -7,30 +7,28 @@ weight: 4 # Erste Schritte mit WebDriver -{{% notice info %}} - Diese Seite wird von Englisch -auf Deutsch übersetzt. Sprichst Du Deutsch? Hilf uns die Seite -zu übersetzen indem Du uns einen Pull Reqeust schickst! - {{% /notice %}} +Selenium unterstützt das Automatisieren aller wichtigsten Webbrowser +durch die Verwendung von _WebDriver_. -Selenium supports automation of all the major browsers in the market -through the use of _WebDriver_. -WebDriver is an API and protocol that defines a language-neutral interface -for controlling the behaviour of web browsers. -Each browser is backed by a specific WebDriver implementation, called a *driver*. -The driver is the component responsible for delegating down to the browser, -and handles communication to and from Selenium and the browser. +WebDriver ist eine API und ein Protokoll, das eine programmiersprachen +unabhängige Schnittstelle definiert um den Webrowser zu steuern. +Jeder Browser ist mit einer spezifischen Implementierung des Webdriver +ausgestattet, auch *driver* genannt. Dieser driver ist die Komponente +die verantwortlich ist um den Browser fernzusteuern, weiters handabt dieser +die Kommunikation zwischen Selenium und dem Webbrowser. -This separation is part of a conscious effort to have browser vendors -take responsibility for the implementation for their browsers. -Selenium makes use of these third party drivers where possible, -but also provides its own drivers maintained by the project -for the cases when this is not a reality. +Diese Trennung wurde bewusst gemacht, um die Verantwortung der +browserspezifischen Implementierung in die Hände der Browserhersteller +zu legen. Selenium ermöglicht es diese Drittanbieter driver zu verwenden. +Weiters werden auch eigene driver zur Verfügung gestellt die durch +das Projekt gewartet werden, für den Fall das der Browserhersteller +keine zur Verfügung stellt. -The Selenium framework ties all of these pieces together -through a user-facing interface that enables the different browser backends -to be used transparently, -enabling cross-browser and cross-platform automation. +Das Seleniumframework verbindet diese einzelnen Komponenten zu einer +benutzerfreundlichen Schnittstelle die es ermöglicht, die verschiedenen +Browserbackends einheitlich und browser- als auch plattform-unabhängig +zu automatisieren. -More details about drivers can be found in -[Driver Idiosyncrasies]({{< ref "/driver_idiosyncrasies/_index.md" >}}). \ No newline at end of file +Weitere Details zu den drivers können unter +[Driver Eigenheiten]({{< ref "/driver_idiosyncrasies/_index.md" >}}) +aufgerufen werden. \ No newline at end of file