---
title: "selectOption(selector, values[, options]) | Grafana k6 documentation"
description: "Browser module: frame.selectOption(selector, values[, options]) method"
---

# selectOption(selector, values\[, options])

> Warning
> 
> Use locator-based [`locator.selectOption()`](/docs/k6/latest/javascript-api/k6-browser/locator/selectoption/) instead.

Selects one or more options which match the values from a `<select>` element.

Expand table

| Parameter           | Type                          | Default | Description                                                                                                                                                                                                                                                       |
|---------------------|-------------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| selector            | string                        | `''`    | A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.                                                                                                                                              |
| values              | string or string\[] or object | `''`    | If the `select` has the multiple attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. Object can be made up of keys with `value`, `label` or `index`.                                    |
| options             | object                        | `null`  |                                                                                                                                                                                                                                                                   |
| options.force       | boolean                       | `false` | Setting this to `true` will bypass the actionability checks (`visible`, `stable`, `enabled`).                                                                                                                                                                     |
| options.noWaitAfter | boolean                       | `false` | If set to `true` and a navigation occurs from performing this action, it will not wait for it to complete.                                                                                                                                                        |
| options.strict      | boolean                       | `false` | When `true`, the call requires selector to resolve to a single element. If given selector resolves to more than one element, the call throws an exception.                                                                                                        |
| options.timeout     | number                        | `30000` | Maximum time in milliseconds. Pass `0` to disable the timeout. Default is overridden by the `setDefaultTimeout` option on [BrowserContext](/docs/k6/latest/javascript-api/k6-browser/browsercontext/) or [Page](/docs/k6/latest/javascript-api/k6-browser/page/). |

### Returns

Expand table

| Type                | Description                                                    |
|---------------------|----------------------------------------------------------------|
| `Promise<string[]>` | A Promise that fulfills with the list of the selected options. |