Type Alias ICacheBase<TType>

Type declaration

• add:function

  • add(
        key: OneOrMore<string>,
        value: TType,
        ttl?: null | TimeSpan,
    ): LazyPromise<boolean>

  • The add method adds a key with given value when key doesn't exists.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • value: TType
    • Optionalttl: null | TimeSpan

      If null is passed, the item will not expire.

    Returns LazyPromise<boolean>

    true when key doesn't exists otherwise false will be returned.

• clear:function

  • clear(): LazyPromise<void>

  • The clear method removes all the keys in the cache. If a cache is in a group then only the keys part of the group will be removed.

    Returns LazyPromise<void>

• decrement:function

  • decrement(
        key: OneOrMore<string>,
        value?: Extract<TType, number>,
    ): LazyPromise<boolean>

  • The decrement method decrements the given key with given value. An error will thrown if the key is not a number.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • Optionalvalue: Extract<TType, number>

      If not defined then it will be defaulted to 1.

    Returns LazyPromise<boolean>

    true if the key where decremented otherwise false will be returned.

    Throws

    TypeCacheError

• exists:function

  • exists(key: OneOrMore<string>): LazyPromise<boolean>

  • The exists method returns true when key is found otherwise false will be returned.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<boolean>

• get:function

  • get(key: OneOrMore<string>): LazyPromise<null | TType>

  • The get method returns the value when key is found otherwise null will be returned.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<null | TType>

• getAndRemove:function

  • getAndRemove(key: OneOrMore<string>): LazyPromise<null | TType>

  • The getAndRemove method returns the value when key is found otherwise null will be returned. The key will be removed after it is returned.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<null | TType>

• getOr:function

  • getOr(
        key: OneOrMore<string>,
        defaultValue: AsyncLazyable<NoneFunc<TType>>,
    ): LazyPromise<TType>

  • The getOr method will retrieve the given key if found otherwise defaultValue will be returned.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • defaultValue: AsyncLazyable<NoneFunc<TType>>

      can be regular value, sync or async Invokable value and LazyPromise value.

    Returns LazyPromise<TType>

• getOrAdd:function

  • getOrAdd(
        key: OneOrMore<string>,
        valueToAdd: AsyncLazyable<NoneFunc<TType>>,
        ttl?: null | TimeSpan,
    ): LazyPromise<TType>

  • The getOrAdd method will retrieve the given key if found otherwise valueToAdd will be added and returned.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • valueToAdd: AsyncLazyable<NoneFunc<TType>>

      can be regular value, sync or async Invokable value and LazyPromise value.
    • Optionalttl: null | TimeSpan

    Returns LazyPromise<TType>

• getOrFail:function

  • getOrFail(key: OneOrMore<string>): LazyPromise<TType>

  • The getOrFail method returns the value when key is found otherwise an error will be thrown.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<TType>

    Throws

    KeyNotFoundCacheError

• increment:function

  • increment(
        key: OneOrMore<string>,
        value?: Extract<TType, number>,
    ): LazyPromise<boolean>

  • The increment method increments the given key with given value. An error will thrown if the key is not a number.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • Optionalvalue: Extract<TType, number>

      If not defined then it will be defaulted to 1.

    Returns LazyPromise<boolean>

    true if the key where incremented otherwise false will be returned.

    Throws

    TypeCacheError

• missing:function

  • missing(key: OneOrMore<string>): LazyPromise<boolean>

  • The missing method returns true when key is not found otherwise false will be returned.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<boolean>

• put:function

  • put(
        key: OneOrMore<string>,
        value: TType,
        ttl?: null | TimeSpan,
    ): LazyPromise<boolean>

  • The put method replaces th given key with the given value and ttl if the key exists othwerwise it will add the given value with the given ttl.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • value: TType
    • Optionalttl: null | TimeSpan

      If null is passed, the item will not expire.

    Returns LazyPromise<boolean>

    true if the key where replaced otherwise false is returned.

• remove:function

  • remove(key: OneOrMore<string>): LazyPromise<boolean>

  • The remove method removes the given key.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<boolean>

    true if the key is found otherwise false is returned.

• removeMany:function

  • removeMany(keys: Iterable<OneOrMore<string>, any, any>): LazyPromise<boolean>

  • The removeMany method removes many keys.

    Parameters

    • keys: Iterable<OneOrMore<string>, any, any>

      The param items can be a string or an Iterable of strings. If the param items are an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.

    Returns LazyPromise<boolean>

    true if one of the keys where deleted otherwise false is returned.

• update:function

  • update(key: OneOrMore<string>, value: TType): LazyPromise<boolean>

  • The update method updates the given key with given value.

    Parameters

    • key: OneOrMore<string>

      can be a string or an Iterable of strings. If it's an Iterable, it will be joined into a single string. Think of an Iterable as representing a path.
    • value: TType

    Returns LazyPromise<boolean>

    true if the key where updated otherwise false will be returned.