Aplicaciones auxiliares de lista en $util.list

nota

Ahora admitimos de forma básica el tiempo de ejecución APPSYNC_JS y su documentación. Considere la opción de utilizar el tiempo de ejecución APPSYNC_JS y sus guías aquí.

$util.list contiene métodos útiles para ayudar con operaciones de lista habituales, como eliminar o retener elementos de una lista para casos de uso de filtro.

Utilidades de lista

$util.list.copyAndRetainAll(List, List) : List

Hace una copia superficial de la lista suministrada en el primer argumento y retiene solo los elementos especificados en el segundo argumento, si están presentes. Todos los demás elementos se eliminan de la copia.

$util.list.copyAndRemoveAll(List, List) : List

Hace una copia superficial de la lista suministrada en el primer argumento y elimina los elementos especificados en el segundo argumento, si están presentes. Todos los demás elementos se conservan en la copia.

$util.list.sortList(List, Boolean, String) : List

Ordena una lista de objetos, que se proporciona en el primer argumento. Si el segundo argumento tiene el valor true, la lista se ordena de forma descendente; si el segundo argumento tiene el valor false, la lista se ordena de forma ascendente. El tercer argumento es el nombre de la cadena de la propiedad utilizada para ordenar una lista de objetos personalizados. Si se trata de una lista compuesta únicamente por los tipos String, Integer, Float o Double, el tercer argumento puede ser cualquier cadena aleatoria. Si no todos los objetos son de la misma clase, se devolverá la lista original. Solo se admiten aquellas listas con un máximo de 1000 objetos. A continuación se muestra un ejemplo del uso de esta utilidad:

 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}]