RxDBPluginDependencyCycleError

Defined in: packages/rxdb/src/RxDBError.ts:248

插件依赖成环 —— 在安装规划阶段抛出（US-015 AC#16）。

Remarks

环不能留到运行期发现：inject 的语义是「依赖就绪后才安装」，成环意味着环上每个插件都在 等下一个进入 active，谁都不会开工。那种形态在外部看是「插件静默不装」，与依赖缺失 （AC#15）完全同形，却要用完全不同的办法修。因此在 reconcile() 之前就拒绝， 此时一个 install() 都还没跑过，不存在半装状态。

message 给出完整环路径而不只是「检测到环」：N 个插件的依赖图靠人工重建的成本， 正是这条错误要替调用方省掉的。

Extends

• RxDBError

Constructors

Constructor

new RxDBPluginDependencyCycleError(cycle): RxDBPluginDependencyCycleError;

Defined in: packages/rxdb/src/RxDBError.ts:249

Parameters

Parameter	Type	Description
cycle	readonly string[]	环路径上的插件名，首尾为同一个插件（如 ['a', 'b', 'a']）

Returns

RxDBPluginDependencyCycleError

Overrides

RxDBError.constructor

Properties

cause?

optional cause?: unknown;

Defined in: node_modules/.pnpm/typescript@6.0.3_patch_hash=ef3c2292deb88eb14130359d5acc1febc0226af46b7b945db6c7250c6cb4efbb/node_modules/typescript/lib/lib.es2022.error.d.ts:24

Inherited from

RxDBError.cause

---

cycle

readonly cycle: readonly string[];

Defined in: packages/rxdb/src/RxDBError.ts:251

环路径上的插件名，首尾为同一个插件（如 ['a', 'b', 'a']）

---

message

message: string;

Defined in: node_modules/.pnpm/typescript@6.0.3_patch_hash=ef3c2292deb88eb14130359d5acc1febc0226af46b7b945db6c7250c6cb4efbb/node_modules/typescript/lib/lib.es5.d.ts:1075

Inherited from

RxDBError.message

---

name

name: string;

Defined in: node_modules/.pnpm/typescript@6.0.3_patch_hash=ef3c2292deb88eb14130359d5acc1febc0226af46b7b945db6c7250c6cb4efbb/node_modules/typescript/lib/lib.es5.d.ts:1074

Inherited from

RxDBError.name

---

stack?

optional stack?: string;

Defined in: node_modules/.pnpm/typescript@6.0.3_patch_hash=ef3c2292deb88eb14130359d5acc1febc0226af46b7b945db6c7250c6cb4efbb/node_modules/typescript/lib/lib.es5.d.ts:1076

Inherited from

RxDBError.stack

---

stackTraceLimit

static stackTraceLimit: number;

Defined in: node_modules/.pnpm/@types+node@26.6.3/node_modules/@types/node/globals.d.ts:67

The Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by new Error().stack or Error.captureStackTrace(obj)).

The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed.

If set to a non-number value, or set to a negative number, stack traces will not capture any frames.

Inherited from

RxDBError.stackTraceLimit

Methods

captureStackTrace()

static captureStackTrace(targetObject, constructorOpt?): void;

Defined in: node_modules/.pnpm/@types+node@26.6.3/node_modules/@types/node/globals.d.ts:51

Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack;  // Similar to `new Error().stack`

The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

function a() {
  b();
}

function b() {
  c();
}

function c() {
  // Create an error without stack trace to avoid calculating the stack trace twice.
  const { stackTraceLimit } = Error;
  Error.stackTraceLimit = 0;
  const error = new Error();
  Error.stackTraceLimit = stackTraceLimit;

  // Capture the stack trace above function b
  Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
  throw error;
}

a();

Parameters

Parameter	Type
targetObject	object
constructorOpt?	Function

Returns

void

Inherited from

RxDBError.captureStackTrace

---

prepareStackTrace()

static prepareStackTrace(err, stackTraces): any;

Defined in: node_modules/.pnpm/@types+node@26.6.3/node_modules/@types/node/globals.d.ts:55

Parameters

Parameter	Type
err	Error
stackTraces	CallSite[]

Returns

any

See

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Inherited from

RxDBError.prepareStackTrace