# $

The `$` command is a short and handy way in order to fetch a single element on the page.

You can also pass in an object as selector where the object contains a property `element-6066-11e4-a52e-4f735466cecf` with the value of a reference to an element. The command will then transform the reference to an extended WebdriverIO element.

Note: chaining `$` and `$$` commands only make sense when you use multiple selector strategies. You will otherwise make unnecessary requests that slow down the test (e.g. `$('body').$('div')` will trigger two request whereas `$('body div')` does literally the same with just one request)

**Note:** only use these element objects if you are certain they still exist on the page, e.g. using the `isExisting` command. WebdriverIO is unable to refetch them given that there are no selector information available.

Using the wdio testrunner this command is a global variable, see [Globals](https://webdriver.io/docs/api/globals) for more information. Using WebdriverIO within a [standalone](https://webdriver.io/docs/setuptypes#standalone-mode) script it will be located on the browser object instead (e.g. `browser.$$`).

You can chain `$` or `$$` together without wrapping individual commands into `await` in order to walk down the DOM tree, e.g.:

```
const imageSrc = await $$('div')[1].nextElement().$$('img')[2].getAttribute('src')
```

info

For more information on how to select specific elements, check out the [Selectors](/docs/selectors.md) guide.

## Usage[​](#usage "Direct link to Usage")

```
await browser.$(selector)
```

## Parameters[​](#parameters "Direct link to Parameters")

| Name       | Type                        | Details                                                             |
| ---------- | --------------------------- | ------------------------------------------------------------------- |
| `selector` | `String, Function, Matcher` | selector, JS Function, or Matcher object to fetch a certain element |

## Examples[​](#examples "Direct link to Examples")

example.html

```
loading...
```

[View on GitHub](https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html)

singleElements.js

```
loading...
```

[View on GitHub](https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L9-L10)

singleElements.js

```
loading...
```

[View on GitHub](https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L16-L25)

singleElements.js

```
loading...
```

[View on GitHub](https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/singleElements.js#L42-L46)

$.js

```
it('should use Androids DataMatcher or ViewMatcher selector', async () => {
    const menuItem = await $({
        "name": "hasEntry",
        "args": ["title", "ViewTitle"],
        "class": "androidx.test.espresso.matcher.ViewMatchers"
    });
    await menuItem.click();

    const menuItem = await $({
        "name": "hasEntry",
        "args": ["title", "ViewTitle"]
    });
    await menuItem.click();
});
```

## Returns[​](#returns "Direct link to Returns")

* **\<WebdriverIO.Element>**