访问类型为以下类型的对象属性时,返回此类的实例: "Dictionary"

字典的行为大多类似于 JavaScript 对象,即作为键/值对,其中键是字符串。

类型参数

  • T =未知

层次结构(查看完整

可转位

[ key: string ]: T

@ts-expect-error 我们在密钥的最终用户命名空间中公开方法

方法

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

    参数

    • callback : DictionaryChangeCallback

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

    • 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 @ts-expect-error 我们在密钥的最终用户命名空间中公开方法

  • 使用提供的键从字典中删除元素。 如果字典中已经缺少键,则不会抛出异常。

    参数

    • key : string | string []

      要删除的键。

    返回

    字典

    抛出异常

    如果不在写事务(write transaction)中,则抛出断言错误

    since

    10.6.0 @ts-expect-error 我们在密钥的最终用户命名空间中公开方法

  • 将具有指定键和值的一个或多个元素添加到字典中,或者如果键存在则更新值。

    参数

    • elements : {
          [ key : string ] : T ;
      }

      要添加的元素的对象。

      • [key : string ]: T

    返回

    字典。

    抛出异常

    如果输入对象不在写事务(write transaction)内,则包含符号键或者任何值违反了类型约束,则为AssertionError

    since

    10.6.0 @ts-expect-error 我们在密钥的最终用户命名空间中公开方法

  • 将具有指定键和值的元素添加到字典中,或者如果键存在则更新。

    参数

    • key : string

      要添加的元素的键。

    • T

      要添加的元素的值。

    返回

    字典。

    抛出异常

    AssertionError如果不在写事务(write transaction)中,键是一个符号,或者如果值违反了类型约束。

    since

    12.0.0

使用TypeDoc生成