# Referenza tal-metodi

> L-interfaċċa pubblika sħiħa tal-klijent Entase – prenotazzjoni, sottoskrizzjoni għall-avvenimenti, getters u setters waqt l-eżekuzzjoni, u teardown.

L-interfaċċa pubblika sħiħa ta’ istanza ta’ `Entase`.

## Prenotazzjoni

| Metodu | Deskrizzjoni |
|---|---|
| `book(eventID, options?)` | Jiftaħ il-checkout għal avveniment. Ara [Il-ftuħ tal-checkout](/developers/js-client/opening-the-checkout.md). |

## Avvenimenti

| Metodu | Deskrizzjoni |
|---|---|
| `on(name, callback)` | Jirreġistra callback. Waħda għal kull isem ta’ avveniment – ara [Avvenimenti](/developers/js-client/events.md). |
| `off(name, callback?)` | Ineħħi l-callback irreġistrata għal isem. L-argument callback jiġi injorat. |

It-tnejn jaċċettaw string separata bi spazji jew array ta’ ismijiet.

## Lokal

| Metodu | Deskrizzjoni |
|---|---|
| `getLocale()` | Jirritorna l-valur ikkonfigurat, inkluż il-litterali `'auto'` jekk dak ikun il-valur issettjat. |
| `setLocale(locale)` | Ibiddel il-lingwa tal-checkout għal prenotazzjonijiet sussegwenti. |

`getLocale()` jirrapporta l-konfigurazzjoni, mhux ir-riżoluzzjoni – bil-valur awtomatiku jirritorna `'auto'`, mhux il-lingwa li fil-fatt se tintuża. Il-valur `'auto'` jiġi riżolt fil-mument li jissejjaħ `book()`, mill-attribut `lang` tal-element `<html>` tiegħek, għalhekk bidla fil-lingwa tal-paġna wara li jinħoloq il-klijent tiġi applikata mingħajr ebda azzjoni oħra.

## Modalità tal-checkout

| Metodu | Deskrizzjoni |
|---|---|
| `getCheckoutMode()` | Jirritorna l-modalità riżolta, `'pane'` jew `'popup'` – qatt `'auto'`. |
| `setCheckoutMode(mode)` | Jissettja l-modalità. `'auto'` jerġa’ jwettaq id-detezzjoni; valur mhux rikonoxxut jiġi injorat. |

Ara [Modalitajiet tal-checkout](/developers/js-client/checkout-modes.md).

## Traċċar

| Metodu | Deskrizzjoni |
|---|---|
| `getTracking()` | Jirritorna l-oġġett attwali tal-parametri tat-traċċar. |
| `setTracking(tprm)` | Jissostitwixxi l-parametri tat-traċċar. Mhux amalgamati – għaddi s-sett sħiħ. |

Ara [Traċċar u kunsens](/developers/js-client/tracking-and-consent.md).

## Pożizzjonament tal-pop-up

| Metodu | Deskrizzjoni |
|---|---|
| `getTopWindowCenter()` | Jirritorna `{ top, left }`, il-punt li fuqu jiġi ċċentrat il-pop-up. |
| `setTopWindowCenter(top, left)` | Iċċaqlaq dak il-punt. |

Il-punt ċentrali jiġi kkalkulat darba waħda, meta tinħoloq l-istanza, mill-pożizzjoni tat-tieqa tal-browser fuq l-iskrin. Ma jiġix ikkalkulat mill-ġdid meta l-viżitatur iċċaqlaq jew jibdel id-daqs tat-tieqa, għalhekk fuq paġna li tibqa’ miftuħa għal żmien twil pop-up jista’ jinfetaħ ’il bogħod mit-tieqa attwali. Ikkalkulah mill-ġdid qabel il-prenotazzjoni jekk dan huwa importanti:

```js
entase.setTopWindowCenter(
  window.screenTop + (window.innerHeight / 2),
  window.screenLeft + (window.innerWidth / 2)
);
```

Dan ma għandu l-ebda effett fil-modalità pane.

## Teardown

| Metodu | Deskrizzjoni |
|---|---|
| `destroy()` | Ineħħi l-listeners tat-tieqa tal-klijent. L-istanza ma tistax terġa’ tintuża. |

Sejjaħlu meta l-komponent jew il-veduta li tippossjedi l-istanza ma tibqax teżisti. Wara dan, `book()` jirreġistra żball u ma jagħmel xejn – oħloq istanza ġdida minflok.
