logologo
スタート
マニュアル
開発
プラグイン
API
ホーム
English
简体中文
日本語
한국어
Español
Português
Deutsch
Français
Русский
スタート
マニュアル
開発
プラグイン
API
ホーム
logologo
API概要

@nocobase/auth

AuthManager
Auth
BaseAuth

@nocobase/cache

CacheManager
キャッシュ

@nocobase/cli

NocoBase CLI
グローバル環境変数

@nocobase/client

アプリケーション
プラグイン

@nocobase/database

コレクション
フィールド

interfaces

BaseInterface
フィルター演算子

RelationRepository

BelongsToManyRepository
belongs-to-repository
HasManyRepository
HasOneRepository
リポジトリ

shared

create-options
destroy-options
find-one
find-options
transaction
update-options

@nocobase/data-source-manager

DataSourceManager
DataSource (抽象)
ICollectionManager
ICollection
IField
IModel
IRepository

@nocobase/flow-engine

データソースマネージャー
フローコンテキスト
FlowEngine
フローモデル
フローリソース

@nocobase/logger

ロガー

@nocobase/server

AppCommand
アプリケーション
AuditManager
コンテキスト
マイグレーション
プラグイン

@nocobase/sdk

Auth
ストレージ
Previous Pageプラグイン
Next Pageコレクション
TIP

このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください

#データベース

#概要

データベースは、NocoBaseが提供するデータベース操作ツールで、ノーコード・ローコードアプリケーション向けに非常に便利なデータベース連携機能を提供しています。現在サポートしているデータベースは以下の通りです。

  • SQLite 3.8.8+
  • MySQL 8.0.17+
  • PostgreSQL 10.0+

#データベースへの接続

Database コンストラクタでは、options パラメータを渡すことでデータベース接続を設定できます。

const { Database } = require('@nocobase/database');

// SQLite データベース設定パラメータ
const database = new Database({
  dialect: 'mysql',
  host: 'localhost',
  port: 3306,
  database: 'nocobase',
  username: 'root',
  password: 'password'
})

// MySQL / PostgreSQL データベース設定パラメータ
const database = new Database({
  dialect: /* 'postgres' または 'mysql' */,
  database: 'database',
  username: 'username',
  password: 'password',
  host: 'localhost',
  port: 'port'
})

詳細な設定パラメータについては、コンストラクタ をご参照ください。

#データモデルの定義

Database はコレクションを通じてデータベース構造を定義します。一つのコレクションオブジェクトは、データベース内のテーブル一つを表します。

// コレクションの定義
const UserCollection = database.collection({
  name: 'users',
  fields: [
    {
      name: 'name',
      type: 'string',
    },
    {
      name: 'age',
      type: 'integer',
    },
  ],
});

データベース構造の定義が完了したら、sync() メソッドを使用してデータベース構造を同期できます。

await database.sync();

コレクションのより詳細な使用方法については、コレクション をご参照ください。

#データの読み書き

Database はリポジトリを通じてデータを操作します。

const UserRepository = UserCollection.repository();

// 作成
await UserRepository.create({
  name: 'ジョン',
  age: 18,
});

// 検索
const user = await UserRepository.findOne({
  filter: {
    name: 'ジョン',
  },
});

// 更新
await UserRepository.update({
  values: {
    age: 20,
  },
});

// 削除
await UserRepository.destroy(user.id);

データCRUDのより詳細な使用方法については、リポジトリ をご参照ください。

#コンストラクタ

シグネチャ

  • constructor(options: DatabaseOptions)

データベースインスタンスを作成します。

パラメータ

パラメータ名型デフォルト値説明
options.hoststring'localhost'データベースホスト
options.portnumber-データベースサービスポート。使用するデータベースに応じてデフォルトポートがあります。
options.usernamestring-データベースユーザー名
options.passwordstring-データベースパスワード
options.databasestring-データベース名
options.dialectstring'mysql'データベースタイプ
options.storage?string':memory:'SQLite のストレージモード
options.logging?booleanfalseログを有効にするかどうか
options.define?Object{}デフォルトのテーブル定義パラメータ
options.tablePrefix?string''NocoBase 拡張機能、テーブル名のプレフィックス
options.migrator?UmzugOptions{}NocoBase 拡張機能、マイグレーションマネージャー関連パラメータ。 Umzug の実装をご参照ください。

