This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.

Documentation Grafana k6 JavaScript API k6/browser Locator pressSequentially(text, [options])

pressSequentially(text, [options])

Focuses the element and then sends a keydown, keypress/input, and keyup event for each character in the text.

This method is useful for simulating real user typing behavior when the page has special keyboard event handling, such as input validation, autocomplete, or character counters that trigger on individual key presses. For simple text input without special keyboard handling, use fill() instead, as it’s faster and more reliable.

Returns

Examples

Basic usage

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();

  try {
    await page.goto('https://test.k6.io/browser.php');

    // Type text character by character
    const textInput = page.locator('#text1');
    await textInput.pressSequentially('Hello World');
  } finally {
    await page.close();
  }
}

Typing with delay

This example demonstrates typing text with a delay between keystrokes to simulate realistic user typing speed:

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();

  try {
    await page.goto('https://test.k6.io/browser.php');

    // Type text with 100ms delay between each character
    const searchInput = page.locator('input[type="text"]');
    await searchInput.pressSequentially('test query', { delay: 100 });
  } finally {
    await page.close();
  }
}

Best practices

1. Use fill() for simple text input: For form fields without special keyboard handling, use fill() instead as it’s significantly faster and more reliable.
2. Use pressSequentially() for interactive input: Only use pressSequentially() when testing features that require gradual typing, such as:
   • Autocomplete suggestions
   • Input validation that triggers per character
   • Character counters
   • Search-as-you-type functionality
3. Consider performance: Typing character-by-character is slower than filling text directly. Use this method only when necessary for accurate testing.
4. Handling special keys: For special keys like Enter, Tab, or Escape, use press() instead.

Related

• fill() - Fill text instantly without keyboard events
• press() - Press special keys or key combinations
• type() - Type text into an input field