Skip to content

catch

Instance method on Promise.prototype.

Attaches a callback for only the rejection of the Promise.

catch(input: { promise: <receiver>; onrejected?: (reason: any) => TResult | PromiseLike<TResult>; prompt?: string }): Promise<Promise<T | TResult>>

The prompt field is optional. When omitted (or set to an empty string) the wrapper falls back to the native Promise.prototype.catch and returns a resolved Promise without contacting the LLM. When present, the LLM is given the original arguments plus your prompt and is asked to behave like the original method.

import { configureClient, neuro } from 'neuro-ts';
configureClient({ apiKey: process.env.OPENAI_API_KEY });
// Rejection handler. Sugar over then(undefined, onrejected). The dark side, made palatable.
await neuro.promise.catch({ promise: target, onrejected: (e) => fallback(e), prompt: 'attach a rejection handler, returning a new promise that fulfills with the handler\'s return - syntactic comfort wrapped around the dark side of then()' });

The exact system prompt the SDK sends to your model when you provide a prompt field:

Generated promptPromise.prototype.catch
You are simulating the JavaScript built-in `Promise.prototype.catch`.
## Original signature(s)
  Overload 1: (onrejected?: (reason: any) => TResult | PromiseLike<TResult>) => Promise<T | TResult>
## JSDoc
Attaches a callback for only the rejection of the Promise.

## How to respond
- Behave EXACTLY as the original `catch` would, but use the user's intent to choose any callback / comparator / transform logic that the original would normally accept as an argument.
- Strictly preserve the original return type and shape.
- Output ONLY the JSON-encoded return value of the function call.
- Do NOT include explanations, prose, comments, or markdown fences.
- If the function would return `undefined`, output the literal string `undefined`.
- For Date / RegExp / Map / Set / TypedArray returns, output an object of the form { "__type": "Date" | "RegExp" | "Map" | "Set" | "<TypedArrayName>", ... } so the SDK can rehydrate it.