#マイグレーション関連メソッド

#addMigration()

単一のマイグレーションファイルを追加します。

シグネチャ

  • addMigration(options: MigrationItem)

パラメータ

パラメータ名型デフォルト値説明
options.namestring-マイグレーションファイル名
options.context?string-マイグレーションファイルのコンテキスト
options.migration?typeof Migration-マイグレーションファイルのカスタムクラス
options.upFunction-マイグレーションファイルの up メソッド
options.downFunction-マイグレーションファイルの down メソッド

例

db.addMigration({
  name: '20220916120411-test-1',
  async up() {
    const queryInterface = this.context.db.sequelize.getQueryInterface();
    await queryInterface.query(/* マイグレーションSQL */);
  },
});

#addMigrations()

指定されたディレクトリからマイグレーションファイルを追加します。

シグネチャ

  • addMigrations(options: AddMigrationsOptions): void

パラメータ

パラメータ名型デフォルト値説明
options.directorystring''マイグレーションファイルが配置されているディレクトリ
options.extensionsstring[]['js', 'ts']ファイル拡張子
options.namespace?string''ネームスペース
options.context?Object{ db }マイグレーションファイルのコンテキスト

例

db.addMigrations({
  directory: path.resolve(__dirname, './migrations'),
  namespace: 'test',
});

#ユーティリティメソッド

#inDialect()

現在のデータベースタイプが指定されたタイプであるかどうかを判断します。

シグネチャ

  • inDialect(dialect: string[]): boolean

パラメータ

パラメータ名型デフォルト値説明
dialectstring[]-データベースタイプ。mysql/postgres/mariadb のいずれかを選択できます。

#getTablePrefix()

設定からテーブル名のプレフィックスを取得します。

シグネチャ

  • getTablePrefix(): string

#コレクション設定

#collection()

コレクションを定義します。この呼び出しはSequelizeのdefineメソッドに似ており、メモリ内でのみテーブル構造を作成します。データベースに永続化するには、syncメソッドを呼び出す必要があります。

シグネチャ

  • collection(options: CollectionOptions): Collection

パラメータ

すべてのoptions設定パラメータは、コレクションクラスのコンストラクタと一致します。コレクション をご参照ください。

イベント

  • 'beforeDefineCollection':コレクションを定義する前にトリガーされます。
  • 'afterDefineCollection':コレクションを定義した後にトリガーされます。

例

db.collection({
  name: 'books',
  fields: [
    {
      type: 'string',
      name: 'title',
    },
    {
      type: 'float',
      name: 'price',
    },
  ],
});

// コレクションをテーブルとしてDBに同期
await db.sync();

#getCollection()

定義済みのコレクションを取得します。

シグネチャ

  • getCollection(name: string): Collection

パラメータ

パラメータ名型デフォルト値説明
namestring-コレクション名

例

const collection = db.getCollection('books');

#hasCollection()

指定されたコレクションが定義されているかどうかを判断します。

シグネチャ

  • hasCollection(name: string): boolean

パラメータ

パラメータ名型デフォルト値説明
namestring-コレクション名

例

db.collection({ name: 'books' });

db.hasCollection('books'); // true

db.hasCollection('authors'); // false

#removeCollection()

定義済みのコレクションを削除します。メモリからのみ削除され、変更を永続化するにはsyncメソッドを呼び出す必要があります。

シグネチャ

  • removeCollection(name: string): void

パラメータ

パラメータ名型デフォルト値説明
namestring-コレクション名

イベント

  • 'beforeRemoveCollection':コレクションを削除する前にトリガーされます。
  • 'afterRemoveCollection':コレクションを削除した後にトリガーされます。

例

db.collection({ name: 'books' });

db.removeCollection('books');

#import()

ディレクトリ内のすべてのファイルをコレクション設定としてメモリにインポートします。

シグネチャ

  • async import(options: { directory: string; extensions?: ImportFileExtension[] }): Promise<Map<string, Collection>>

パラメータ

パラメータ名型デフォルト値説明
options.directorystring-インポートするディレクトリのパス
options.extensionsstring[]['ts', 'js']スキャンするファイル拡張子

例

./collections/books.ts ファイルで定義されているコレクションは以下の通りです。

