Documentation Grafana k6 Using k6 browser Recommended practices Handle stale or dynamic elements after navigation

Handle stale or dynamic elements after navigation

Modern websites often update the DOM asynchronously after navigation or user interactions. Waiting for navigation to complete isn’t sufficient, as test scripts may still fail or attempt to interact with elements that aren’t yet available.

To avoid these issues, wait for specific elements to appear before you continue your test. Use locator APIs such as waitFor to ensure elements are ready for interaction.

This approach is especially important when you test single-page applications (SPAs) or any pages with dynamic content, where elements may be added, removed, or updated asynchronously.

Example

JavaScript Copy

import { browser } from 'k6/browser';

export const options = {
  scenarios: {
    browser: {
      executor: 'shared-iterations',
      options: {
        browser: {
          type: 'chromium',
        },
      },
    },
  },
};

export default async function () {
  const page = await browser.newPage();

  await page.goto('https://test.k6.io/browser.php');
  const text = page.locator('#input-text-hidden');
  await text.waitFor({
    state: 'hidden',
  });
}