Skip to main content

Version: Next

Collection <T, O>

Hierarchy

ArrayCollection<T, O>
- Collection
  - LoadedCollection

Index

Constructors

constructor

Properties

owner

Accessors

length

Constructors

constructor

new Collection(owner: O, items?: T[], initialized?: boolean): Collection<T, O>

Overrides ArrayCollection.constructor
Parameters
- owner: O
- optionalitems: T[]
- initialized: boolean = true
Returns Collection<T, O>

Properties

readonlyinheritedowner

owner: O

Accessors

inheritedlength

get length(): number

Inherited from ArrayCollection.length
Returns number

Methods

inherited[iterator]

[iterator](): IterableIterator<T, any, any>

Inherited from ArrayCollection.[iterator]
Returns IterableIterator<T, any, any>

add

add(entity: TT | Reference<TT> | Iterable<TT | Reference<TT>, any, any>, ...entities: (TT | Reference<TT>)[]): void

Overrides ArrayCollection.add
Parameters
- entity: TT | Reference<TT> | Iterable<TT | Reference<TT>, any, any>
- rest...entities: (TT | Reference<TT>)[]
Returns void

contains

contains(item: TT | Reference<TT>, check?: boolean): boolean

Overrides ArrayCollection.contains
Parameters
- item: TT | Reference<TT>
- check: boolean = true
Returns boolean

count

count(): number

Overrides ArrayCollection.count
Returns number

exists

exists(cb: (item: T) => boolean): boolean

Overrides ArrayCollection.exists
Tests for the existence of an element that satisfies the given predicate.
Parameters
- cb: (item: T) => boolean
Returns boolean

filter

filter(cb: (item: T, index: number) => boolean): T[]

Overrides ArrayCollection.filter
Extracts a subset of the collection items.
Parameters
- cb: (item: T, index: number) => boolean
Returns T[]

find

find(cb: (item: T, index: number) => boolean): undefined | T

Overrides ArrayCollection.find
Returns the first element of this collection that satisfies the predicate.
Parameters
- cb: (item: T, index: number) => boolean
Returns undefined | T

inheritedgetIdentifiers

getIdentifiers(field?: string): U[]

Inherited from ArrayCollection.getIdentifiers
Parameters
- optionalfield: string
Returns U[]

getItems

getItems(check?: boolean): T[]

Overrides ArrayCollection.getItems
Returns the items (the collection must be initialized)
Parameters
- check: boolean = true
Returns T[]

indexBy

indexBy(key: K1): Record<T[K1] & PropertyKey, T>
indexBy(key: K1, valueKey: K2): Record<T[K1] & PropertyKey, T[K2]>

Overrides ArrayCollection.indexBy
Maps the collection items to a dictionary, indexed by the key you specify. If there are more items with the same key, only the first one will be present.
Parameters
- key: K1
Returns Record<T[K1] & PropertyKey, T>

init

init(options?: InitCollectionOptions<TT, P, *, never>): Promise<LoadedCollection<Loaded<TT, P>>>

Parameters
- options: InitCollectionOptions<TT, P, *, never> = {}
Returns Promise<LoadedCollection<Loaded<TT, P>>>

inheritedisDirty

isDirty(): boolean

Inherited from ArrayCollection.isDirty
Returns boolean

isEmpty

isEmpty(): boolean

Overrides ArrayCollection.isEmpty
Returns boolean

inheritedisInitialized

isInitialized(fully?: boolean): boolean

Inherited from ArrayCollection.isInitialized
Parameters
- fully: boolean = false
Returns boolean

load

load(options?: InitCollectionOptions<TT, P, *, never>): Promise<LoadedCollection<Loaded<TT, P>>>

Ensures the collection is loaded first (without reloading it if it already is loaded). Returns the Collection instance (itself), works the same as Reference.load().
Parameters
- options: InitCollectionOptions<TT, P, *, never> = {}
Returns Promise<LoadedCollection<Loaded<TT, P>>>

loadCount

loadCount(options?: boolean | LoadCountOptions<T>): Promise<number>