export default {
  name: 'books',
  fields: [
    {
      type: 'string',
      name: 'title',
    },
  ],
};

プラグインのロード時に、関連する設定をインポートします。

class Plugin {
  async load() {
    await this.app.db.import({
      directory: path.resolve(__dirname, './collections'),
    });
  }
}

#拡張機能の登録と取得

#registerFieldTypes()

カスタムフィールドタイプを登録します。

シグネチャ

  • registerFieldTypes(fieldTypes: MapOf<typeof Field>): void

パラメータ

fieldTypes はキーと値のペアで、キーはフィールドタイプ名、値はフィールドタイプクラスです。

例

import { Field } from '@nocobase/database';

class MyField extends Field {
  // ...
}

db.registerFieldTypes({
  myField: MyField,
});

#registerModels()

カスタムデータモデルクラスを登録します。

シグネチャ

  • registerModels(models: MapOf<ModelStatic<any>>): void

パラメータ

models はキーと値のペアで、キーはデータモデル名、値はデータモデルクラスです。

例

import { Model } from '@nocobase/database';

class MyModel extends Model {
  // ...
}

db.registerModels({
  myModel: MyModel,
});

db.collection({
  name: 'myCollection',
  model: 'myModel',
});

#registerRepositories()

カスタムリポジトリクラスを登録します。

シグネチャ

  • registerRepositories(repositories: MapOf<RepositoryType>): void

パラメータ

repositories はキーと値のペアで、キーはリポジトリ名、値はリポジトリクラスです。

例

import { Repository } from '@nocobase/database';

class MyRepository extends Repository {
  // ...
}

db.registerRepositories({
  myRepository: MyRepository,
});

db.collection({
  name: 'myCollection',
  repository: 'myRepository',
});

#registerOperators()

カスタムデータクエリ演算子を登録します。

シグネチャ

  • registerOperators(operators: MapOf<OperatorFunc>)

パラメータ

operators はキーと値のペアで、キーは演算子名、値は比較ステートメントを生成する関数です。

例

db.registerOperators({
  $dateOn(value) {
    return {
      [Op.and]: [
        { [Op.gte]: stringToDate(value) },
        { [Op.lt]: getNextDay(value) },
      ],
    };
  },
});

db.getRepository('books').count({
  filter: {
    createdAt: {
      // 登録された演算子
      $dateOn: '2020-01-01',
    },
  },
});

#getModel()

定義済みのデータモデルクラスを取得します。カスタムモデルクラスが以前に登録されていない場合、Sequelizeのデフォルトモデルクラスが返されます。デフォルト名はコレクションで定義された名前と同じです。

シグネチャ

  • getModel(name: string): Model

パラメータ

パラメータ名型デフォルト値説明
namestring-登録済みモデル名

例

db.registerModels({
  books: class MyModel extends Model {},
});

const ModelClass = db.getModel('books');

console.log(ModelClass.prototype instanceof MyModel); // true

注:コレクションから取得されるモデルクラスは、登録時のモデルクラスと厳密には等しくなく、登録時のモデルクラスを継承しています。Sequelizeのモデルクラスは初期化中にプロパティが変更されるため、NocoBaseはこの継承関係を自動的に処理します。クラスが等しくない点を除けば、他のすべての定義は正常に使用できます。

#getRepository()

カスタムリポジトリクラスを取得します。カスタムリポジトリクラスが以前に登録されていない場合、NocoBaseのデフォルトリポジトリクラスが返されます。デフォルト名はコレクションで定義された名前と同じです。

リポジトリクラスは、主にデータモデルに基づいたCRUD操作などに使用されます。リポジトリ をご参照ください。

シグネチャ

  • getRepository(name: string): Repository
  • getRepository(name: string, relationId?: string | number): Repository

パラメータ

パラメータ名型デフォルト値説明
namestring-登録済みリポジトリ名
relationIdstring | number-関連データの外部キー値

名前が'tables.relations'のような関連名の場合、関連するリポジトリクラスが返されます。2番目のパラメータが提供された場合、リポジトリは使用時(クエリ、更新など)に関連データの外部キー値に基づいて動作します。

例

記事と著者という2つのコレクションがあり、記事コレクションに著者コレクションを指す外部キーがあるとします。

