---
title: "first() | Grafana k6 documentation"
description: "Browser module: locator.first method"
---

# first()

Returns a [Locator](/docs/k6/latest/javascript-api/k6-browser/locator/) to the first matching element.

### Returns

Expand table

| Type                                                          | Description                                               |
|---------------------------------------------------------------|-----------------------------------------------------------|
| [Locator](/docs/k6/latest/javascript-api/k6-browser/locator/) | The first element `Locator` associated with the selector. |

### Example

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

```javascript
import { expect } from 'https://jslib.k6.io/k6-testing/0.6.1/index.js';
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();
  await page.goto('https://quickpizza.grafana.com');

  await expect(await page.locator('p').first()).toContainText('QuickPizza');

  await page.close();
}
```
