collection<KeyType, ValueType, EntryType, T, ChangeCallbackType>Abstract

抽象基类,包含 Realm ListDictionaryResults共享的方法。

一个 collection 始终会反映 Realm 的当前状态。唯一的例外是使用for...infor...of枚举时,该枚举将始终枚举开始枚举时与查询匹配的对象,即使其中一些对象在枚举。

since

0.11.0

类型参数

层次结构(查看完整

implements

方法

  • 添加监听器callback ,当实时collection实例发生更改时将调用该监听器。

    参数

    • callback : ChangeCallbackType

      发生更改时要调用的函数。

    • Optional keyPaths : string | string []

      指示与侦听器相关的更改的下限。 这是一个下限,因为如果添加了多个侦听器(每个侦听器都有自己的keyPaths ),这些键路径的并集将确定被视为与在collection上注册的所有侦听器相关的更改。换言之:如果存在具有不同键路径的其他侦听器,则侦听器触发的次数可能会超过键路径指定的次数。

    返回void

    注意

    deletions and oldModifications report the indices in the collection before the change happened, while插入and newModifications report the indices into the new version of the collection. @throws A {@link TypeAssertionError} if回调 is not a function. @example wines.addListener((collection, changes) => { // collection === wines console.log( ${changes.insertions.length} 插入); console.log( ${changes.oldModifications.length} oldModifications ); console.log( ${changes.newModifications.length} newModifications ); console.log( ${changes.deletions.length} 删除); console.log(集合的新大小:${collection.length} ); }); @example wines.addListener((collection, changes) => { console.log("A wine's brand might have changed"); }, ["brand"]); @note Adding the listener is an asynchronous operation, so the callback is invoked the first time to notify the caller when the listener has been added. Thus, when the callback is invoked the first time it will contain empty arrays for each property in the 更改` 对象。

  • 检查此集合是否未被删除以及是否是有效 Realm 的一部分。

    返回布尔值

    true 是否可以安全地访问该集合。

    since

    0.14.0

使用TypeDoc生成