# candidates

The `candidates` option of an extract field.

An ordered list of field locators, tried in order. A field with `candidates` carries no other locator key (lint `E005`).

Type: `object[]`

## Example

```json
{
  "title": {
    "candidates": [
      {
        "testid": "title"
      },
      {
        "role": "heading",
        "name": "Product"
      },
      {
        "selector": "h1"
      }
    ]
  }
}
```

From the contract fixture `network-locator`, a program the test suite validates.