As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Utilitários integrados
<a name="built-in-util-js"></a>

A variável `util` contém métodos utilitários gerais para ajudar você a trabalhar com dados. A menos que especificado o contrário, todos os utilitários usam o conjunto de caracteres UTF-8.

## Utilitários de codificação
<a name="utility-helpers-in-encoding"></a>

### Lista de utilitários de codificação
<a name="utility-helpers-in-encoding-list-js"></a>

 **`util.urlEncode(String)`**  
Retorna a string de entrada como uma string codificada `application/x-www-form-urlencoded`.

 **`util.urlDecode(String)`**  
Decodifica uma string codificada `application/x-www-form-urlencoded` de volta ao seu formato não codificado.

**`util.base64Encode(string) : string`**  
Codifica a entrada em uma string codificada em base64.

**`util.base64Decode(string) : string`**  
Decodifica os dados de uma string codificada em base64.

## Utilitários de geração de ID
<a name="utility-helpers-in-id-gen-js"></a>

### Lista de utilitários de geração de ID
<a name="utility-helpers-in-id-gen-list-js"></a>

 **`util.autoId()`**  
Retorna um UUID de 128 bits gerado aleatoriamente.

**`util.autoUlid()`**  
Retorna um identificador lexicograficamente classificável universalmente exclusivo (ULID) de 128 bits gerado aleatoriamente.

**`util.autoKsuid()`**  
Retorna um identificador exclusivo classificável por K (KSUID) de 128 bits gerado aleatoriamente, codificado em base62, como uma string com comprimento de 27.​

## Utilitários de erro
<a name="utility-helpers-in-error-js"></a>

### Lista de utilitários de erro
<a name="utility-helpers-in-error-list-js"></a>

 **`util.error(String, String?, Object?, Object?)`**  
Lança um erro personalizado. Isso pode ser usado em modelos de mapeamento da solicitação ou resposta se o modelo detectar um erro com a solicitação ou com o resultado da invocação. Além disso, é possível especificar os campos `errorType`, `data` e `errorInfo`. O valor `data` será adicionado ao bloco `error` correspondente em `errors` na resposta do GraphQL.  
`data` será filtrado com base no conjunto de seleção da consulta. O valor `errorInfo` será adicionado ao bloco `error` correspondente em `errors` na resposta do GraphQL.  
`errorInfo` **não** será filtrado com base no conjunto de seleção da consulta.

 **`util.appendError(String, String?, Object?, Object?)`**  
Anexa um erro personalizado no final. Isso pode ser usado em modelos de mapeamento da solicitação ou resposta se o modelo detectar um erro com a solicitação ou com o resultado da invocação. Além disso, é possível especificar os campos `errorType`, `data` e `errorInfo`. Diferente de `util.error(String, String?, Object?, Object?)`, a avaliação do modelo não será interrompida para que os dados possam ser retornados ao chamador. O valor `data` será adicionado ao bloco `error` correspondente em `errors` na resposta do GraphQL.  
`data` será filtrado com base no conjunto de seleção da consulta. O valor `errorInfo` será adicionado ao bloco `error` correspondente em `errors` na resposta do GraphQL.  
`errorInfo` **não** será filtrado com base no conjunto de seleção da consulta.

## Utilitários de correspondência de tipos e padrões
<a name="utility-helpers-in-patterns-js"></a>

### Lista de utilitários de correspondência de tipos e padrões
<a name="utility-helpers-in-patterns-js-list"></a>

**`util.matches(String, String) : Boolean`**  
Retorna verdadeiro se o padrão especificado no primeiro argumento corresponde aos dados fornecidos no segundo argumento. O padrão deve ser uma expressão regular, como `util.matches("a*b", "aaaaab")`. A funcionalidade se baseia em [Padrão](https://docs.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html), que você pode consultar para obter documentação adicional.

 **`util.authType()`**   
Retorna uma String que descreve o tipo de autenticação múltipla que está sendo usado por uma solicitação, retornando "Autorização do IAM", "Autorização de grupo de usuários", "Autorização do Open ID Connect" ou "Autorização de chave de API".

## Utilitários de comportamento do valor de retorno
<a name="utility-helpers-in-cloudwatch-logs-list-js"></a>

### Lista de utilitários de comportamento de valor de retorno​
<a name="utility-helpers-in-behavior-list-js"></a>

 **`util.escapeJavaScript(String)`**  
Retorna a string de entrada como uma string JavaScript de escape.

## Utilitários de autorização do resolvedor
<a name="utility-helpers-in-resolver-auth-js"></a>

### Lista de utilitários de autorização do resolvedor
<a name="utility-helpers-in-resolver-auth-list-js"></a>

 **`util.unauthorized()`**  
Lança `Unauthorized` para o campo a ser resolvido. Use em modelos de mapeamento de solicitação ou resposta para determinar se é preciso ou não permitir que o chamador resolva o campo.