Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added example code to windows and modified text #1754

Merged
merged 6 commits into from
Jun 16, 2024
Merged

Added example code to windows and modified text #1754

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
048e7e7
added example code for windows and switched text order. modified some…
pallavigitwork Jun 12, 2024
9a0da96
fixed tab pane hugo error
pallavigitwork Jun 12, 2024
815374f
Merge branch 'trunk' into windowExampleDocs
harsha509 Jun 14, 2024
e4848b6
Merge branch 'trunk' into windowExampleDocs
harsha509 Jun 15, 2024
6bd1b54
Merge branch 'trunk' into windowExampleDocs
harsha509 Jun 15, 2024
8726be4
Merge branch 'trunk' into windowExampleDocs
harsha509 Jun 16, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 44 additions & 3 deletions examples/java/src/test/java/dev/selenium/interactions/WindowsTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,48 @@
package dev.selenium.interactions;

import dev.selenium.BaseTest;
import org.openqa.selenium.*;
import org.openqa.selenium.chrome.ChromeDriver;
import java.time.Duration;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class WindowsTest extends BaseTest {
public class WindowsTest {

}
@Test
public void windowsExampleCode() {

WebDriver driver = new ChromeDriver();
driver.manage().timeouts().implicitlyWait(Duration.ofMillis(500));
// Navigate to Url
driver.get("https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html");
//fetch handle of this
String currHandle=driver.getWindowHandle();
assertNotNull(currHandle);

//click on link to open a new window
driver.findElement(By.linkText("Open new window")).click();
//fetch handles of all windows, there will be two, [0]- default, [1] - new window
Object[] windowHandles=driver.getWindowHandles().toArray();
driver.switchTo().window((String) windowHandles[1]);
//assert on title of new window
String title=driver.getTitle();
assertEquals("Simple Page",title);

//closing current window
driver.close();
//Switch back to the old tab or window
driver.switchTo().window((String) windowHandles[0]);

//Opens a new tab and switches to new tab
driver.switchTo().newWindow(WindowType.TAB);
assertEquals("",driver.getTitle());

//Opens a new window and switches to new window
driver.switchTo().newWindow(WindowType.WINDOW);
assertEquals("",driver.getTitle());

//quitting driver
driver.quit(); //close all windows

}
}
161 changes: 67 additions & 94 deletions website_and_docs/content/documentation/webdriver/interactions/windows.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,9 @@ current window by using:

