Padloc Logo Docs & Resources

Class: VaultItemCollection

collection.VaultItemCollection

A collection of vault items items, used for consolidating changes made independently across multiple instances through "merging".

Hierarchy

Implements

Constructors

constructor

new VaultItemCollection(items?)

Parameters

Name Type Default value
items VaultItem[] []

Overrides

Serializable.constructor

Defined in

core/src/collection.ts:32

Properties

_changes

Private _changes: Map<string, Date>

Defined in

core/src/collection.ts:30


_items

Private _items: Map<string, VaultItem>

Defined in

core/src/collection.ts:29


_propertySerializationOptions

_propertySerializationOptions: SerializationOptions[]

Inherited from

Serializable._propertySerializationOptions

Defined in

core/src/encoding.ts:163

Accessors

hasChanges

get hasChanges(): boolean

Returns

boolean

Defined in

core/src/collection.ts:14


kind

get kind(): string

A string representing the objects "type", useful for segmenting storage, among other things. Defaults to the lowercase class name, but can be overwritten by subclasses

Returns

string

Inherited from

Serializable.kind

Defined in

core/src/encoding.ts:159


size

get size(): number

Number of items in this VaultItemCollection

Returns

number

Defined in

core/src/collection.ts:10


tags

get tags(): string[]

Aggregated list of tags assigned to the items in this collection

Returns

string[]

Defined in

core/src/collection.ts:19

Methods

[iterator]

[iterator](): IterableIterator<VaultItem>

Returns

IterableIterator<VaultItem>

Implementation of

Iterable.__@iterator@78

Defined in

core/src/collection.ts:108


_fromRaw

Protected _fromRaw(__namedParameters): void

Restore values from a raw object. The default implementation simply copies over all iterable properties from the base object. Overwrite this method for properties that require special treatment

Parameters

Name Type
__namedParameters any

Returns

void

Overrides

Serializable._fromRaw

Defined in

core/src/collection.ts:99


_toRaw

Protected _toRaw(version): Object

Transform this object into a raw javascript object used for serialization. The default implementation simply copies all iterable properties not included in the [[exlude]] array and calls toRaw on any properties that are themselfes instances of Serializable. This method should be overwritten by subclasses if certain properties require special treatment.

Parameters

Name Type
version string

Returns

Object

Name Type
changes [string, Date][]
items any[]

Overrides

Serializable._toRaw

Defined in

core/src/collection.ts:92


clearChanges

clearChanges(before?): void

Parameters

Name Type
before? Date

Returns

void

Defined in

core/src/collection.ts:84


clone

clone(): VaultItemCollection

Creates a deep clone of the object

Returns

VaultItemCollection

Inherited from

Serializable.clone

Defined in

core/src/encoding.ts:244


fromBytes

fromBytes(bytes): VaultItemCollection

Deserializes the object from a byte array

Parameters

Name Type
bytes Uint8Array

Returns

VaultItemCollection

Inherited from

Serializable.fromBytes

Defined in

core/src/encoding.ts:237


fromJSON

fromJSON(json): VaultItemCollection

Deserializes the object from a JSON string

Parameters

Name Type
json string

Returns

VaultItemCollection

Inherited from

Serializable.fromJSON

Defined in

core/src/encoding.ts:223


fromRaw

fromRaw(raw): VaultItemCollection

Restores propertiers from a raw object of the same form generated by toRaw. The base implementation blindly copies over values from the raw object via Object.assign so subclasses should explictly process any propertyies that need special treatment.

Also takes are of validation and "upgrading" in case the raw object has an old version. Use the protected _fromRaw method to implement subclass-specific behavior.

Parameters

Name Type
raw any

Returns

VaultItemCollection

Inherited from

Serializable.fromRaw

Defined in

core/src/encoding.ts:196


get

get(id): null | VaultItem

Get an item with a given id

Parameters

Name Type
id string

Returns

null | VaultItem

Defined in

core/src/collection.ts:38


merge

merge(coll): void

Merges in changes from another VaultItemCollection instance.

Parameters

Name Type
coll VaultItemCollection

Returns

void

Defined in

core/src/collection.ts:67


remove

remove(...items): void

Removes one or more items based on their id.

Parameters

Name Type
...items VaultItem[]

Returns

void

Defined in

core/src/collection.ts:57


toBytes

toBytes(): Uint8Array

Returns a serialization of the object in form of a byte array

Returns

Uint8Array

Inherited from

Serializable.toBytes

Defined in

core/src/encoding.ts:230


toJSON

toJSON(): string

Returns a JSON serialization of the object

Returns

string

Inherited from

Serializable.toJSON

Defined in

core/src/encoding.ts:216


toRaw

toRaw(version?): any

Creates a raw javascript object representation of the class, which can be used for storage or data transmission. Also handles "downgrading" to previous versions. Use _toRaw for subclass-specific behavior.

Parameters

Name Type
version? string

Returns

any

Inherited from

Serializable.toRaw

Defined in

core/src/encoding.ts:179


update

update(...items): void

Updates one or more items based on their id. If no item with the same id exists, the item will be added to the collection

Parameters

Name Type
...items VaultItem[]

Returns

void

Defined in

core/src/collection.ts:46


validate

validate(): boolean

This is called during deserialization and should verify that all properties have been populated with values of the correct type. Subclasses should implement this method based on their class structure.

Returns

boolean

Inherited from

Serializable.validate

Defined in

core/src/encoding.ts:170