Overrides ArrayCollection.loadCount
Gets the count of collection items from database instead of counting loaded items. The value is cached (unless you use the where option), use refresh: true to force reload it.
Parameters
- options: boolean | LoadCountOptions<T> = {}
Returns Promise<number>

loadItems

loadItems(options?: InitCollectionOptions<TT, P, *, never>): Promise<Loaded<TT, P>[]>

Initializes the collection and returns the items
Parameters
- optionaloptions: InitCollectionOptions<TT, P, *, never>
Returns Promise<Loaded<TT, P>[]>

map

map(mapper: (item: T, index: number) => R): R[]

Overrides ArrayCollection.map
Maps the collection items based on your provided mapper function.
Parameters
- mapper: (item: T, index: number) => R
Returns R[]

matching

matching(options: MatchingOptions<T, P>): Promise<Loaded<TT, P>[]>

Parameters
- options: MatchingOptions<T, P>
Returns Promise<Loaded<TT, P>[]>

populated

populated(populated?: undefined | boolean): void

Parameters
- populated: undefined | boolean = true
Returns void

inheritedreduce

reduce(cb: (obj: R, item: T, index: number) => R, initial?: R): R

Inherited from ArrayCollection.reduce
Maps the collection items based on your provided mapper function to a single object.
Parameters
- cb: (obj: R, item: T, index: number) => R
- initial: R = ...
Returns R

remove

remove(entity: TT | Reference<TT> | Iterable<TT | Reference<TT>, any, any> | (item: TT) => boolean, ...entities: (TT | Reference<TT>)[]): void

Overrides ArrayCollection.remove
Remove specified item(s) from the collection. Note that removing item from collection does not necessarily imply deleting the target entity, it means we are disconnecting the relation - removing items from collection, not removing entities from database - Collection.remove() is not the same as em.remove(). If we want to delete the entity by removing it from collection, we need to enable orphanRemoval: true, which tells the ORM we don't want orphaned entities to exist, so we know those should be removed.
Parameters
- entity: TT | Reference<TT> | Iterable<TT | Reference<TT>, any, any> | (item: TT) => boolean
- rest...entities: (TT | Reference<TT>)[]
Returns void

inheritedremoveAll

removeAll(): void

Inherited from ArrayCollection.removeAll
Remove all items from the collection. Note that removing items from collection does not necessarily imply deleting the target entity, it means we are disconnecting the relation - removing items from collection, not removing entities from database - Collection.remove() is not the same as em.remove(). If we want to delete the entity by removing it from collection, we need to enable orphanRemoval: true, which tells the ORM we don't want orphaned entities to exist, so we know those should be removed.
Returns void

inheritedset

set(items: Iterable<T | Reference<T>, any, any>): void

Inherited from ArrayCollection.set
Parameters
- items: Iterable<T | Reference<T>, any, any>
Returns void

inheritedsetDirty

setDirty(dirty?: boolean): void

Inherited from ArrayCollection.setDirty
Parameters
- dirty: boolean = true
Returns void

shouldPopulate

shouldPopulate(populated?: boolean): boolean

Parameters
- optionalpopulated: boolean
Returns boolean

slice

slice(start?: number, end?: number): T[]

Overrides ArrayCollection.slice
Extracts a slice of the collection items starting at position start to end (exclusive) of the collection. If end is null it returns all elements from start to the end of the collection.
Parameters
- optionalstart: number
- optionalend: number
Returns T[]

inheritedtoArray

toArray(): EntityDTO<TT>[]

Inherited from ArrayCollection.toArray
Returns EntityDTO<TT>[]

toJSON

toJSON(): EntityDTO<TT>[]

Overrides ArrayCollection.toJSON
Returns EntityDTO<TT>[]

staticcreate

create(owner: O, prop: EntityKey<O>, items: undefined | T[], initialized: boolean): Collection<T, O>

Creates new Collection instance, assigns it to the owning entity and sets the items to it (propagating them to their inverse sides)
Parameters
- owner: O
- prop: EntityKey<O>
- items: undefined | T[]
- initialized: boolean
Returns Collection<T, O>

Page Options

Hide Inherited