---
title: select
comments: true
description: ''
---

Select an option within a `<select>` DOM element.

# Syntax

```javascript
.select(value)
.select(values)
.select(value, options)
.select(values, options)
```

## Usage

`.select()` requires being chained off another cy command that *yields* a `<select>` DOM element.

**{% fa fa-check-circle green %} Valid Usage**

```javascript
cy.get('select').select('user-1') // Select the 'user-1' option
```

**{% fa fa-exclamation-triangle red %} Invalid Usage**

```javascript
cy.select('John Adams')  // Errors, cannot be chained off 'cy'
cy.location().select()   // Errors, 'location' does not yield <select> element
```


## Arguments

**{% fa fa-angle-right %} value**  ***(String)***

The `value` or text content of the option to be selected.

**{% fa fa-angle-right %} values**  ***(Array)***

An array of `values` or text contents of the options to be selected.

**{% fa fa-angle-right %} options**  ***(Object)***

Pass in an options object to change the default behavior of `.select()`.

Option | Default | Notes
--- | --- | ---
`force` | `false` | Forces select, disables error checking prior to select
`interval` | `50` | Interval which to retry a select
`timeout` | [`defaultCommandTimeout`](https://on.cypress.io/guides/configuration#timeouts) | Total time to retry the select
`log` | `true` | whether to display command in command log


## Yields

`.select()` yields the new DOM elements selected.

## Timeout

`.select()` will continue to select the options for the duration of the [`defaultCommandTimeout`](https://on.cypress.io/guides/configuration#timeouts)

# Examples

## Text Content

**Select the option with the text `apples`**

```html
<select>
  <option value="456">apples</option>
  <option value="457">oranges</option>
  <option value="458">bananas</option>
</select>
```

```javascript
// yields <option value="456">apples</option>
cy.get('select').select('apples')
```

## Value

**Select the option with the value "456"**

```html
<select>
  <option value="456">apples</option>
  <option value="457">oranges</option>
  <option value="458">bananas</option>
</select>
```

```javascript
// yields <option value="456">apples</option>
cy.get('select').select('456')
```

## Select multiple options

**Select the options with the texts "apples" and "bananas"**

```html
<select multiple>
  <option value="456">apples</option>
  <option value="457">oranges</option>
  <option value="458">bananas</option>
</select>
```

```javascript
cy.get('select').select(['apples', 'bananas'])
```

**Select the options with the values "456" and "457"**

```html
<select multiple>
  <option value="456">apples</option>
  <option value="457">oranges</option>
  <option value="458">bananas</option>
</select>
```

```javascript
cy.get('select').select(['456', '457'])
```

# Command Log

**Select the option with the text "Homer Simpson"**

```javascript
cy.get('select').select('Homer Simpson')
```

The commands above will display in the command log as:

<img width="575" alt="screen shot 2015-11-29 at 1 17 27 pm" src="https://cloud.githubusercontent.com/assets/1271364/11459044/a2fd8fca-969b-11e5-8d23-3a118b82b5de.png">

When clicking on `select` within the command log, the console outputs the following:

<img width="560" alt="screen shot 2015-11-29 at 1 17 45 pm" src="https://cloud.githubusercontent.com/assets/1271364/11459045/a6b3bde2-969b-11e5-9357-272ea9684987.png">

# See also

- [click](https://on.cypress.io/api/click)