{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" >}}driver.getWindowHandle();{{< /tab >}}
{{< tab header="Java" text=true >}}
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/interactions/WindowsTest.java#L16-L20" >}}
{{< /tab >}}
{{< tab header="Python" >}}driver.current_window_handle{{< /tab >}}
{{< tab header="CSharp" >}}driver.CurrentWindowHandle;{{< /tab >}}
{{< tab header="Ruby" >}}driver.window_handle{{< /tab >}}
Expand All @@ -33,40 +35,15 @@ Clicking a link which opens in a
<a href="https://seleniumhq.github.io" target="_blank"> new window</a>
will focus the new window or tab on screen, but WebDriver will not know which
window the Operating System considers active. To work with the new window
you will need to switch to it. If you have only two tabs or windows open,
and you know which window you start with, by the process of elimination
you can loop over both windows or tabs that WebDriver can see, and switch
to the one which is not the original.

However, Selenium 4 provides a new api [NewWindow](#create-new-window-or-new-tab-and-switch)
harsha509 marked this conversation as resolved.
Show resolved Hide resolved
which creates a new tab (or) new window and automatically switches to it.
you will need to switch to it. For this, we fetch all window handles,
and store them in an array. The array position fills in the order the
window is launched. So first position will be default browser, and so on.

{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" >}}
//Store the ID of the original window
String originalWindow = driver.getWindowHandle();

//Check we don't have other windows open already
assert driver.getWindowHandles().size() == 1;

//Click the link which opens in a new window
driver.findElement(By.linkText("new window")).click();

//Wait for the new window or tab
wait.until(numberOfWindowsToBe(2));

//Loop through until we find a new window handle
for (String windowHandle : driver.getWindowHandles()) {
if(!originalWindow.contentEquals(windowHandle)) {
driver.switchTo().window(windowHandle);
break;
}
}

//Wait for the new tab to finish loading content
wait.until(titleIs("Selenium documentation"));
{{< /tab >}}
{{< tab header="Java" text=true >}}
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/interactions/WindowsTest.java#L22-L29" >}}
{{< /tab >}}
{{< tab header="Python" >}}
from selenium import webdriver
from selenium.webdriver.support.ui import WebDriverWait
Expand Down Expand Up @@ -204,60 +181,6 @@ wait.until(titleIs("Selenium documentation"))
{{< /tab >}}
{{< /tabpane >}}

### Create new window (or) new tab and switch
Creates a new window (or) tab and will focus the new window or tab on screen.
You don't need to switch to work with the new window (or) tab. If you have more than two windows
(or) tabs opened other than the new window, you can loop over both windows or tabs that WebDriver can see,
and switch to the one which is not the original.

__Note: This feature works with Selenium 4 and later versions.__

{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" >}}
// Opens a new tab and switches to new tab
driver.switchTo().newWindow(WindowType.TAB);

// Opens a new window and switches to new window
driver.switchTo().newWindow(WindowType.WINDOW);
{{< /tab >}}
{{< tab header="Python" >}}
# Opens a new tab and switches to new tab
driver.switch_to.new_window('tab')

# Opens a new window and switches to new window
driver.switch_to.new_window('window')
{{< /tab >}}
{{< tab header="CSharp" >}}
// Opens a new tab and switches to new tab
driver.SwitchTo().NewWindow(WindowType.Tab)

// Opens a new window and switches to new window
driver.SwitchTo().NewWindow(WindowType.Window)
{{< /tab >}}
{{% tab header="Ruby" text=true %}}
Opens a new tab and switches to new tab:
{{< gh-codeblock path="/examples/ruby/spec/interactions/windows_spec.rb#L9" >}}

Opens a new window and switches to new window:
{{< gh-codeblock path="/examples/ruby/spec/interactions/windows_spec.rb#L15" >}}
{{% /tab %}}
{{< tab header="JavaScript" text=true >}}
Opens a new tab and switches to new tab
{{< gh-codeblock path="examples/javascript/test/interactions/windows.spec.js#L70" >}}

Opens a new window and switches to new window:
{{< gh-codeblock path="examples/javascript/test/interactions/windows.spec.js#L75" >}}
{{< /tab >}}
{{< tab header="Kotlin" >}}
// Opens a new tab and switches to new tab
driver.switchTo().newWindow(WindowType.TAB)

// Opens a new window and switches to new window
driver.switchTo().newWindow(WindowType.WINDOW)
{{< /tab >}}
{{< /tabpane >}}

### Closing a window or tab

When you are finished with a window or tab _and_ it is not the
Expand All @@ -268,13 +191,9 @@ handle stored in a variable. Put this together and you will get:

{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" >}}
//Close the tab or window
driver.close();

//Switch back to the old tab or window
driver.switchTo().window(originalWindow);
{{< /tab >}}
{{< tab header="Java" text=true >}}
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/interactions/WindowsTest.java#L31-L34" >}}
{{< /tab >}}
{{< tab header="Python" >}}
#Close the tab or window
driver.close()
Expand Down Expand Up @@ -318,14 +237,68 @@ window will leave WebDriver executing on the now closed page, and will
trigger a **No Such Window Exception**. You must switch
back to a valid window handle in order to continue execution.

### Create new window (or) new tab and switch
Creates a new window (or) tab and will focus the new window or tab on screen.
You don't need to switch to work with the new window (or) tab. If you have more than two windows
(or) tabs opened other than the new window, you can loop over both windows or tabs that WebDriver can see,
and switch to the one which is not the original.

__Note: This feature works with Selenium 4 and later versions.__

{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" text=true >}}
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/interactions/WindowsTest.java#L36-L42" >}}
{{< /tab >}}
{{< tab header="Python" >}}
# Opens a new tab and switches to new tab
driver.switch_to.new_window('tab')

# Opens a new window and switches to new window
driver.switch_to.new_window('window')
{{< /tab >}}
{{< tab header="CSharp" >}}
// Opens a new tab and switches to new tab
driver.SwitchTo().NewWindow(WindowType.Tab)

// Opens a new window and switches to new window
driver.SwitchTo().NewWindow(WindowType.Window)
{{< /tab >}}
{{% tab header="Ruby" text=true %}}
Opens a new tab and switches to new tab:
{{< gh-codeblock path="/examples/ruby/spec/interactions/windows_spec.rb#L9" >}}

Opens a new window and switches to new window:
{{< gh-codeblock path="/examples/ruby/spec/interactions/windows_spec.rb#L15" >}}
{{% /tab %}}
{{< tab header="JavaScript" text=true >}}
Opens a new tab and switches to new tab
{{< gh-codeblock path="examples/javascript/test/interactions/windows.spec.js#L70" >}}

Opens a new window and switches to new window:
{{< gh-codeblock path="examples/javascript/test/interactions/windows.spec.js#L75" >}}
{{< /tab >}}
{{< tab header="Kotlin" >}}
// Opens a new tab and switches to new tab
driver.switchTo().newWindow(WindowType.TAB)

// Opens a new window and switches to new window
driver.switchTo().newWindow(WindowType.WINDOW)
{{< /tab >}}
{{< /tabpane >}}



### Quitting the browser at the end of a session

When you are finished with the browser session you should call quit,
instead of close:

{{< tabpane langEqualsHeader=true >}}
{{< badge-examples >}}
{{< tab header="Java" >}}driver.quit();{{< /tab >}}
{{< tab header="Java" text=true >}}
{{< gh-codeblock path="examples/java/src/test/java/dev/selenium/interactions/WindowsTest.java#L44-L45" >}}
{{< /tab >}}
{{< tab header="Python" >}}driver.quit(){{< /tab >}}
{{< tab header="CSharp" >}}driver.Quit();{{< /tab >}}
{{< tab header="Ruby" >}}driver.quit{{< /tab >}}
Expand Down
Loading
Loading