---
title: Pop-up Blocker Utility
icon: shield-ban
description: "Utility to automatically close unwanted pop-ups during test execution.\n"
sidebar:
  order: 180
---

Pop-ups are a common feature in web applications. During test execution, it is often necessary to automatically close certain pop-ups to ensure a smooth test flow. For this purpose, a JavaScript-based, in-page Pop-up Blocker has been implemented.

## Purpose and Best Practice

It is strongly recommended that any pop-ups within the tested application be deterministic and handled explicitly within the test flows. However, when working with external or black-box applications where pop-up behavior cannot be controlled, automatically closing non-critical pop-ups with this feature can help stabilize tests and reduce execution time.

## Configuration

To enable this utility, you must provide the **CSS selector** of the element that closes the pop-up (e.g., a 'Close'
button or an 'X' icon). Store this selector in your properties file using a custom key:

```properties
neodymium.popup.customPopUp = #myWindowCloseButton
```

The system will then automatically search for this specific element. As soon as the element is found, a click action
will be triggered.

:::warning[Attention]
The Pop-up Blocker is currently only implemented for **CSS selectors**.
:::

The interval in milliseconds at which the system attempts to find and close the pop-up can be configured using the
`neodymium.popupInterval` property.