Repository navigation
TC39 proposal - Error.cause property #45167
Description
Activity
Error.causeis also available in Node 16.9.0 now 🎉Reacted by Toni Villena, Lukas Elmer and Sebastian MaltonReacted by Toni Villena, Matt Mahnke, Yvann Boucher, Simon Siefke, Lukas Elmer and Jan KowalleckBump
Reacted by Toni VillenaAlready Stage 4 - the feature is finalized!
Reacted by Toni Villena, Martin Andrej Johan Grönlund, Lukas Elmer and Roger PadillaThis seems to be partially implemented.
The constructor now accepts
ErrorOptionswith thecauseproperty - which is great.
However, this property is not declared in the Error object itself.With the full implementation this example should compile:
const error = new Error("derived", {cause: new Error("original")}); // OK console.log(error.cause); // Property 'cause' doesn't existReacted by Danilo Bargen, Nathan Shively-Sanders, Tom Brennan, Moaad Fattali, Lukas Elmer and Roger PadillaThanks for pointing that out. I re-opened the bug.
Reacted by Lukas ElmerBump. Also ran into this. Fixed it local by redeclaring like this:
interface Error { name: string; message: string; cause?: any; stack?: string; } interface ErrorConstructor { new(message?: string, { cause }?: { cause: any }): Error; (message?: string): Error; readonly prototype: Error; } declare var Error: ErrorConstructor
I also had this issue for
causeandstack. Fixed it by redeclaring like this:interface ErrorInit { cause?: unknown; } declare type BaseError = Error; declare class Error implements BaseError { name: string; message: string; stack?: string; cause?: unknown; constructor(message?: string, init?: ErrorInit); // eslint-disable-next-line @typescript-eslint/ban-types -- Allow catch-all 'function' parameter type. static captureStackTrace(error: object, constructor?: Function): void; }
causewas added in #47020 and all definitions had shipped with 4.6.Reacted by Holger Jeromin, Martin Andrej Johan Grönlund, Matt Mahnke, Sung Jeon and mediscoSimon Chan (@yume-chan) Although the type is inaccurate, as per #48098.
Reacted by Martin Andrej Johan Grönlund- added a commit that references this issue
on May 25, 2022 - locked as resolved and limited conversation to collaborators
on Oct 21, 2025
lib.es2021d.ts Update Request - Error.cause property
Proposal (Stage 3)
https://github.com/tc39/proposal-error-cause
Already implemented in Chrome 93:
https://www.chromestatus.com/feature/5727099325251584
Sample Code