Selenium WebDriver Plugin - Versionsgeschichte

Matilk: /* FAQ */ Firefox nach Update

2024-08-22T15:02:28Z

FAQ: Firefox nach Update

← Nächstältere Version		Version vom 22. August 2024, 15:02 Uhr
Zeile 296:		Zeile 296:
	:* ''--disable-search-engine-choice-screen'': In den [[#Erweiterte_Einstellungen\|erweiterten Einstellungen]] kann man bei den Optionen <code>--disable-search-engine-choice-screen</code> angeben, dann kommt das Overlay nicht.		:* ''--disable-search-engine-choice-screen'': In den [[#Erweiterte_Einstellungen\|erweiterten Einstellungen]] kann man bei den Optionen <code>--disable-search-engine-choice-screen</code> angeben, dann kommt das Overlay nicht.
	:* ''Auswählen'': Sie können Ihren Test auch so erweitern, dass zu Beginn eine Suchmaschine ausgewählt und damit das Overlay geschlossen wird. Dabei müssen Sie zwei Dinge beachten. Zum einen müssen Sie zuerst mit einem ''Switch to Window''-Baustein dorthin wechseln (z.B. mit Index ''2'' oder leerem Titel) und am Ende auch wieder zurück zu Ihrem ursprünglichen Tab. Zum anderen sind interessanten Elemente des Overlays [[#Shadow-Elemente\|Shadow-Elemente]] und werden daher im GUI-Browser nicht direkt angezeigt.		:* ''Auswählen'': Sie können Ihren Test auch so erweitern, dass zu Beginn eine Suchmaschine ausgewählt und damit das Overlay geschlossen wird. Dabei müssen Sie zwei Dinge beachten. Zum einen müssen Sie zuerst mit einem ''Switch to Window''-Baustein dorthin wechseln (z.B. mit Index ''2'' oder leerem Titel) und am Ende auch wieder zurück zu Ihrem ursprünglichen Tab. Zum anderen sind interessanten Elemente des Overlays [[#Shadow-Elemente\|Shadow-Elemente]] und werden daher im GUI-Browser nicht direkt angezeigt.

			*'''Firefox: <code>Process unexpectedly closed with status 0</code>'''
			:Fehlerbild: Die Verbindung zum Firefox-Browser kommt nicht zustande mit der Fehlermeldung <code>org.openqa.selenium.WebDriverException: Process unexpectedly closed with status 0</code>. Der Browser öffnet sich dann aber doch ohne dass es eine Verbindung in expecco gibt.
			:Eine bekannte Ursache dafür ist, dass der Browser dabei zum ersten Mal nach einem Update gestartet wird, womit der Browser im automatisierten Zustand nicht zurecht kommt. Beim zweiten Versuch sollte der Fehler dann nicht mehr auftreten. Um den Fehler zu verhindern, achten Sie darauf, den Browser nach einem Update immer zuerst normal zu starten.

Matilk: /* FAQ */ Chrome: Wähle deine Suchmaschine

2024-08-05T13:34:15Z

FAQ: Chrome: Wähle deine Suchmaschine

← Nächstältere Version		Version vom 5. August 2024, 13:34 Uhr
Zeile 291:		Zeile 291:

	*'''Chrome: Wähle deine Suchmaschine'''		*'''Chrome: Wähle deine Suchmaschine'''
	:Neuere Chromeversionen zeigen nach dem Starten ein Overlay, bei dem man die verwendete Suchmaschine auswählen soll. Die Entscheidung wird normalerweise im Benutzerprofil gespeichert. Wenn für die Verbindung aber nicht explizit ein Chrome-Profil angegeben wird, hat man bei jedem Verbindungsaufbau ein leeres Profil und es wird immer nachgefragt.		:Neuere Chromeversionen zeigen nach dem Starten ein [https://www.google.com/chrome/choicescreen/ Overlay], bei dem man die verwendete Suchmaschine auswählen soll. Die Entscheidung wird normalerweise im Benutzerprofil gespeichert. Wenn für die Verbindung aber nicht explizit ein Chrome-Profil angegeben wird, hat man bei jedem Verbindungsaufbau ein leeres Profil und es wird immer nachgefragt.

	:In vielen Fällen kann der Test auch trotz des Overlays im Hintergrund ablaufen. Das Overlay gilt aber wie ein Tab bzw. Fenster; so liefert beispielsweise vom Baustein ''[Web] Get Window Handles'' einen Handle dafür und es kann auch dorthin gewechselt werden. Es gibt aber auch Möglichkeiten es loszuwerden:		:In vielen Fällen kann der Test auch trotz des Overlays im Hintergrund ablaufen. Das Overlay gilt aber wie ein Tab bzw. Fenster; so liefert beispielsweise vom Baustein ''[Web] Get Window Handles'' einen Handle dafür und es kann auch dorthin gewechselt werden. Es gibt aber auch Möglichkeiten es loszuwerden:

Matilk: /* FAQ */ Chrome: Wähle deine Suchmaschine

2024-08-05T13:11:04Z

FAQ: Chrome: Wähle deine Suchmaschine

← Nächstältere Version		Version vom 5. August 2024, 13:11 Uhr
Zeile 289:		Zeile 289:
	*'''Zusätzliche Window Handles mit Opera'''		*'''Zusätzliche Window Handles mit Opera'''
	:Der Opera-Browser liefert mehr Window Handles als Tabs bzw. Fenster geöffnet sind. Diese kommen von Opera-internen Funktionen wie dem Schnellstart (''Speed Dial'') oder der ''Better Address Bar Experience'' (BABE), die zwar im Browserfenster eingebunden, aber nicht als Tab angezeigt werden. Zu diesen Tabs kann zwar mit den entsprechenden Bausteinen gewechselt werden, es sind dann aber nicht alle Aktionen möglich, die für die normalen Tabs zur Verfügung stehen. Sie können zum Beispiel nicht geschlossen werden und man bekommt von ihnen kein Bild. Am besten wechselt man daher gar nicht erst in diese Kontexte. Seien Sie also vorsichtig, wenn Sie anhand des Index zu einem Tab wechseln wollen, da sich die Opera-Tabs zwischen den anderen befinden und der Index ein anderer als für die anderen Browser sein kann.		:Der Opera-Browser liefert mehr Window Handles als Tabs bzw. Fenster geöffnet sind. Diese kommen von Opera-internen Funktionen wie dem Schnellstart (''Speed Dial'') oder der ''Better Address Bar Experience'' (BABE), die zwar im Browserfenster eingebunden, aber nicht als Tab angezeigt werden. Zu diesen Tabs kann zwar mit den entsprechenden Bausteinen gewechselt werden, es sind dann aber nicht alle Aktionen möglich, die für die normalen Tabs zur Verfügung stehen. Sie können zum Beispiel nicht geschlossen werden und man bekommt von ihnen kein Bild. Am besten wechselt man daher gar nicht erst in diese Kontexte. Seien Sie also vorsichtig, wenn Sie anhand des Index zu einem Tab wechseln wollen, da sich die Opera-Tabs zwischen den anderen befinden und der Index ein anderer als für die anderen Browser sein kann.

			*'''Chrome: Wähle deine Suchmaschine'''
			:Neuere Chromeversionen zeigen nach dem Starten ein Overlay, bei dem man die verwendete Suchmaschine auswählen soll. Die Entscheidung wird normalerweise im Benutzerprofil gespeichert. Wenn für die Verbindung aber nicht explizit ein Chrome-Profil angegeben wird, hat man bei jedem Verbindungsaufbau ein leeres Profil und es wird immer nachgefragt.

			:In vielen Fällen kann der Test auch trotz des Overlays im Hintergrund ablaufen. Das Overlay gilt aber wie ein Tab bzw. Fenster; so liefert beispielsweise vom Baustein ''[Web] Get Window Handles'' einen Handle dafür und es kann auch dorthin gewechselt werden. Es gibt aber auch Möglichkeiten es loszuwerden:
			:* ''--disable-search-engine-choice-screen'': In den [[#Erweiterte_Einstellungen\|erweiterten Einstellungen]] kann man bei den Optionen <code>--disable-search-engine-choice-screen</code> angeben, dann kommt das Overlay nicht.
			:* ''Auswählen'': Sie können Ihren Test auch so erweitern, dass zu Beginn eine Suchmaschine ausgewählt und damit das Overlay geschlossen wird. Dabei müssen Sie zwei Dinge beachten. Zum einen müssen Sie zuerst mit einem ''Switch to Window''-Baustein dorthin wechseln (z.B. mit Index ''2'' oder leerem Titel) und am Ende auch wieder zurück zu Ihrem ursprünglichen Tab. Zum anderen sind interessanten Elemente des Overlays [[#Shadow-Elemente\|Shadow-Elemente]] und werden daher im GUI-Browser nicht direkt angezeigt.

Matilk: /* Einstellungen */

2023-11-08T12:10:13Z

Einstellungen

← Nächstältere Version		Version vom 8. November 2023, 12:10 Uhr
Zeile 9:		Zeile 9:

	(*) tatsächlich gibt es auch WebDriver-Schnittstellen um z.B. Windows-Apps oder OPS-Fenster zu manipulieren. Insofern gibt es für dieses Plugin weitere Einsatzbereiche.		(*) tatsächlich gibt es auch WebDriver-Schnittstellen um z.B. Windows-Apps oder OPS-Fenster zu manipulieren. Insofern gibt es für dieses Plugin weitere Einsatzbereiche.

			=Einstellungen=
			Das Plugin verwendet die Java-Bridge und benötigt daher eine Java-Installation. Sie können diese in den Einstellungen unter ''Erweiterungen'' -> ''Java Bridge'' angeben. Wichtig ist hier das Feld ''Pfad zur Java-Installation'', wo Sie ein JDK oder JRE angeben können. Ist nichts angegeben, versucht expecco java im PATH zu finden.

			[[Datei:JDKPfadEinstellungen.png\|600px]]

			Für das Selenium WebDriver Plugin selbst gibt es ebenfalls Einstellungsmöglichkeiten, die Sie unter ''Erweiterungen'' -> ''Webtest (Selenium WebDriver)'' finden. Hier können Sie zum Beispiel die Adresse zu einem remote laufenden Selenium-Server angeben oder eine andere Jar-Datei für Selenium angeben. Einstellungen zu den verschiedenen Browser-Typen teilen sich auf die Unterseiten ''Beliebte Browser'' und ''Andere Browser'' auf. Dort können Sie den Pfad zur Browser-Ausführungsdatei oder zum Webdriver angeben, der verwendet werden soll. Diese Felder können Sie alle leer lassen, expecco wird dann automatisch danach suchen.

	=Browser-Unterstützung=		=Browser-Unterstützung=

Matilk: /* WebDriver aktualisieren */

2023-09-25T15:12:16Z

WebDriver aktualisieren

← Nächstältere Version		Version vom 25. September 2023, 15:12 Uhr
Zeile 18:		Zeile 18:

	== WebDriver aktualisieren==		== WebDriver aktualisieren==
	Für jeden Browsertyp gibt es einen Driver, über den das Starten und Ansteuern der Browserfenster funktioniert. ~~Diese~~ ~~müssen~~ ~~möglicherweise~~ aktualisiert werden, ~~wenn~~ ~~sich~~ ~~die~~ ~~Browser-Version~~ ~~ändert.~~ ~~Für~~ ~~die~~ ~~wichtigsten~~ ~~Browser~~ ~~finden~~ ~~sich~~ im ~~Lieferumfang~~ ~~die~~ ~~Driver~~ in Ihrem expecco-Installationsverzeichnis unter:		Für jeden Browsertyp gibt es einen Driver, über den das Starten und Ansteuern der Browserfenster funktioniert. Für die wichtigsten Browser finden sich im Lieferumfang aktuelle Driverversionen. Da die Browser fortlaufend aktualisiert werden, teilweise sogar automatisch, müssen Sie früher oder später neue Driverversionen herunterladen. Legen Sie diese dann in Ihrem expecco-Installationsverzeichnis bei den anderen Versionen ab, und zwar unter:
	<code>packages/exept/expecco/plugin/seleniumWebDriver/lib/XXX</code>		<code>packages/exept/expecco/plugin/seleniumWebDriver/lib/XXX</code>
	(unter Microsoft Windows Betriebssystemen mit "\” anstatt "/"), wobei "XXX" für das Betriebssystem steht (Windows, Linux, OSX etc.).		(unter Microsoft Windows Betriebssystemen mit "\” anstatt "/"), wobei "XXX" für das Betriebssystem steht (Windows, Linux, OSX etc.).

	In ~~manchen Fällen~~ warnt expecco, ~~dass~~ eine ~~Driver-Version möglicherweise~~ nicht ~~zum~~ ~~Browser~~ passt. ~~Das~~ ~~bedeutet,~~ ~~dass~~ ~~diese~~ ~~Driver-Browser~~ ~~Kombination~~ ~~von~~ ~~eXept~~ ~~nicht~~ ~~getestet~~ ~~wurde (d.h. es~~ ~~gab~~ diese Version zum Zeitpunkt der Auslieferung noch nicht). Da ~~sich~~ ~~die~~ ~~Browser~~ ~~automatisch~~ ~~aktualisiert,~~ ~~die~~ ~~driver~~ ~~aber von uns geliefert werden~~, ~~müssen~~ ~~sie~~ ~~u.U.~~ ~~einen neueren Driver herunterladen und~~ im ~~expecco~~ ~~Installationsverzeichnis~~ ~~ablegen~~.		Im Verbindungsdialog warnt expecco, wenn eine Driverversion nicht zur Browserversion passt. In manchen Fällen kann das aber auch nur daran liegen, dass diese Version zum Zeitpunkt der Auslieferung noch nicht bekannt war. Manche Kombinationen können trotz der Warnung funktioniert, aber das können wir im Einzelfall nicht garantieren.
	In vielen Fällen funktioniert der ältere Driver auch mit neueren Browserversionen (aber natürlich können wir dies nicht garantieren).

	~~Falls~~ ~~eine~~ ~~solche~~ ~~Warnung~~ ~~erscheint,~~ ~~können~~ ~~sie~~ ~~den~~ "''Diese Warnung nicht mehr anzeigen''"~~-Schalter~~ ~~umlegen;~~ damit ~~wird~~ diese Driver-Browser Versionskombination in ihren Settings als "~~vertrauenswürdig~~" vermerkt, und in Zukunft nicht mehr gemeldet. Dies sollten Sie aber nur machen, wenn Sie sicher sind, dass Ihre Tests nach-wie-vor korrekt ausgeführt werden. Da wir hier selbst bisweilen auf Kompatibilitätsprobleme ~~stossen~~, und nicht immer gleich klar ist, woran es liegt, empfehlen wir aber den Driver zu aktualisieren.		Daher können Sie bei einer solchen Warnung immer die Option "''Diese Warnung nicht mehr anzeigen''" anwählen, damit diese Driver-Browser-Versionskombination in ihren Settings als "kompatibel" vermerkt wird, und in Zukunft nicht mehr gemeldet wird. Dies sollten Sie aber nur machen, wenn Sie sicher sind, dass Ihre Tests nach wie vor korrekt ausgeführt werden. Da wir hier selbst bisweilen auf Kompatibilitätsprobleme stoßen, und nicht immer gleich klar ist, woran es liegt, empfehlen wir aber den Driver zu aktualisieren.

			Für Chrome und Microsoft Edge, bei denen es für jede neue Browserversion auch eine neue Driverversion gibt, finden Sie im Verbindungsdialog einen Button, um mit expecco die passende Version herunterzuladen.

	Neuere Versionen der Driver bekommen Sie an folgenden Adressen:		Neuere Versionen der Driver bekommen Sie an folgenden Adressen:

Matilk: Link to English Version

2023-09-01T12:18:22Z

Link to English Version

← Nächstältere Version		Version vom 1. September 2023, 12:18 Uhr
Zeile 1:		Zeile 1:
			'''Deutsche Version''' \| [[Selenium_WebDriver_Plugin/en\|English Version]]
	=Achtung=		=Achtung=
	Das Webtest Selenium WebDriver Plugin ersetzt das bisherige [[Selenium_Web_Test_Plugin\|Selenium Web Test Plugin]]. Zur Automatisierung wird [https://www.seleniumhq.org/projects/webdriver/ Selenium WebDriver] verwendet (Driver für gängige Browser werden von uns mitgeliefert), der das bisher verwendete Selenium RC ersetzt. Dies wurde einerseits notwendig, da die SeleniumRC Schnittstelle von neuen Browsern nicht mehr unterstützt wird, andererseits, sinnvoll, da auch andere UI Technologien mit diesem Protokoll angesprochen werden können.		Das Webtest Selenium WebDriver Plugin ersetzt das bisherige [[Selenium_Web_Test_Plugin\|Selenium Web Test Plugin]]. Zur Automatisierung wird [https://www.seleniumhq.org/projects/webdriver/ Selenium WebDriver] verwendet (Driver für gängige Browser werden von uns mitgeliefert), der das bisher verwendete Selenium RC ersetzt. Dies wurde einerseits notwendig, da die SeleniumRC Schnittstelle von neuen Browsern nicht mehr unterstützt wird, andererseits, sinnvoll, da auch andere UI Technologien mit diesem Protokoll angesprochen werden können.

Matilk: /* FAQ */ Opera Window Handles

2023-07-18T08:12:57Z

FAQ: Opera Window Handles

← Nächstältere Version		Version vom 18. Juli 2023, 08:12 Uhr
Zeile 277:		Zeile 277:
	*'''Key Chords mit Shortcuts funktionieren nicht'''		*'''Key Chords mit Shortcuts funktionieren nicht'''
	:Das Drücken mehrerer Tasten gleichzeitig lässt sich als Key Chord simulieren. Dadurch können auch Shortcuts eingegeben werden. Allerdings funktionieren hier nicht alle Eingaben, da diese nur an den Seiteninhalt und nicht an den Browser selbst gehen. Kombinationen wie ''Strg + t'' um einen neuen Browsertab zu öffnen, funktionieren daher vermutlich nicht, ''Strg + a'' oder ''Strg + c'' sollten hingegen möglich sein.		:Das Drücken mehrerer Tasten gleichzeitig lässt sich als Key Chord simulieren. Dadurch können auch Shortcuts eingegeben werden. Allerdings funktionieren hier nicht alle Eingaben, da diese nur an den Seiteninhalt und nicht an den Browser selbst gehen. Kombinationen wie ''Strg + t'' um einen neuen Browsertab zu öffnen, funktionieren daher vermutlich nicht, ''Strg + a'' oder ''Strg + c'' sollten hingegen möglich sein.

			*'''Zusätzliche Window Handles mit Opera'''
			:Der Opera-Browser liefert mehr Window Handles als Tabs bzw. Fenster geöffnet sind. Diese kommen von Opera-internen Funktionen wie dem Schnellstart (''Speed Dial'') oder der ''Better Address Bar Experience'' (BABE), die zwar im Browserfenster eingebunden, aber nicht als Tab angezeigt werden. Zu diesen Tabs kann zwar mit den entsprechenden Bausteinen gewechselt werden, es sind dann aber nicht alle Aktionen möglich, die für die normalen Tabs zur Verfügung stehen. Sie können zum Beispiel nicht geschlossen werden und man bekommt von ihnen kein Bild. Am besten wechselt man daher gar nicht erst in diese Kontexte. Seien Sie also vorsichtig, wenn Sie anhand des Index zu einem Tab wechseln wollen, da sich die Opera-Tabs zwischen den anderen befinden und der Index ein anderer als für die anderen Browser sein kann.

Matilk: /* FAQ */ Stale Element Reference Exception

2023-06-12T14:36:35Z

FAQ: Stale Element Reference Exception

← Nächstältere Version		Version vom 12. Juni 2023, 14:36 Uhr
Zeile 261:		Zeile 261:
	*'''Fehlermeldung: <code>Cannot read property 'left' of undefined</code>'''		*'''Fehlermeldung: <code>Cannot read property 'left' of undefined</code>'''
	:Der Fehler <code>org.openqa.selenium.JavascriptException: javascript error: Cannot read property 'left' of undefined</code> kann mit dem Chrome-Browser auftreten. In diesem Fall ist das verwendete Element nicht sichtbar. Lesen Sie dazu den Punkt oben. Der Fehler ist auch im Zusammenhang mit Elementen in einer Dropdown-Liste bekannt, d.h. bei einem Klick oder dem Bewegen der Maus auf ein <nowiki><option></nowiki>-Element innerhalb eines <nowiki><select></nowiki>-Elements. Diese Elemente sind prinzipiell nicht klickbar. Verwenden Sie stattdessen einen passenden <code>[Web] Select</code>-Baustein mit dem <nowiki><select></nowiki>-Element.		:Der Fehler <code>org.openqa.selenium.JavascriptException: javascript error: Cannot read property 'left' of undefined</code> kann mit dem Chrome-Browser auftreten. In diesem Fall ist das verwendete Element nicht sichtbar. Lesen Sie dazu den Punkt oben. Der Fehler ist auch im Zusammenhang mit Elementen in einer Dropdown-Liste bekannt, d.h. bei einem Klick oder dem Bewegen der Maus auf ein <nowiki><option></nowiki>-Element innerhalb eines <nowiki><select></nowiki>-Elements. Diese Elemente sind prinzipiell nicht klickbar. Verwenden Sie stattdessen einen passenden <code>[Web] Select</code>-Baustein mit dem <nowiki><select></nowiki>-Element.

			*'''Fehlermeldung: <code>Stale Element Reference Exception</code>'''
			:Der Fehler <code>org.openqa.selenium.StaleElementReferenceException</code> tritt immer dann auf, wenn ein WebElement verwendet wird, das nicht mehr da ist. Wenn das in Ihrem Test passiert und das Element eigentlich da sein sollte, verwenden Sie an der Stelle stattdessen den Locator, um das Element neu zu holen. Eventuell liegt es auch daran, dass sich der Test momentan in einem anderen Frame-Kontext befindet als das Element. Wenn Sie [[#Zusammengesetzte_Pfade\|zusammengesetzte Pfade]] verwenden, sollte das Element selbst in den richtigen Kontext wechseln, bevor Aktionen darauf ausgeführt werden.
			:In seltenen Fällen kann der Fehler auch in expecco selbst auftreten, wenn an irgendeiner Stelle im GUI-Browser oder Recorder ein entsprechendes WebElement verwendet wird. Sie sollten dann abbrechen können und es nochmal versuchen. Sollte der Fehler bestehen bleiben, wechseln Sie in den Default Content und laden Sie den Baum im GUI-Browser neu.

	*'''Baustein läuft erfolgreich, aber ohne Auswirkungen'''		*'''Baustein läuft erfolgreich, aber ohne Auswirkungen'''

Matilk: /* Shadow Elemente */

2023-06-02T10:07:08Z

Shadow Elemente

← Nächstältere Version		Version vom 2. Juni 2023, 10:07 Uhr
Zeile 219:		Zeile 219:

	Wenn Sie die kombinierten Pfade aufzeichnen, bzw. im GUI-Browser verwenden wollen, setzen Sie im Menü ''GUI Browser'' unter ''Aufzeichnung'' den Haken bei ''Zusammengesetzte Pfade aufzeichnen''. Damit wird für eingebettete Elemente ein zusammengesetzter Pfad relativ zum aktuellen Kontext erzeugt und angezeigt, anstatt wie bisher nur innerhalb seines eigenen Kontexts. Außerdem können Sie diese Elemente auch direkt im Recorder ansprechen oder über Follow-Mouse finden.		Wenn Sie die kombinierten Pfade aufzeichnen, bzw. im GUI-Browser verwenden wollen, setzen Sie im Menü ''GUI Browser'' unter ''Aufzeichnung'' den Haken bei ''Zusammengesetzte Pfade aufzeichnen''. Damit wird für eingebettete Elemente ein zusammengesetzter Pfad relativ zum aktuellen Kontext erzeugt und angezeigt, anstatt wie bisher nur innerhalb seines eigenen Kontexts. Außerdem können Sie diese Elemente auch direkt im Recorder ansprechen oder über Follow-Mouse finden.

			=Shadow-Elemente=
			Shadow-DOMs sind eine Möglichkeit, um Teile einer Seite vom übrigen Dokument abzukapseln. Dabei werden an ein Element versteckte Shadow-Elemente angehängt. Eine ausführlichere Erklärung finden Sie zum Beispiel hier: [https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM Using shadow DOM - Web APIs \| MDN].

			In der SeleniumWebDirverLibrary gibt es den Baustein ''[Web] Get Shadow DOM'', der die obersten Elemente liefert, die dann wie andere WebElemente verwendet werden können.

			Da die Elemente versteckt sind, werden sie vom GUI-Browser nicht direkt angezeigt. Ab expecco 23.1 kann man allerdings im Kontextmenü der Elemente im GUI-Browser einen Haken setzen, dass Shadow-Elemente gesucht werden sollen. Beim Aktualisieren der Kinder eines Elements werden sie dann angezeigt, falls vorhanden, allerdings nicht, wenn der gesamte Baum aktualisiert wird. Wenn der Haken gesetzt ist, sind die Elemente auch im Recorder verfügbar.

			==Zusammengesetzte Pfade==
			Ähnlich wie die Elemente innerhalb eines Frames kann auch auf die Shadow-Elemente direkt über zusammengesetzte Pfade zugegriffen werden. Diese Pfade können dann direkt an den Bausteinen verwendet werden, sodass der Baustein ''[Web] Get Shadow DOM'' nicht benötigt wird. Die Pfade haben die Form
			<host path>/shadowRoot/<shadow path>
			wobei ''<host path>'' den Pfad zum Element angibt, an das der Shadow-DOM angehängt wurde, und ''<shadow path>'' der Pfad innerhalb des Shadow-DOMs zum gewünschten Element ist. '/shadowRoot' dient als Marker, dass an dieser Stelle der Wechsel in den Shadow-DOM erfolgt.

	=Authentifizierungs-Alerts=		=Authentifizierungs-Alerts=

Matilk: Eingebettete Inhalte und expecco 23.1 Verbesserungen

2023-03-13T17:19:49Z

Eingebettete Inhalte und expecco 23.1 Verbesserungen

← Nächstältere Version		Version vom 13. März 2023, 17:19 Uhr
Zeile 210:		Zeile 210:
	#'''Bild an Fenster anpassen''': Skaliert den Screenshot auf eine Größe, mit der er die volle Größe des Fensters ausnutzt.		#'''Bild an Fenster anpassen''': Skaliert den Screenshot auf eine Größe, mit der er die volle Größe des Fensters ausnutzt.
	#'''Skalierung''': Ändert die Skalierung des Screenshots. Diese kann auch über Scrollen in der Anzeige bei gedrückt gehaltener Strg-Taste angepasst werden.		#'''Skalierung''': Ändert die Skalierung des Screenshots. Diese kann auch über Scrollen in der Anzeige bei gedrückt gehaltener Strg-Taste angepasst werden.
	#'''Meldungen''': Hier werden Meldungen angezeigt, bspw. wenn eine Aktion nicht aufgenommen werden konnte. Die letzte Meldung wird solange angezeigt, bis sie über den Button rechts daneben geschlossen wird.		#'''Meldungen''': Hier werden Meldungen angezeigt, bspw. wenn eine Aktion nicht aufgenommen werden konnte. Die letzte Meldung wird solange angezeigt, bis sie über den Button rechts daneben geschlossen wird.<br>'''Fenster-Tabs''': Ab expecco 23.1 werden oberhalb der Anzeige Tabs für jedes offene Fenster angezeigt, sobald eine Verbindung mehr als ein Browserfenster besitzt. Ob der Browser dieses als Tab oder in einem eigenen Fenster anzeigt, ist dabei egal. Über die Tabs im Recorder können Sie das aktuelle Fenster wechseln und diesen Wechsel auch aufzeichnen.<br>'''Frame-Kontext''': Ab expecco 23.1 sehen Sie unterhalb der Anzeige, in welchem Frame-Kontext Sie sich gerade befinden (siehe dazu den Abschnitt [[#Eingebettete_Inhalte\|Eingebettete Inhalte]]). Sie können auf die Einträge klicken, um in einen höheren Kontext zu wechseln und diesen Wechsel aufzuzeichnen. Falls Sie zusammengesetzte Pfade eingestellt haben, wird die Anzeige aktualisiert, wenn Sie ein eingebettetes Element ausgewählt haben.

			=Eingebettete Inhalte=
			In HTML ist es möglich, auf einer Seite Inhalte einer anderen einzubinden. Das gängigste Elemente dafür ist ein Iframe (Inlineframe). Auf den Inhalt eines Iframes kann ebenfalls mit Selenium zugegriffen werden, allerdings muss dazu zuerst in diesen Kontext gewechselt werden. In der SeleniumWebDriverLibrary gibt es entsprechenden Bausteine, um in den Kontext eines Iframes zu wechseln, um in den Elternkontext zu wechseln und um zurück zum Standardinhalt, also dem obersten Kontext zu wechseln. Alle Element-Bausteine lösen die angelegten Pfade immer innerhalb des aktuellen Kontexts auf. Im GUI-Browser sehen Sie für eingebettete Inhalte ein zusätzliches Element, welches sie aufklappen können um dessen Elemente zu sehen.

			==Zusammengesetzte Pfade==
			Seit expecco 23.1 gibt es die Möglichkeit, auch zusammengesetzte Pfade an den Bausteinen zu verwenden, um direkt vom Standardinhalt auf den Inhalt eines Iframes zugreifen zu können. Dazu werden einfach der Pfad zum Iframe und der Pfad innerhalb des Iframe-Inhalts zu einem zusammengesetzt. Wichtig ist hierbei, dass beim Übergang keine Elemente ausgelassen werden dürfen, d.h. der vordere Teil muss mit dem Iframe-Element enden und der hintere Teil mit ''/body'' beginnen. Dazwischen dürfen die Pfade gekürzt werden und es ist natürlich auch möglich auf diese Art beliebig tief geschachtelte Elemente zu erreichen. An den Bausteinen können beide Techniken nach belieben verwendet werden, wichtig ist nur, dass die Pfade immer in dem Kontext aufgelöst werden, in dem sich Selenium gerade befindet.

			Wenn Sie die kombinierten Pfade aufzeichnen, bzw. im GUI-Browser verwenden wollen, setzen Sie im Menü ''GUI Browser'' unter ''Aufzeichnung'' den Haken bei ''Zusammengesetzte Pfade aufzeichnen''. Damit wird für eingebettete Elemente ein zusammengesetzter Pfad relativ zum aktuellen Kontext erzeugt und angezeigt, anstatt wie bisher nur innerhalb seines eigenen Kontexts. Außerdem können Sie diese Elemente auch direkt im Recorder ansprechen oder über Follow-Mouse finden.

	=Authentifizierungs-Alerts=		=Authentifizierungs-Alerts=