---
title: "getByTitle(title[, options]) | Grafana k6 documentation"
description: "Browser module: frameLocator.getByTitle(title[, options]) method"
---

# getByTitle(title\[, options])

Returns a locator for elements with the specified `title` attribute. This method is useful for locating elements that use the `title` attribute to provide additional information, tooltips, or accessibility context.

Expand table

| Parameter       | Type             | Default | Description                                                                                                  |
|-----------------|------------------|---------|--------------------------------------------------------------------------------------------------------------|
| `title`         | string \| RegExp | \-      | Required. The title text to search for. Can be a string for exact match or a RegExp for pattern matching.    |
| `options`       | object           | `null`  |                                                                                                              |
| `options.exact` | boolean          | `false` | Whether to match the title text exactly with case sensitivity. When `true`, performs a case-sensitive match. |

## Returns

Expand table

| Type                                                        | Description                                                                                             |
|-------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
| [Locator](/docs/k6/next/javascript-api/k6-browser/locator/) | A locator object that can be used to interact with the elements matching the specified title attribute. |

## Examples

Find and interact with elements by their title attribute:

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

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

  try {
    const iframeHTML = `
      <button title="Hello World">Hi</button>
      <select title="Favorite Color">
        <option value="Red">Red</option>
        <option value="Green">Green</option>
        <option value="Blue">Blue</option>
      </select>
      <input type="checkbox" title="Check me">
    `;

    await page.setContent(`
      <iframe id="my_frame" src="data:text/html,${encodeURIComponent(iframeHTML)}"></iframe>
    `);

    const frameLocator = page.locator("#my_frame").contentFrame();

    await frameLocator.getByTitle('Hello World').click();

    await frameLocator.getByTitle('Favorite Color').selectOption('Red');

    await frameLocator.getByTitle('Check me').check();
  } finally {
    await page.close();
  }
}
```

## Common use cases

- **User interface controls:**
  
  - Toolbar buttons and action items
  - Navigation controls (previous/next, pagination)
  - Media player controls
  - Menu and drop-down triggers
- **Informational elements:**
  
  - Help icons and tooltips
  - Status indicators and badges
  - Progress indicators
  - Warning and error messages
- **Accessibility support:**
  
  - Screen reader descriptions
  - Alternative text for complex elements
  - Context-sensitive help
  - Form field explanations

## Best practices

1. **Meaningful titles**: Ensure title attributes provide clear, helpful information about the element’s purpose or content.
2. **Accessibility compliance**: Use titles to enhance accessibility, especially for elements that might not have clear visual labels.
3. **Avoid redundancy**: Don’t duplicate visible text in the title attribute unless providing additional context.
4. **Dynamic content**: When testing applications with changing title content, use flexible matching patterns or regular expressions.
5. **Tooltip testing**: Remember that title attributes often create tooltips on hover, which can be useful for UI testing.
6. **Internationalization**: Consider that title text may change in different language versions of your application.

## Related

- [frameLocator.getByRole()](/docs/k6/next/javascript-api/k6-browser/framelocator/getbyrole/) - Locate by ARIA role
- [frameLocator.getByAltText()](/docs/k6/next/javascript-api/k6-browser/framelocator/getbyalttext/) - Locate by alt text
- [frameLocator.getByLabel()](/docs/k6/next/javascript-api/k6-browser/framelocator/getbylabel/) - Locate by form labels
- [frameLocator.getByPlaceholder()](/docs/k6/next/javascript-api/k6-browser/framelocator/getbyplaceholder/) - Locate by placeholder text
- [frameLocator.getByTestId()](/docs/k6/next/javascript-api/k6-browser/framelocator/getbytestid/) - Locate by test ID
- [frameLocator.getByText()](/docs/k6/next/javascript-api/k6-browser/framelocator/getbytext/) - Locate by visible text