const AuthorsRepo = db.getRepository('authors');
const author1 = AuthorsRepo.create({ name: 'author1' });

const PostsRepo = db.getRepository('authors.posts', author1.id);
const post1 = AuthorsRepo.create({ title: 'post1' });
asset(post1.authorId === author1.id); // true

#データベースイベント

#on()

データベースイベントをリッスンします。

シグネチャ

  • on(event: string, listener: (...args: any[]) => void | Promise<void>): void

パラメータ

パラメータ名型デフォルト値説明
eventstring-イベント名
listenerFunction-イベントリスナー

イベント名はデフォルトでSequelizeのModelイベントをサポートしています。グローバルイベントの場合は<sequelize_model_global_event>の形式で、単一のModelイベントの場合は<model_name>.<sequelize_model_event>の形式でリッスンします。

すべての組み込みイベントタイプのパラメータ説明と詳細な例については、組み込みイベント セクションをご参照ください。

#off()

イベントリスナー関数を削除します。

シグネチャ

  • off(name: string, listener: Function)

パラメータ

パラメータ名型デフォルト値説明
namestring-イベント名
listenerFunction-イベントリスナー

例

const listener = async (model, options) => {
  console.log(model);
};

db.on('afterCreate', listener);

db.off('afterCreate', listener);

#データベース操作

#auth()

データベース接続の認証を行います。アプリケーションとデータ間の接続が確立されていることを確認するために使用できます。

シグネチャ

  • auth(options: QueryOptions & { retry?: number } = {}): Promise<boolean>

パラメータ

パラメータ名型デフォルト値説明
options?Object-認証オプション
options.retry?number10認証失敗時のリトライ回数
options.transaction?Transaction-トランザクションオブジェクト
options.logging?boolean | Functionfalseログを出力するかどうか

例

await db.auth();

#reconnect()

データベースに再接続します。

例

await db.reconnect();

#closed()

データベース接続が閉じられているかどうかを判断します。

シグネチャ

  • closed(): boolean

#close()

データベース接続を閉じます。sequelize.close() と同等です。

#sync()

データベースのコレクション構造を同期します。sequelize.sync() と同等です。パラメータについては Sequelize ドキュメント をご参照ください。

#clean()

データベースをクリーンアップし、すべてのコレクションを削除します。

シグネチャ

  • clean(options: CleanOptions): Promise<void>

パラメータ

パラメータ名型デフォルト値説明
options.dropbooleanfalseすべてのコレクションを削除するかどうか
options.skipstring[]-スキップするコレクション名の設定
options.transactionTransaction-トランザクションオブジェクト

例

users コレクションを除くすべてのコレクションを削除します。

await db.clean({
  drop: true,
  skip: ['users'],
});

#パッケージレベルのエクスポート

#defineCollection()

コレクションの設定内容を作成します。

シグネチャ

  • defineCollection(name: string, config: CollectionOptions): CollectionOptions

パラメータ

パラメータ名型デフォルト値説明
collectionOptionsCollectionOptions-すべてのdb.collection()のパラメータと同じです。

例

db.import() によってインポートされるコレクション設定ファイルの場合:

import { defineCollection } from '@nocobase/database';

export default defineCollection({
  name: 'users',
  fields: [
    {
      type: 'string',
      name: 'name',
    },
  ],
});

#extendCollection()

メモリ内にあるコレクション構造の設定内容を拡張します。主にimport()メソッドでインポートされたファイルの内容に使用されます。このメソッドは@nocobase/databaseパッケージによってエクスポートされるトップレベルのメソッドであり、dbインスタンスを介して呼び出すことはありません。extendエイリアスも使用できます。

シグネチャ

  • extendCollection(collectionOptions: CollectionOptions, mergeOptions?: MergeOptions): ExtendedCollectionOptions

パラメータ

パラメータ名型デフォルト値説明
collectionOptionsCollectionOptions-すべてのdb.collection()のパラメータと同じです。
mergeOptions?MergeOptions-npmパッケージ deepmerge のパラメータ

例

元のbooksコレクション定義(books.ts):

export default {
  name: 'books',
  fields: [{ name: 'title', type: 'string' }],
};

拡張されたbooksコレクション定義(books.extend.ts):

import { extend } from '@nocobase/database';

