Class

GroebnerBudgetExceeded

src/algebra/algorithms/groebnerBase.ts:81

Thrown when a Groebner pair-count or basis-size budget is exhausted. GroebnerBudgetExceeded.stats is the live counter snapshot from the aborted computation. The error keeps that object by reference and does not freeze it.

Members

captureStackTrace(targetObject: object, constructorOpt?: Function): voidMethod

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

Name	Type	Description
`targetObject`	`object`	—
`constructorOpt`	`Function`	—

Returns

void

cause: unknownProperty

No description is available yet.

GroebnerBudgetExceeded(message: string, stats: GroebnerStats): GroebnerBudgetExceededConstructor

No description is available yet.

Parameters

Name	Type	Description
`message`	`string`	Human-readable budget condition.
`stats`	`GroebnerStats`	Counter snapshot retained on the error.

Returns

GroebnerBudgetExceeded

message: stringProperty

No description is available yet.

name: stringProperty

No description is available yet.

prepareStackTrace(err: Error, stackTraces: CallSite[]): anyMethod

see

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

Parameters

Name	Type	Description
`err`	`Error`	—
`stackTraces`	`CallSite[]`	—

Returns

any

stack: stringProperty

No description is available yet.

stackTraceLimit: numberProperty

The

`Error.stackTraceLimit`

property specifies the number of stack frames collected by a stack trace (whether generated by

`new Error().stack`

`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.

stats: GroebnerStatsProperty

Work counters at the point the budget was exceeded.