跳到主要内容

WorkingTreeWriteRejectedError

Defined in: packages/rxdb-plugin-working-tree/src/working-tree/write-entry-matrix.ts:164

一次被门禁拒下的写

Remarks​

拒绝发生在语句执行前，业务表零变化——不是写完再回滚。raw 通道上根本没有事务可回滚， 而那正是 raw 通道存在的原因。

判别位给两个：name 供本进程内 instanceof 之外的兜底，code 供跨 realm 判别。 entrance 让调用方知道是哪条路被拦的——同一个码在四个挂载点与六个适配器上都可能抛出， 没有它，日志里只剩「有人裸写了版本化表」。

Extends​

Constructors​

Constructor​

new WorkingTreeWriteRejectedError(rejection): WorkingTreeWriteRejectedError;

Defined in: packages/rxdb-plugin-working-tree/src/working-tree/write-entry-matrix.ts:185

由五个拒绝点构造：四个挂载点各自的门，加上 raw 通道的判定。

Parameters​

ParameterTypeDescription
rejection{ entityName?: string; entrance: | "unknown" | "crud" | "domain_recompute" | "remote_entity_apply" | "cleanup_expired" | "projection_rewrite" | "metadata_only_prefetch" | "query_cache_maintenance" | "raw_write" | "bulk_write" | "notify_external_update"; message: string; }拒绝现场：被拦的入口、解析得到的实体名（raw 通道上可能解析不出）、 以及已经拼好的文案
rejection.entityName?string-
rejection.entrance| "unknown" | "crud" | "domain_recompute" | "remote_entity_apply" | "cleanup_expired" | "projection_rewrite" | "metadata_only_prefetch" | "query_cache_maintenance" | "raw_write" | "bulk_write" | "notify_external_update"-
rejection.messagestring-

Returns​

WorkingTreeWriteRejectedError

Remarks​

收一个对象而不是三个位置参数：三者里有两个是字符串，位置参数下把 entityName 与 message 写反不会有编译错误，只会让日志里的实体名变成一整句话，而这个错误的用途 恰恰就是让日志能回答「谁在裸写版本化表」。

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

code​

readonly code: "commit_capability_mismatch" = CommitErrorCode.commit_capability_mismatch;

Defined in: packages/rxdb-plugin-working-tree/src/working-tree/write-entry-matrix.ts:166

epic-006 指定的稳定错误码，取自 CommitErrorCode

entityName​

readonly entityName: string | undefined;

Defined in: packages/rxdb-plugin-working-tree/src/working-tree/write-entry-matrix.ts:172

被写的实体名；raw 通道上解析不出实体时为 undefined

entrance​

readonly entrance: 
  | "unknown"
  | "crud"
  | "domain_recompute"
  | "remote_entity_apply"
  | "cleanup_expired"
  | "projection_rewrite"
  | "metadata_only_prefetch"
  | "query_cache_maintenance"
  | "raw_write"
  | "bulk_write"
  | "notify_external_update";

Defined in: packages/rxdb-plugin-working-tree/src/working-tree/write-entry-matrix.ts:169

被拦下的那条写入口

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​

ParameterType
targetObjectobject
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​

ParameterType
errError
stackTracesCallSite[]

Returns​

any

See​

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

Inherited from​

RxDBError.prepareStackTrace