puppeteer/website/versioned_docs/version-21.0.3/api/puppeteer.locator.once.md

---
sidebar_label: Locator.once
---

# Locator.once() method

#### Signature:

```typescript
class Locator {
  once<K extends keyof LocatorEventObject>(
    eventName: K,
    handler: (event: LocatorEventObject[K]) => void
  ): this;
}
```

## Parameters

| Parameter | Type                                                                             | Description |
| --------- | -------------------------------------------------------------------------------- | ----------- |
| eventName | K                                                                                |             |
| handler   | (event: [LocatorEventObject](./puppeteer.locatoreventobject.md)\[K\]) =&gt; void |             |

**Returns:**

this