# vue: GTFunction
URL: https://generaltranslation.com/it/docs/vue/reference/types/gt-function.mdx
---

title: GTFunction
description: Descrive la callback sincrona utilizzata per le ricerche nel catalogo plain-string di Vue. Riferimento API per GTFunction.

---

La callback restituita da [`useGT()`](/docs/vue/reference/composables/use-gt) e l'esportazione [`t()`](/docs/vue/reference/functions/t) a livello di modulo condividono questa firma. Differiscono per la gestione dello stato e la disponibilità, ma restituiscono lo stesso risultato di ricerca.

## Panoramica [#overview]

```ts
type GTFunction = (
  message: string,
  options?: GTStringOptions
) => string;
```

| Parametro             | Descrizione                                            | Tipo                                                             | Facoltativo | Predefinito |
| --------------------- | ------------------------------------------------------ | ---------------------------------------------------------------- | ----------- | ----------- |
| [`message`](#message) | Stringa sorgente da tradurre.                          | `string`                                                         | No          | —           |
| [`options`](#options) | Contesto facoltativo usato nell'hash del catalogo. | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Sì          | `{}`        |

## Parametri [#parameters]

### `message`

**Tipo** `string` · **Obbligatorio**

Il testo sorgente letterale utilizzato per calcolare un hash `STRING` semplice. Le parentesi graffe rimangono parte del testo; non sono placeholder di interpolazione.

### `options`

**Tipo** [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) · **Facoltativo** · **Predefinito** `{}`

È supportato solo `$context`, che disambigua stringhe sorgente identiche.

## Valore restituito [#returns]

**Tipo** `string`

Restituisce il valore stringa del catalogo attivo per l'hash calcolato. Se la voce è assente o il valore del catalogo non è una stringa, restituisce `message` invariato.

Il lookup è sincrono e non esegue operazioni di rete, elaborazione ICU né interpolazione.

## Implementazioni [#implementations]

| API                                                 | Origine dello stato                                                                                              | Aggiornamenti dell’impostazione regionale                                                                                                                                     |
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`useGT()`](/docs/vue/reference/composables/use-gt) | Il [`GTPlugin`](/docs/vue/reference/types/gt-plugin) installato nell’app Vue corrente.                           | Richiama il callback da un template, un valore calcolato o un effetto reattivo per rieseguirlo quando un plugin reattivo cambia impostazione regionale o carica un catalogo.  |
| [`t()`](/docs/vue/reference/functions/t)            | Il runtime globale del browser creato da [`initializeGTSPA()`](/docs/vue/reference/functions/initialize-gt-spa). | I risultati definiti a livello di modulo si aggiornano solo dopo che il setter dell’impostazione regionale della SPA ricarica la pagina e i moduli vengono valutati di nuovo. |

Chiamare [`useGT()`](/docs/vue/reference/composables/use-gt) senza un plugin installato genera un’eccezione quando il composabile tenta di accedere allo stato. Anche chiamare [`t()`](/docs/vue/reference/functions/t) sul server o prima del completamento dell’inizializzazione della SPA genera un’eccezione.

## Esempio [#example]

```ts
import type { GTFunction } from 'gt-vue';

function translateNavigation(gt: GTFunction) {
  return {
    home: gt('Home'),
    settings: gt('Settings'),
  };
}
```