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á.

# Auxiliares de lista em $util.list
<a name="list-helpers-in-util-list"></a>

**nota**  
Agora, oferecemos suporte principalmente ao runtime do APPSYNC\_JS e sua documentação. Considere usar o runtime do APPSYNC\_JS e seus guias disponíveis [aqui](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html).

`$util.list` contém métodos para ajudar com operações de Lista comuns, como remover e reter itens de uma lista para filtrar casos de uso.

## Listar utilitários
<a name="utility-helpers-in-list-utils"></a>

** `$util.list.copyAndRetainAll(List, List) : List` **  
Faz uma cópia superficial da lista fornecida no primeiro argumento, retendo apenas os itens especificados no segundo argumento, se estiverem presentes. Todos os outros itens serão removidos da cópia.

** `$util.list.copyAndRemoveAll(List, List) : List` **  
Faz uma cópia superficial da lista fornecida no primeiro argumento, removendo quaisquer itens onde o item estiver especificado no segundo argumento, se estiverem presentes. Todos os outros itens serão retidos na cópia.

** `$util.list.sortList(List, Boolean, String) : List` **  
Classifica uma lista de objetos, que é fornecida no primeiro argumento. Se o segundo argumento for verdadeiro, a lista será classificada de forma decrescente; se o segundo argumento for falso, a lista será classificada de forma ascendente. O terceiro argumento é o nome da string da propriedade usada para classificar uma lista de objetos personalizados. Se for uma lista apenas de strings, números inteiros, flutuantes ou duplos, o terceiro argumento pode ser qualquer string aleatória. Se todos os objetos não forem da mesma classe, a lista original será retornada. Somente listas contendo no máximo 1000 objetos são compatíveis. Veja a seguir um exemplo do uso desse utilitário:   

```
 INPUT:      $util.list.sortList([{"description":"youngest", "age":5},{"description":"middle", "age":45}, {"description":"oldest", "age":85}], false, "description")
 OUTPUT:     [{"description":"middle", "age":45}, {"description":"oldest", "age":85}, {"description":"youngest", "age":5}]
```