I.select()

Select a checkbox, radio button, or a select dropdown option.

If the option is already selected, this does nothing.

INFO

I.select only works with standard HTML elements:

• <input type='checkbox'>
• <input type='radio'>
• <select> dropdowns

If your application uses custom UI widgets that simulate checkboxes, radios, or dropdowns, use I.click() instead.

Usage

There are two ways to use I.select:

// select an option that is uniquely identifiable
I.select(option: string)

// select an option within a specific list
I.select(list: string, option: string)

When there are multiple lists with the same options, we recommend using I.select(list, option) to avoid ambiguity.

Parameters

Parameter	Type	Description
list	string	(optional) The group or field to select from — by text, name attribute, CSS or XPath selector
option	string	The option to select — by text, value, CSS or XPath selector

Examples

Select a checkbox

Here's a simple checkbox for illustration:

	 I agree to the terms and conditions.

Demo: Simple Checkbox

UI

HTML

To select the checkbox, use I.select() using the checkbox label, CSS or XPath:

// using checkbox label
I.select("I agree")

// using CSS
I.select("#agree-checkbox")

// using XPath
I.select("//input[name='terms']")

Select a radio button from a group

Here's a group of radio buttons for illustration:

	Door color

	Red
	Green
	Blue




	Frame color

	Red
	Green
	Blue

Demo: Radio Button Group

UI

HTML

Specify the radio button group using the visible text or name attribute:

// by visible text
I.select("Door Color", "Red")

// by name
I.select("door-color", "Red")

Specify the option to select by label, value, CSS, or XPath selector:

// by label
I.select("Door Color", "Red")

// by value
I.select("Door Color", "r")

// by CSS
I.select("Door Color", "input[value='r']")

// by XPath
I.select("Door Color", "//input[@value='r']")

Select an option from a select dropdown

Here is a <select> dropdown for illustration:

Door color


	Select color
	Red
	Green
	Blue





Frame color


	Select color
	Red
	Green
	Blue

Demo: Select Dropdowns

UI

HTML

Specify the dropdown list by label, name, CSS or XPath selector:

// using dropdown label
I.select("Door Color", "Blue")

// using dropdown name
I.select("door-clr", "Blue")

// using CSS
I.select("#door-color", "Blue")

// using XPath
I.select("//select[@name='door-clr']", "Blue")

Specify the option to select using its label, value, or CSS or XPath selector:

// using option label
I.select("Door Color", "Blue")

// using option value
I.select("Door Color", "b")

// using option CSS
I.select("#door-color", "option[value='b']")

// using option XPath
I.select("Door Color", "//option[@value='b']")