// 再度拡張
export default extend({
  name: 'books',
  fields: [{ name: 'price', type: 'number' }],
});

上記の2つのファイルがimport()呼び出し時にインポートされ、extend()によって再度拡張された場合、booksコレクションはtitleとpriceの2つのフィールドを持つことになります。

このメソッドは、既存のプラグインによって既に定義されているコレクション構造を拡張する際に非常に役立ちます。

#組み込みイベント

データベースは、そのライフサイクルの適切なタイミングで以下のイベントをトリガーします。on()メソッドで購読し、特定の処理を行うことで、ビジネス要件を満たすことができます。

#'beforeSync' / 'afterSync'

新しいコレクション構造設定(フィールド、インデックスなど)がデータベースに同期される前後にトリガーされます。通常、collection.sync()(内部呼び出し)の実行時にトリガーされ、一般的に特殊なフィールド拡張のロジック処理に使用されます。

シグネチャ

on(eventName: `${string}.beforeSync` | 'beforeSync' | `${string}.afterSync` | 'afterSync', listener: SyncListener): this

型

import type { SyncOptions, HookReturn } from 'sequelize/types';

type SyncListener = (options?: SyncOptions) => HookReturn;

例

const users = db.collection({
  name: 'users',
  fields: [{ type: 'string', name: 'username' }],
});

db.on('beforeSync', async (options) => {
  // 何らかの処理を行う
});

db.on('users.afterSync', async (options) => {
  // 何らかの処理を行う
});

await users.sync();

#'beforeValidate' / 'afterValidate'

データの作成または更新前に、コレクション定義に基づいたルールによるデータ検証プロセスがあります。検証の前後に対応するイベントがトリガーされます。これはrepository.create()またはrepository.update()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.beforeValidate` | 'beforeValidate' | `${string}.afterValidate` | 'afterValidate', listener: ValidateListener): this

型

import type { ValidationOptions } from 'sequelize/types/lib/instance-validator';
import type { HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

type ValidateListener = (
  model: Model,
  options?: ValidationOptions,
) => HookReturn;

例

db.collection({
  name: 'tests',
  fields: [
    {
      type: 'string',
      name: 'email',
      validate: {
        isEmail: true,
      },
    },
  ],
});

// すべてのモデル
db.on('beforeValidate', async (model, options) => {
  // 何らかの処理を行う
});
// tests モデル
db.on('tests.beforeValidate', async (model, options) => {
  // 何らかの処理を行う
});

// すべてのモデル
db.on('afterValidate', async (model, options) => {
  // 何らかの処理を行う
});
// tests モデル
db.on('tests.afterValidate', async (model, options) => {
  // 何らかの処理を行う
});

const repository = db.getRepository('tests');
await repository.create({
  values: {
    email: 'abc', // メール形式をチェック
  },
});
// または
await repository.update({
  filterByTk: 1,
  values: {
    email: 'abc', // メール形式をチェック
  },
});

#'beforeCreate' / 'afterCreate'

レコードの作成前後に対応するイベントがトリガーされます。これはrepository.create()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.beforeCreate` | 'beforeCreate' | `${string}.afterCreate` | 'afterCreate', listener: CreateListener): this

型

import type { CreateOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type CreateListener = (
  model: Model,
  options?: CreateOptions,
) => HookReturn;

例

db.on('beforeCreate', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterCreate', async (model, options) => {
  const { transaction } = options;
  const result = await model.constructor.findByPk(model.id, {
    transaction,
  });
  console.log(result);
});

#'beforeUpdate' / 'afterUpdate'

レコードの更新前後に対応するイベントがトリガーされます。これはrepository.update()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.beforeUpdate` | 'beforeUpdate' | `${string}.afterUpdate` | 'afterUpdate', listener: UpdateListener): this

型

import type { UpdateOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type UpdateListener = (
  model: Model,
  options?: UpdateOptions,
) => HookReturn;

例

db.on('beforeUpdate', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterUpdate', async (model, options) => {
  // 何らかの処理を行う
});

#'beforeSave' / 'afterSave'

レコードの作成または更新前後に対応するイベントがトリガーされます。これはrepository.create()またはrepository.update()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.beforeSave` | 'beforeSave' | `${string}.afterSave` | 'afterSave', listener: SaveListener): this

型

