$util.list 中的列表帮助程序
注意
我们现在主要支持 APPSYNC_JS 运行时系统及其文档。请考虑使用 APPSYNC_JS 运行时系统和此处的指南。
$util.list
包含一些方法以帮助执行常见的列表操作,例如在列表中删除或保留项目以用于筛选使用案例。
-
$util.list.copyAndRetainAll(List, List) : List
-
制作第一个参数中提供的列表的浅副本,同时仅保留第二个参数中指定的项目(如果存在)。所有其他项目将从副本中移除。
-
$util.list.copyAndRemoveAll(List, List) : List
-
制作第一个参数中提供的列表的浅副本,同时删除在第二个参数中指定项目的任何项目(如果存在)。所有其他项目将保留在副本中。
-
$util.list.sortList(List, Boolean, String) : List
-
对第一个参数中提供的对象列表进行排序。如果第二个参数为 true,则列表按降序进行排序;如果第二个参数为 false,则列表按升序进行排序。第三个参数是用于对自定义对象列表进行排序的属性的字符串名称。如果它只是字符串、整数、浮点数或双精度数列表,则第三个参数可能是任何随机字符串。如果所有对象不是来自同一个类,则返回原始列表。仅支持最多包含 1000 个对象的列表。以下是该实用程序的用法示例:
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}]