MikroORM <EM, Entities>

The main class used to configure and bootstrap the ORM.

@example

// import from driver package
import { MikroORM, defineEntity, p } from '@mikro-orm/sqlite';

const User = defineEntity({
  name: 'User',
  properties: {
    id: p.integer().primary(),
    name: p.string(),
  },
});

const orm = new MikroORM({
  entities: [User],
  dbName: 'my.db',
});
await orm.schema.update();

const em = orm.em.fork();
const u1 = em.create(User, { name: 'John' });
const u2 = em.create(User, { name: 'Ben' });
await em.flush();

Hierarchy

• MikroORM<LibSqlDriver, EM, Entities>
  • MikroORM

Index

Constructors

• constructor

Properties

• config
• driver
• em

Accessors

• entityGenerator
• migrator
• schema
• seeder

Methods

• checkConnection
• close
• connect
• discoverEntity
• getMetadata
• isConnected
• reconnect
• init

Constructors

constructor

• new MikroORM<EM, Entities>(options): LibSqlMikroORM<EM, Entities>

• Overrides MikroORM.constructor

  @inheritDoc

  ---

  Parameters

  • options: Options<LibSqlDriver, EM, Entities>

  Returns LibSqlMikroORM<EM, Entities>

Properties

readonlyinheritedconfig

config: Configuration<LibSqlDriver, SqlEntityManager<LibSqlDriver> & EntityManager<LibSqlDriver>>

Inherited from MikroORM.config

readonlyinheriteddriver

driver: LibSqlDriver

Inherited from MikroORM.driver

inheritedem

em: EM & { ~entities?: Entities }

Inherited from MikroORM.em

The global EntityManager instance. If you are using RequestContext helper, it will automatically pick the request specific context under the hood

Accessors

inheritedentityGenerator

• get entityGenerator(): IEntityGenerator

• Inherited from MikroORM.entityGenerator

  Gets the EntityGenerator.

  ---

  Returns IEntityGenerator

inheritedmigrator

• get migrator(): IMigrator

• Inherited from MikroORM.migrator

  Gets the Migrator.

  ---

  Returns IMigrator

inheritedschema

• get schema(): ReturnType<ReturnType<Driver[getPlatform]>[getSchemaGenerator]>

• Inherited from MikroORM.schema

  Gets the SchemaGenerator.

  ---

  Returns ReturnType<ReturnType<Driver[getPlatform]>[getSchemaGenerator]>

inheritedseeder

• get seeder(): ISeedManager

• Inherited from MikroORM.seeder

  Gets the SeedManager

  ---

  Returns ISeedManager

Methods

inheritedcheckConnection

• checkConnection(): Promise<{ ok: true } | { error?: Error; ok: false; reason: string }>

• Inherited from MikroORM.checkConnection

  Checks whether the database connection is active, returns the reason if not.

  ---

  Returns Promise<{ ok: true } | { error?: Error; ok: false; reason: string }>

inheritedclose

• close(force): Promise<void>

• Inherited from MikroORM.close

  Closes the database connection.

  ---

  Parameters

  • force: boolean = false

  Returns Promise<void>

inheritedconnect

• connect(): Promise<LibSqlDriver>

• Inherited from MikroORM.connect

  Connects to the database.

  ---

  Returns Promise<LibSqlDriver>

inheriteddiscoverEntity

• discoverEntity<T>(entities, reset): void

• Inherited from MikroORM.discoverEntity

  Allows dynamically discovering new entity by reference, handy for testing schema diffing.

  ---

  Parameters

  • entities: T | T[]

  • optionalreset: EntityName | EntityName[]

  Returns void

inheritedgetMetadata

• getMetadata(): MetadataStorage
• getMetadata<Entity>(entityName): EntityMetadata<Entity, EntityCtor<Entity>>

• Inherited from MikroORM.getMetadata

  Gets the MetadataStorage.

  ---

  Returns MetadataStorage

inheritedisConnected

• isConnected(): Promise<boolean>

• Inherited from MikroORM.isConnected

  Checks whether the database connection is active.

  ---

  Returns Promise<boolean>

inheritedreconnect

• reconnect(options): Promise<void>

• Inherited from MikroORM.reconnect

  Reconnects, possibly to a different database.

  ---

  Parameters

  • options: Partial<Options<LibSqlDriver, EM, Entities>> = {}

  Returns Promise<void>

staticinit

• init<D, EM, Entities>(options): Promise<MikroORM<D, EM, Entities>>

• Overrides MikroORM.init

  Initialize the ORM, load entity metadata, create EntityManager and connect to the database. If you omit the options parameter, your CLI config will be used.

  ---

  Parameters

  • options: Options<D, EM, Entities>

  Returns Promise<MikroORM<D, EM, Entities>>