import type { SaveOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type SaveListener = (model: Model, options?: SaveOptions) => HookReturn;

例

db.on('beforeSave', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterSave', async (model, options) => {
  // 何らかの処理を行う
});

#'beforeDestroy' / 'afterDestroy'

レコードの削除前後に対応するイベントがトリガーされます。これはrepository.destroy()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.beforeDestroy` | 'beforeDestroy' | `${string}.afterDestroy` | 'afterDestroy', listener: DestroyListener): this

型

import type { DestroyOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type DestroyListener = (
  model: Model,
  options?: DestroyOptions,
) => HookReturn;

例

db.on('beforeDestroy', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterDestroy', async (model, options) => {
  // 何らかの処理を行う
});

#'afterCreateWithAssociations'

階層的な関連データを持つレコードが作成された後に対応するイベントがトリガーされます。これはrepository.create()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.afterCreateWithAssociations` | 'afterCreateWithAssociations', listener: CreateWithAssociationsListener): this

型

import type { CreateOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type CreateWithAssociationsListener = (
  model: Model,
  options?: CreateOptions,
) => HookReturn;

例

db.on('afterCreateWithAssociations', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterCreateWithAssociations', async (model, options) => {
  // 何らかの処理を行う
});

#'afterUpdateWithAssociations'

階層的な関連データを持つレコードが更新された後に対応するイベントがトリガーされます。これはrepository.update()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.afterUpdateWithAssociations` | 'afterUpdateWithAssociations', listener: CreateWithAssociationsListener): this

型

import type { UpdateOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type UpdateWithAssociationsListener = (
  model: Model,
  options?: UpdateOptions,
) => HookReturn;

例

db.on('afterUpdateWithAssociations', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterUpdateWithAssociations', async (model, options) => {
  // 何らかの処理を行う
});

#'afterSaveWithAssociations'

階層的な関連データを持つレコードが作成または更新された後に対応するイベントがトリガーされます。これはrepository.create()またはrepository.update()が呼び出されたときにトリガーされます。

シグネチャ

on(eventName: `${string}.afterSaveWithAssociations` | 'afterSaveWithAssociations', listener: SaveWithAssociationsListener): this

型

import type { SaveOptions, HookReturn } from 'sequelize/types';
import type { Model } from '@nocobase/database';

export type SaveWithAssociationsListener = (
  model: Model,
  options?: SaveOptions,
) => HookReturn;

例

db.on('afterSaveWithAssociations', async (model, options) => {
  // 何らかの処理を行う
});

db.on('books.afterSaveWithAssociations', async (model, options) => {
  // 何らかの処理を行う
});

#'beforeDefineCollection'

コレクションが定義される前にトリガーされます。例えば、db.collection()が呼び出されたときなどです。

注:このイベントは同期イベントです。

シグネチャ

on(eventName: 'beforeDefineCollection', listener: BeforeDefineCollectionListener): this

型

import type { CollectionOptions } from '@nocobase/database';

export type BeforeDefineCollectionListener = (
  options: CollectionOptions,
) => void;

例

db.on('beforeDefineCollection', (options) => {
  // 何らかの処理を行う
});

#'afterDefineCollection'

コレクションが定義された後にトリガーされます。例えば、db.collection()が呼び出されたときなどです。

注:このイベントは同期イベントです。

シグネチャ

on(eventName: 'afterDefineCollection', listener: AfterDefineCollectionListener): this

型

import type { Collection } from '@nocobase/database';

export type AfterDefineCollectionListener = (options: Collection) => void;

例

db.on('afterDefineCollection', (collection) => {
  // 何らかの処理を行う
});

#'beforeRemoveCollection' / 'afterRemoveCollection'

コレクションがメモリから削除される前後にトリガーされます。例えば、db.removeCollection()が呼び出されたときなどです。

注:このイベントは同期イベントです。

シグネチャ

on(eventName: 'beforeRemoveCollection' | 'afterRemoveCollection', listener: RemoveCollectionListener): this

型

import type { Collection } from '@nocobase/database';

export type RemoveCollectionListener = (options: Collection) => void;

例

db.on('beforeRemoveCollection', (collection) => {
  // 何らかの処理を行う
});

db.on('afterRemoveCollection', (collection) => {
  // 何らかの処理を行う
});