# $

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

info

As opposed to the [`$`](/docs/api/browser/$.md) attached to the [browser object](/docs/api/browser.md) this command queries an element based on a root element.

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)

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')
```

WebdriverIO seamlessly traverses shadow roots when using the `$` or `$$` commands, regardless of the nesting level or shadow root mode, for example:

```
await browser.url('https://ionicframework.com/docs/usage/v8/datetime/basic/demo.html?ionic:mode=md')

await browser.$('button[aria-label="Sunday, August 4"]').click()

 await browser.$('.aux-input').getValue()
```

As of v10 this command is **strict**: if the selector resolves to more than one element within this element it throws a `StrictSelectorError` rather than silently returning the first match. Use `$$` when you expect multiple elements, pass `{ strict: false }` to opt out for a single call, or set `strictSelectors: false` in your config to opt out globally.

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 $(selector).$(selector, { strict })
```

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

| Name                             | Type                        | Details                                                                                                                                          |
| -------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `selector`                       | `String, Function, Matcher` | selector, JS Function, or Matcher object to fetch a certain element                                                                              |
| `options`<br />*optional*        | `Object`                    | command options                                                                                                                                  |
| `options.strict`<br />*optional* | `Boolean`                   | throw if the selector matches more than one element within this element (default: the `strictSelectors` config option, which defaults to `true`) |

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

example.html

```
loading...
```

[View on GitHub](<https://github.com/webdriverio/example-recipes/blob/59c122c809d44d343c231bde2af7e8456c8f086c/queryElements/example.html&#xA;>)

singleElements.js

```
loading...
```

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

singleElements.js

```
loading...
```

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

singleElements.js

```
loading...
```

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

$.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>**
