diff --git a/docs/sources/k6/next/using-k6-browser/recommended-practices/wait-dom-changes.md b/docs/sources/k6/next/using-k6-browser/recommended-practices/wait-dom-changes.md new file mode 100644 index 0000000000..902c6def49 --- /dev/null +++ b/docs/sources/k6/next/using-k6-browser/recommended-practices/wait-dom-changes.md @@ -0,0 +1,40 @@ +--- +title: 'Handling Stale or Dynamic Elements After Navigation' +description: 'Wait for elements to appear in k6 browser tests to avoid interacting with stale or dynamic content' +weight: 01 +--- + +# How To Handle Stale or Dynamic Elements After Navigation +Modern websites often update the DOM asynchronously after navigation or user interactions. Waiting for navigation to complete is not sufficient, as test scripts may still fail or attempt to interact with elements that are not yet available. Instead, wait for specific elements to appear before continuing your test. Use [locator APIs](https://grafana.com/docs/k6//javascript-api/k6-browser/locator/) such as `waitFor` to ensure elements are ready for interaction. This is especially important when testing SPAs or any pages with dynamic content, where elements may be added, removed, or updated asynchronously. + +## Example +{{< code >}} + +```javascript +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', + }); +} +``` + +{{< /code >}}