LoadedCollection <T>

Hierarchy

• Collection<T>
  • LoadedCollection

Index

Properties

• $
• owner

Accessors

• length

Methods

• [custom]
• [iterator]
• add
• contains
• count
• get
• getIdentifiers
• getItems
• init
• isDirty
• isInitialized
• loadCount
• loadItems
• matching
• populated
• remove
• removeAll
• set
• setDirty
• shouldPopulate
• toArray
• toJSON

Properties

$

$: Collection<T, unknown>

readonlyowner

owner: Partial<unknown> & { [EntityRepositoryType]?: unknown; [PrimaryKeyType]?: unknown; __helper?: IWrappedEntityInternal<unknown, never, string>; __meta?: EntityMetadata<unknown>; __platform?: Platform }

Inherited from Collection.owner

Accessors

length

• get length(): number

• Inherited from Collection.length

  Returns number

Methods

[custom]

• [custom](depth: number): string

• Inherited from Collection.[custom]

  Parameters

  • depth: number

  Returns string

[iterator]

• [iterator](): IterableIterator<T>

• Inherited from Collection.[iterator]

  Returns IterableIterator<T>

add

• add(...items: (T | Reference<T>)[]): void

• Inherited from Collection.add

  Parameters

  • rest...items: (T | Reference<T>)[]

  Returns void

contains

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

• Inherited from Collection.contains

  Parameters

  • item: T | Reference<T>

  • check: boolean = true

  Returns boolean

count

• count(): number

• Inherited from Collection.count

  Returns number

get

• get(): Collection<T, unknown>

• Returns Collection<T, unknown>

getIdentifiers

• getIdentifiers<U>(field?: string): U[]

• Inherited from Collection.getIdentifiers

  Type parameters

  • U: IPrimaryKeyValue = (Primary<T> & string) & (Primary<T> & number) & (Primary<T> & bigint) & (Primary<T> & Date) & (Primary<T> & { toHexString: any })

  Parameters

  • optionalfield: string

  Returns U[]

getItems

• getItems(check?: boolean): T[]

• Overrides Collection.getItems

  Returns the items (the collection must be initialized)

  ---

  Parameters

  • optionalcheck: boolean

  Returns T[]

init

• init<P>(options?: InitOptions<T, P>): Promise<LoadedCollection<Loaded<T, P>>>

• Inherited from Collection.init

  Type parameters

  • P: string = never

  Parameters

  • options: InitOptions<T, P> = {}

  Returns Promise<LoadedCollection<Loaded<T, P>>>

isDirty

• isDirty(): boolean

• Inherited from Collection.isDirty

  Returns boolean

isInitialized

• isInitialized(fully?: boolean): boolean

• Inherited from Collection.isInitialized

  Parameters

  • fully: boolean = false

  Returns boolean

loadCount

• loadCount(refresh?: boolean): Promise<number>

• Inherited from Collection.loadCount

  Gets the count of collection items from database instead of counting loaded items. The value is cached, use refresh = true to force reload it.

  ---

  Parameters

  • refresh: boolean = false

  Returns Promise<number>

loadItems

• loadItems<P>(options?: InitOptions<T, P>): Promise<Loaded<T, P>[]>

• Inherited from Collection.loadItems

  Initializes the collection and returns the items

  ---

  Type parameters

  • P: string = never

  Parameters

  • optionaloptions: InitOptions<T, P>

  Returns Promise<Loaded<T, P>[]>

matching

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

• Inherited from Collection.matching

  Type parameters

  • P: string = never

  Parameters

  • options: MatchingOptions<T, P>

  Returns Promise<Loaded<T, P>[]>

populated

• populated(populated?: boolean): void

• Inherited from Collection.populated

  Parameters

  • populated: boolean = true

  Returns void

remove

• remove(...items: (T | Reference<T> | (item: T) => boolean)[]): void

• Inherited from Collection.remove

  Remove specified item(s) from the collection. Note that removing item from collection does 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

  • rest...items: (T | Reference<T> | (item: T) => boolean)[]

  Returns void

removeAll

• removeAll(): void

• Inherited from Collection.removeAll

  Remove all items from the collection. Note that removing items from collection does 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

set

• set(items: (T | Reference<T>)[]): void

• Inherited from Collection.set

  Parameters

  • items: (T | Reference<T>)[]

  Returns void

setDirty

• setDirty(dirty?: boolean): void

• Inherited from Collection.setDirty

  Parameters

  • dirty: boolean = true

  Returns void

shouldPopulate

• shouldPopulate(): boolean

• Inherited from Collection.shouldPopulate

  Returns boolean

toArray

• toArray(): EntityDTO<T>[]

• Inherited from Collection.toArray

  Returns EntityDTO<T>[]

toJSON

• toJSON(): EntityDTO<T>[]

• Inherited from Collection.toJSON

  Returns EntityDTO<T>[]