Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilità integrate
<a name="built-in-util-js"></a>

La `util` variabile contiene metodi di utilità generali per aiutarvi a lavorare con i dati. Se non diversamente specificato, tutte le utilità usano il set di caratteri UTF-8.

## Utilità di codifica
<a name="utility-helpers-in-encoding"></a>

### Elenco degli strumenti di codifica
<a name="utility-helpers-in-encoding-list-js"></a>

 **`util.urlEncode(String)`**  
Restituisce la stringa di input come stringa codificata `application/x-www-form-urlencoded`.

 **`util.urlDecode(String)`**  
Decodifica una stringa codificata `application/x-www-form-urlencoded` nella relativa forma non codificata.

**`util.base64Encode(string) : string`**  
Codifica l'input in una stringa con codifica base64.

**`util.base64Decode(string) : string`**  
Decodifica i dati da una stringa con codifica base64.

## Utilità per la generazione di ID
<a name="utility-helpers-in-id-gen-js"></a>

### Elenco di utilità per la generazione di ID
<a name="utility-helpers-in-id-gen-list-js"></a>

 **`util.autoId()`**  
Restituisce un valore UUID generato casualmente a 128 bit.

**`util.autoUlid()`**  
Restituisce un ULID (Universally Unique Lexicographically Sortable Identifier) generato casualmente a 128 bit.

**`util.autoKsuid()`**  
Restituisce un KSUID (K-Sortable Unique Identifier) base62 generato casualmente a 128 bit codificato come String con una lunghezza di 27.

## Utili di errore
<a name="utility-helpers-in-error-js"></a>

### Elenco delle utilità di errore
<a name="utility-helpers-in-error-list-js"></a>

 **`util.error(String, String?, Object?, Object?)`**  
Genera un errore personalizzato. Può essere usato nei modelli di mappatura di richieste o risposte se il modello rileva un errore nella richiesta o nel risultato della chiamata. Inoltre, è `errorType` possibile specificare un `data` campo, un `errorInfo` campo e un campo. Il valore di `data` verrà aggiunto al blocco `error` corrispondente all'interno di `errors` nella risposta di GraphQL.  
`data`verrà filtrato in base al set di selezione dell'interrogazione. Il valore di `errorInfo` verrà aggiunto al blocco `error` corrispondente all'interno di `errors` nella risposta di GraphQL.  
`errorInfo`**non** verrà filtrato in base al set di selezione delle interrogazioni.

 **`util.appendError(String, String?, Object?, Object?)`**  
Aggiunge un errore personalizzato. Può essere usato nei modelli di mappatura di richieste o risposte se il modello rileva un errore nella richiesta o nel risultato della chiamata. Inoltre, è `errorType` possibile specificare un `data` campo, un `errorInfo` campo e un campo. A differenza di `util.error(String, String?, Object?, Object?)`, la valutazione del modello non viene interrotta, in modo che i dati possano essere restituiti al chiamante. Il valore di `data` verrà aggiunto al blocco `error` corrispondente all'interno di `errors` nella risposta di GraphQL.  
`data`verrà filtrato in base al set di selezione dell'interrogazione. Il valore di `errorInfo` verrà aggiunto al blocco `error` corrispondente all'interno di `errors` nella risposta di GraphQL.  
`errorInfo`**non** verrà filtrato in base al set di selezione delle interrogazioni.

## Utilità per la corrispondenza di tipi e modelli
<a name="utility-helpers-in-patterns-js"></a>

### Elenco degli strumenti per la corrispondenza di tipi e modelli
<a name="utility-helpers-in-patterns-js-list"></a>

**`util.matches(String, String) : Boolean`**  
Restituisce true se il modello specificato nel primo argomento corrisponde ai dati forniti nel secondo argomento. Il modello deve essere un'espressione regolare, ad esempio `util.matches("a*b", "aaaaab")`. La funzionalità si basa sulla classe [Pattern](https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html) che puoi consultare per ottenere altre informazioni.

 **`util.authType()`**   
Restituisce una stringa che descrive il tipo di autenticazione multipla utilizzato da una richiesta, restituendo «IAM Authorization», «User Pool Authorization», «Open ID Connect Authorization» o «API Key Authorization».

## Restituisce il valore di comportamento (utils)
<a name="utility-helpers-in-cloudwatch-logs-list-js"></a>

### Elenco delle utilità di comportamento del valore restituito
<a name="utility-helpers-in-behavior-list-js"></a>

 **`util.escapeJavaScript(String)`**  
Restituisce la stringa di input come stringa di JavaScript escape.

## Utilità di autorizzazione Resolver
<a name="utility-helpers-in-resolver-auth-js"></a>

### Elenco degli strumenti di autorizzazione del resolver
<a name="utility-helpers-in-resolver-auth-list-js"></a>

 **`util.unauthorized()`**  
Genera `Unauthorized` per il campo in fase di risoluzione. Utilizzalo nei modelli di mappatura delle richieste o delle risposte per determinare se consentire al chiamante di risolvere il campo.