NotificationPage API

Page object for the RHDH notifications page.

Import

import { NotificationPage } from "@red-hat-developer-hub/e2e-test-utils/pages";

Constructor

new NotificationPage(page: Page, uiHelper?: UIhelper)

Creates a new NotificationPage instance. When uiHelper is omitted, an internal UIhelper is created.

Parameter	Type	Description
page	Page	Playwright Page object
uiHelper	UIhelper	Optional fixture UIhelper for shared wait/navigation behavior

Supports both MUI (legacy) and BUI (new frontend system) selectors.

Methods

Navigation

navigateToNotifications()

async navigateToNotifications(): Promise<void>

Navigate to the notifications page via the sidebar (with /notifications fallback), dismiss toasts, and wait until the page is ready.

Notification Selection

selectAllNotifications()

async selectAllNotifications(): Promise<void>

Select all notifications using the header checkbox.

selectNotification(textOrNth?)

async selectNotification(
  textOrNth?: string | RegExp | number,
): Promise<void>

Select a notification by row title or by checkbox index.

Parameter	Type	Description
textOrNth	string | RegExp	Row title to select (preferred)
textOrNth	number	Zero-based checkbox index (legacy)

Notification Content

notificationContains(text)

async notificationContains(text: string | RegExp): Promise<void>

Verify a notification contains specific text. Automatically expands the table to show 20 rows.

Parameter	Type	Description
text	string | RegExp	Text or pattern to find

Example:

await notificationPage.notificationContains("Build completed");
await notificationPage.notificationContains(/Pipeline.*succeeded/);

clickNotificationHeadingLink(text)

async clickNotificationHeadingLink(text: string | RegExp): Promise<void>

Click on a notification heading link.

Parameter	Type	Description
text	string | RegExp	Notification heading text to click

Mark as Read/Unread

markAllNotificationsAsRead()

async markAllNotificationsAsRead(): Promise<void>

Mark all notifications as read. If no notifications exist, does nothing.

markLastNotificationAsRead()

async markLastNotificationAsRead(): Promise<void>

Mark the most recent notification as read.

markNotificationAsRead(text)

async markNotificationAsRead(text: string): Promise<void>

Mark a specific notification as read by its text content.

Parameter	Type	Description
text	string	Text to identify the notification

markLastNotificationAsUnRead()

async markLastNotificationAsUnRead(): Promise<void>

Mark the most recent notification as unread.

Save for Later

saveSelected()

async saveSelected(): Promise<void>

Save the currently selected notification for later.

saveAllSelected()

async saveAllSelected(): Promise<void>

Save all selected notifications for later.

Filtering and Views

selectSeverity(severity?)

async selectSeverity(severity?: string): Promise<void>

Filter notifications by severity.

Parameter	Type	Default	Description
severity	string	""	Severity level (e.g., "critical", "high", "normal")

viewSaved()

async viewSaved(): Promise<void>

Switch to viewing saved notifications.

viewRead()

async viewRead(): Promise<void>

Switch to viewing read notifications.

viewUnRead()

async viewUnRead(): Promise<void>

Switch to viewing unread notifications.

Sorting

sortByOldestOnTop()

async sortByOldestOnTop(): Promise<void>

Sort notifications with oldest first.

sortByNewestOnTop()

async sortByNewestOnTop(): Promise<void>

Sort notifications with newest first (default).

Complete Example

import { test, expect } from "@playwright/test";
import { NotificationPage } from "@red-hat-developer-hub/e2e-test-utils/pages";

test("manage notifications", async ({ page }) => {
  const notificationPage = new NotificationPage(page);

  // Navigate to notifications
  await notificationPage.navigateToNotifications();

  // Check for a specific notification
  await notificationPage.notificationContains("Build completed successfully");

  // Filter by severity
  await notificationPage.selectSeverity("high");

  // Select and mark as read
  await notificationPage.selectNotification(0);
  await notificationPage.markLastNotificationAsRead();

  // Save important notifications
  await notificationPage.selectAllNotifications();
  await notificationPage.saveAllSelected();

  // View saved notifications
  await notificationPage.viewSaved();

  // Sort by oldest
  await notificationPage.sortByOldestOnTop();
});

test("clear all notifications", async ({ page }) => {
  const notificationPage = new NotificationPage(page);

  await notificationPage.navigateToNotifications();
  await notificationPage.markAllNotificationsAsRead();
});

Related Pages

• NotificationPage Guide - Detailed usage guide