目的の要素を直接特定するのは困難だが、別の特定可能な要素からの相対位置で特定できる場合に使う。
| 記法 | 説明 |
| ---------------- | ------------------------ |
| `:right-of(...)` | 指定要素の右にある要素 |
| `:left-of(...)` | 指定要素の左にある要素 |
| `:above(...)` | 指定要素の上にある要素 |
| `:below(...)` | 指定要素の下にある要素 |
| `:near(...)` | 指定要素の近くにある要素 |
```ts
// Nameという文字列の右側にある<button>をクリック
await page.locator('button:right-of(:text("Name"))').click();
```
候補が複数ある場合は、近い順に結果が返却される。`.first()`などで最も近い要素を取得すればいい。
Not found
This page does not exist