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

title: MessagesFunction
description: Risolve messaggi registrati, stringhe raw e valori nullish dal catalogo attivo. Riferimento API per MessagesFunction.

---

[`useMessages()`](/docs/vue/reference/composables/use-messages) restituisce questa callback. Decodifica i valori creati da [`msg()`](/docs/vue/reference/functions/msg) e accetta anche una normale stringa sorgente.

## Panoramica [#overview]

```ts
type MessagesFunction = <T extends string | null | undefined>(
  message: T,
  options?: GTStringOptions
) => T extends string ? string : T;
```

| Parametro             | Descrizione                                                                 | Tipo                                                             | Facoltativo | Predefinito |
| --------------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------------- | ----------- | ----------- |
| [`message`](#message) | Messaggio codificato, stringa sorgente non elaborata, `null` o `undefined`. | `T extends string \| null \| undefined`                          | No          | —           |
| [`options`](#options) | Contesto per una stringa sorgente non elaborata.                            | [`GTStringOptions`](/docs/vue/reference/types/gt-string-options) | Sì          | `{}`        |

## Parametri [#parameters]

### `message`

**Tipo** `T extends string | null | undefined` · **Obbligatorio**

Passa un valore restituito da [`msg()`](/docs/vue/reference/functions/msg), una normale stringa sorgente o un valore nullish. Le stringhe codificate contengono la sorgente originale, l&#39;hash e un `$context` facoltativo.

### `options`

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

Per una stringa raw, `$context` contribuisce all&#39;hash del catalogo. Per un valore codificato, hanno la precedenza i metadati memorizzati da [`msg()`](/docs/vue/reference/functions/msg) e le opzioni passate nel punto di chiamata vengono ignorate.

## Valore restituito [#returns]

| Input       | Tipo restituito | Comportamento                                                               |
| ----------- | --------------- | --------------------------------------------------------------------------- |
| `string`    | `string`        | Restituisce la traduzione del catalogo o il fallback sorgente decodificato. |
| `null`      | `null`          | Restituisce `null` invariato.                                               |
| `undefined` | `undefined`     | Restituisce `undefined` invariato.                                          |

Il generico condizionale preserva i tipi di input nullish, consentendo il passaggio dei messaggi facoltativi senza un controllo separato.

## Risoluzione [#resolution]

Per un messaggio codificato, il callback decodifica il sorgente memorizzato, `$context` e l&#39;hash precalcolato prima del lookup. Per una normale stringa, calcola l&#39;hash a partire dalla stringa e da `$context` nel punto di chiamata.

Entrambi i percorsi richiedono un valore di tipo stringa nel catalogo attivo. Le voci mancanti o che non sono stringhe restituiscono il testo sorgente. Non vengono eseguite formattazione ICU né interpolazione; le parentesi graffe rimangono letterali.

Richiama il callback da un template Vue, un valore calcolato o un effetto reattivo quando il risultato deve aggiornarsi dopo che un plugin [`createGT()`](/docs/vue/reference/functions/create-gt) carica un catalogo o modifica l&#39;impostazione regionale.

## Esempio [#example]

```vue title="src/PageTitle.vue"
<script setup lang="ts">
import { msg, useMessages } from 'gt-vue';

const title = msg('Settings', { $context: 'page title' });
const m = useMessages();
</script>

<template>
  <h1>{{ m(title) }}</h1>
</template>
```