Class Key

A Key represents the unique identifier of an object. Our Key scheme is inspired by file systems and Google App Engine key model. Keys are meant to be unique across a system. Keys are hierarchical, incorporating more and more specific namespaces. Thus keys can be deemed 'children' or 'ancestors' of other keys:

new Key('/Comedy')
new Key('/Comedy/MontyPython') Also, every namespace can be parametrized to embed relevant object information. For example, the Key name (most specific namespace) could include the object type:
new Key('/Comedy/MontyPython/Actor:JohnCleese')
new Key('/Comedy/MontyPython/Sketch:CheeseShop')
new Key('/Comedy/MontyPython/Sketch:CheeseShop/Character:Mousebender')

Index

Constructors

constructor

new Key(s, clean?): Key
Parameters
- s: string | Uint8Array
- Optional clean: boolean
Returns Key
- Defined in interface-datastore/src/key.ts:31

Properties

`Private` _buf

_buf: Uint8Array

Accessors

[toStringTag]

get [toStringTag](): string
Return string representation of the key

Returns string
- Defined in interface-datastore/src/key.ts:77

Methods

baseNamespace

baseNamespace(): string
Returns the "base" namespace of this key.

Returns string
Example
```
new Key('/Comedy/MontyPython/Actor:JohnCleese').baseNamespace()
// => 'Actor:JohnCleese'
```
- Defined in interface-datastore/src/key.ts:214

child

child(key): Key
Returns the child Key of this Key.
Parameters
- key: Key
  The child Key to add
Returns Key
Example
```
new Key('/Comedy/MontyPython').child(new Key('Actor:JohnCleese'))
// => Key('/Comedy/MontyPython/Actor:JohnCleese')
```
- Defined in interface-datastore/src/key.ts:332

clean

clean(): void
Cleanup the current key

Returns void
- Defined in interface-datastore/src/key.ts:134

concat

concat(...keys): Key
Concats one or more Keys into one new Key.
Parameters
- Rest ...keys: Key[]
  The array of keys to concatenate
Returns Key
- Defined in interface-datastore/src/key.ts:397

instance

instance(s): Key
Returns an "instance" of this type key (appends value to namespace).
Parameters
- s: string
  The string to append.
Returns Key
Example
```
new Key('/Comedy/MontyPython/Actor').instance('JohnClesse')
// => Key('/Comedy/MontyPython/Actor:JohnCleese')
```
- Defined in interface-datastore/src/key.ts:276

isAncestorOf

isAncestorOf(other): boolean
Returns whether this key is a prefix of other
Parameters
- other: Key
  The other key to test against
Returns boolean
Example
```
new Key('/Comedy').isAncestorOf('/Comedy/MontyPython')
// => true
```
- Defined in interface-datastore/src/key.ts:354

isDecendantOf

isDecendantOf(other): boolean
Returns whether this key is a contains another as prefix.
Parameters
- other: Key
  The other Key to test against
Returns boolean
Example
```
new Key('/Comedy/MontyPython').isDecendantOf('/Comedy')
// => true
```
- Defined in interface-datastore/src/key.ts:374

isTopLevel

isTopLevel(): boolean
Checks if this key has only one namespace.

Returns boolean
- Defined in interface-datastore/src/key.ts:387

less

less(key): boolean
Check if the given key is sorted lower than ourself.
Parameters
- key: Key
  The other Key to check against
Returns boolean
- Defined in interface-datastore/src/key.ts:158

list

list(): string[]

Returns the list representation of this key.

Returns string[]

Example

new Key('/Comedy/MontyPython/Actor:JohnCleese').list()
// => ['Comedy', 'MontyPythong', 'Actor:JohnCleese']

name

name(): string
Returns the "name" of this key (field of last namespace).

Returns string
Example
```
new Key('/Comedy/MontyPython/Actor:JohnCleese').name()
// => 'JohnCleese'
```
- Defined in interface-datastore/src/key.ts:260

namespaces

namespaces(): string[]
Returns the namespaces making up this Key.

Returns string[]
- Defined in interface-datastore/src/key.ts:200

parent

parent(): Key

Returns the parent Key of this Key.

Returns Key

Example

new Key("/Comedy/MontyPython/Actor:JohnCleese").parent()
// => Key("/Comedy/MontyPython")

path

path(): Key
Returns the "path" of this key (parent + type).

Returns Key
Example
```
new Key('/Comedy/MontyPython/Actor:JohnCleese').path()
// => Key('/Comedy/MontyPython/Actor')
```
- Defined in interface-datastore/src/key.ts:291

reverse

reverse(): Key

Returns the key with all parts in reversed order.

Returns Key

Example

new Key('/Comedy/MontyPython/Actor:JohnCleese').reverse()
// => Key('/Actor:JohnCleese/MontyPython/Comedy')

toString

toString(encoding?): string
Convert to the string representation
Parameters
- Optional encoding: SupportedEncodings = 'utf8'
  The encoding to use.
Returns string
- Defined in interface-datastore/src/key.ts:59

type

type(): string
Returns the "type" of this key (value of last namespace).

Returns string
Example
```
new Key('/Comedy/MontyPython/Actor:JohnCleese').type()
// => 'Actor'
```
- Defined in interface-datastore/src/key.ts:245

uint8Array

uint8Array(): Uint8Array
Return the Uint8Array representation of the key

Returns Uint8Array
- Defined in interface-datastore/src/key.ts:68

`Static` asKey

asKey(other): null | Key
Parameters
- other: any
Returns null | Key
- Defined in interface-datastore/src/key.ts:115

`Static` random

random(): Key
Returns a randomly (uuid) generated key.

Returns Key
Example
```
Key.random()
// => Key('/344502982398')
```
- Defined in interface-datastore/src/key.ts:108

`Static` withNamespaces

withNamespaces(list): Key
Constructs a key out of a namespace array.
Parameters
- list: string[]
  The array of namespaces
Returns Key
Example
```
Key.withNamespaces(['one', 'two'])
// => Key('/one/two')
```
- Defined in interface-datastore/src/key.ts:93

Class Key

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Key

Properties

Private _buf

Accessors

[toStringTag]

Returns string

Methods

baseNamespace

Returns string

Example

child

Parameters

Returns Key

Example

clean

Returns void

concat

Parameters

Returns Key

instance

Parameters

Returns Key

Example

isAncestorOf

Parameters

Returns boolean

Example

isDecendantOf

Parameters

Returns boolean

Example

isTopLevel

Returns boolean

less

Parameters

Returns boolean

list

Returns string[]

Example

name

Returns string

Example

namespaces

Returns string[]

parent

Returns Key

Example

path

Returns Key

Example

reverse

Returns Key

Example

toString

Parameters

Returns string

type

Returns string

Example

uint8Array

Returns Uint8Array

Static asKey

Parameters

Returns null | Key

Static random

Returns Key

Example

Static withNamespaces

Parameters

Returns Key

Example

`Private` _buf

`Static` asKey

`Static` random

`Static` withNamespaces