---
title: "$(selector) | Grafana k6 documentation"
description: "Browser module: frame.$(selector) method"
---

# $(selector)

> Warning
> 
> Use locator-based [`frame.locator(selector)`](/docs/k6/next/javascript-api/k6-browser/frame/locator/) instead.

The method finds an element matching the specified selector within the frame. If no elements match the selector, the return value resolves to `null`. To wait for an element on the frame, use [locator.waitFor(\[options\])](/docs/k6/next/javascript-api/k6-browser/locator/waitfor/).

### Returns

Expand table

| Type                            | Description                                                                                                                                                          |
|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `Promise<ElementHandle | null>` | A Promise that fulfills with the [ElementHandle](/docs/k6/next/javascript-api/k6-browser/elementhandle/) of the selector when a matching element is found or `null`. |