Skip to main content

await maximize()

The browser.manage().window().maximize() function in ShadowdriverJS is used to maximize the browser window. This function can be useful for ensuring that your tests have a consistent view of the page, especially when visual checks or layout-based interactions are involved.

Syntax​

await browser.manage().window().maximize();

Returns​

  • A promise that will be resolved after the window has been maximized.

Example​

Here is an example of how to use browser.manage().window().maximize() to maximize the browser window:

// Maximize the browser window
await browser.manage().window().maximize();
console.log('Browser window has been maximized.');

In this example, the browser window will be maximized, and a message will be logged to the console indicating that the window has been resized.

Notes​

  • The browser.manage().window().maximize() function waits for the window to reach its fully maximized state before resolving the promise.
  • This function is non-blocking; it does not block other operations in your test script.
  • Maximizing the window can help ensure consistent page visibility and layout, which is important for tests that involve visual checks or specific element positions.

See Also​

  • await browser.sleep(ms): Pauses the execution of the test for a specified duration.
  • await browser.refresh(): Refreshes the currently loaded page.
  • await browser.getTitle(): Retrieves the title of the current page.
  • await browser.get(url): Navigates to a specified URL.

This documentation provides an overview of the browser.manage().window().maximize() function, including its syntax, return value, and example usage.