Notifications

The function is to display a notification when a certain keyword appears on the page.

This feature in Auto Refresh Page lets you enter a keyword and, after each refresh, Auto Refresh Page will check the web page to see if the keyword exists. You can use a simple keyword, phrase, or even a regular expression. If the text is found, a notification displays and a sound effect is played.

Using a notification

1. Open Chrome and visit the desired URL that you want to refresh.

2. Open Auto Refresh Page, expand Advanced options, and checkmark "Show notifications".

3. Enter a keyword or regular expression to find in the page after each refresh.

4. Click "Start".

Stopping refresh after a notification

You can stop refreshing the page when a notification is found by checkmarking the option "Stop refresh", located under the "Show notifications" area. When the target keyword is found in the page, and a notification displays, refresh will stop.

Refresh will resume if you manually reload the page or navigate to the page in a new web browser session.

Notify when a keyword is NOT Found

To show a notification when a keyword is NOT found in the page, checkmark the option "Not found".

When this option is enabled, a notification will only display when the keyword is not found in the web page. This is useful for scenarios where you are not sure of the content on the page for the target refresh, but you DO know a specific keyword in the current page that will no longer be present.

For example, consider an order page that asks you to wait 10 minutes before you can place an order. The page shows the message "Please wait 10 minutes..". You want to refresh the page every 10 seconds until you are able to place an order. For this scenario, you could enter a refresh interval of "10" seconds, enable the option "Show notification", enter the keyword "Please wait", enable the option "Stop refresh", and enable the option "Not found". The web page will now refresh every 10 seconds. After each refresh, the page will be checked to see if the keyword "Please wait" is no longer visible on the page. Once the text is not found, a notification will display and refresh will stop, allowing you to place the order.

Notification delay

Depending on how fast the web page loads, you may want to check for the notification keyword only when you are certain that all web page content has loaded and displayed. To do this, you can choose to use a delay after the refresh, before the keyword is searched for within the page.

This option is useful for cases where you enter a keyword and can see it in the page, but a notification is not displaying due to the web page taking longer than expected to fully display. By specifying a delay, you can give the web page enough time to fully load and show all content, before checking for the notification keyword.

For example, enter "3" to wait 3 seconds after each refresh, before checking for the keyword in the page.

Keyword Examples

Simple keyword match

• movie

• white sneakers

Regular expression keyword match

• post\d+

• \d+/\d+/\d{4}

This first example will match "post2" or "post21" or "post68".

The second example will match "31/12/2021" or "3/8/2021".

Multiple keywords using OR

• music|audio

• youtube music|comedian films

The first example will match the words "music" or "audio".

The second example will match the words "youtube music" or "comedian films".

Keyword with a Wildcard

Order.*Ready

This example would match "Order is Ready" or "Order Now Ready" or "Order should be Ready" or "Order anything can go here Ready".

Keyword match after a delay after refresh

find this keyword after delay [3]

Each time Auto Refresh Page reloads the page, it will check the text and HTML of the page (document.body.innerHTML) for the keyword that you entered. The keyword is case-insensitive. If the keyword is found, a Chrome desktop notification will display.

Checking for a keyword in the visible text of the page

• By default, Auto Refresh Page searches for the keyword within the HTML of the page (document.body.innerHTML). This allows you to search through both visible text and HTML tags on the page. For example, you might want to show a notification when a certain DIV or IMG tag appears on the page. If you want to limit the search to just the visible text of the page (document.body.innerText), include the following at the end of your keyword: [TEXT]

For example: hello [TEXT]

Checking for a keyword with a delay after page load

• In the above keyword examples, the first two are simple keywords to find in the page. The third and fourth are regular expressions. The last one uses a timed-delay check.

• In some cases, a page may take longer to load all of its content. For example, some sites use ajax, angular, react, or other web page frameworks that dynamically load page content. For these sites, if you check for a keyword in the page immediately after a page-load, it will fail to find the keyword, since the content may not have fully loaded yet. To fix this, you can tell Auto Refresh Page to wait a couple of seconds after page-load, before checking for the keyword.