---
title: "getByAltText(altText[, options]) | Grafana k6 documentation"
description: "Browser module: locator.getByAltText(altText[, options]) method"
---

# getByAltText(altText\[, options])

Returns a locator for elements with the specified alt text. This method is useful for locating images and other elements that have an `alt` attribute, making your tests more accessible and user-focused.

Expand table

| Parameter       | Type             | Default | Description                                                                                                |
|-----------------|------------------|---------|------------------------------------------------------------------------------------------------------------|
| `altText`       | string \| RegExp | \-      | Required. The alt 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 alt text exactly with case sensitivity. When `true`, performs a case-sensitive match. |

## Returns

Expand table

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

## Examples

### Basic alt text matching

Find and click an image by its alt text:

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

```javascript
import { browser } from 'k6/browser';

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

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

  try {
    await page.goto('https://quickpizza.grafana.com');

    const logo = page.locator(':root').getByAltText('LOGO');
    await logo.waitFor();

    await logo.click();
    await page.waitForLoadState();
  } finally {
    await page.close();
  }
}
```

### Exact alt text matching

Use exact matching for precise alt text:

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

```javascript
import { browser } from 'k6/browser';

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

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

  try {
    await page.goto('https://quickpizza.grafana.com');

    const logo = page.locator(':root').getByAltText('logo', { exact: true });
    await logo.waitFor();

    await logo.click();
    await page.waitForLoadState();
  } finally {
    await page.close();
  }
}
```

### Using regular expressions

Find images using pattern matching:

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

```javascript
import { browser } from 'k6/browser';

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

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

  try {
    await page.goto('https://quickpizza.grafana.com');

    const logo = page.locator(':root').getByAltText(/logo/s);
    await logo.waitFor();

    await logo.click();
    await page.waitForLoadState();
  } finally {
    await page.close();
  }
}
```

## Common use cases

- **Image testing:**
  
  - Testing image alt text for accessibility compliance
  - Interacting with clickable images/banners
- **Accessibility testing:**
  
  - Ensuring all images have meaningful alt text
  - Testing screen reader compatibility
  - Validating WCAG compliance
- **UI interaction:**
  
  - Clicking on logo images to navigate home
  - Selecting images in galleries or carousels
  - Interacting with image-based buttons

## Best practices

1. **Use descriptive alt text**: When creating tests, ensure your application uses meaningful alt text that describes the image content or function.
2. **Prefer exact matches**: Use `exact: true` when you need precise matching to avoid false positives.
3. **Accessibility-first**: Using `getByAltText()` encourages better accessibility practices by ensuring images have proper alt attributes.
4. **Regular expressions for patterns**: Use RegExp for flexible matching when dealing with dynamic or numbered content.
5. **Combine with assertions**: Always verify that the located elements behave as expected using assertions.

## Related

- [locator.getByRole()](/docs/k6/latest/javascript-api/k6-browser/locator/getbyrole/) - Locate by ARIA role
- [locator.getByLabel()](/docs/k6/latest/javascript-api/k6-browser/locator/getbylabel/) - Locate by form labels
- [locator.getByPlaceholder()](/docs/k6/latest/javascript-api/k6-browser/locator/getbyplaceholder/) - Locate by placeholder text
- [locator.getByTestId()](/docs/k6/latest/javascript-api/k6-browser/locator/getbytestid/) - Locate by test ID
- [locator.getByTitle()](/docs/k6/latest/javascript-api/k6-browser/locator/getbytitle/) - Locate by title attribute
- [locator.getByText()](/docs/k6/latest/javascript-api/k6-browser/locator/getbytext/) - Locate by visible text