add causedBy to StagehandDefaultError (#1363)

seanmcguire12 · web-flow · commit 223e1586ede3 · 2025-12-04T16:24:21.000-08:00
# why - to show the full error stack # what changed - added causedBy to the stagehand default error class # test plan  --- ## Summary by cubic Adds causedBy to StagehandDefaultError to retain the underlying error and make full stacks easier to debug. - **New Features** - StagehandDefaultError now sets causedBy when constructed with Error or StagehandError. - Keeps existing message format; no breaking changes. <sup>Written for commit ce21a92. Summary will update automatically on new commits.</sup>
diff --git a/.changeset/swift-hands-divide.md b/.changeset/swift-hands-divide.md
@@ -0,0 +1,5 @@
+---
+"@browserbasehq/stagehand": patch
+---
+
+add causedBy to StagehandDefaultError
diff --git a/types/stagehandErrors.ts b/types/stagehandErrors.ts
@@ -9,11 +9,14 @@ export class StagehandError extends Error {
 }
 
 export class StagehandDefaultError extends StagehandError {
+  public causedBy?: Error | StagehandError;
+
   constructor(error?: unknown) {
     if (error instanceof Error || error instanceof StagehandError) {
       super(
         `\nHey! We're sorry you ran into an error. \nStagehand version: ${STAGEHAND_VERSION} \nIf you need help, please open a Github issue or reach out to us on Slack: https://stagehand.dev/slack\n\nFull error:\n${error.message}`,
       );
+      this.causedBy = error;
     }
   }
 }

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"@browserbasehq/stagehand": patch
 +---
++
 +add causedBy to StagehandDefaultError
Original file line number	Diff line number	Diff line change
`@@ -9,11 +9,14 @@ export class StagehandError extends Error {`
`9`	`9`	`}`
`10`	`10`
`11`	`11`	`export class StagehandDefaultError extends StagehandError {`
	`12`	`+ public causedBy?: Error \| StagehandError;`
	`13`	`+`
`12`	`14`	`constructor(error?: unknown) {`
`13`	`15`	`if (error instanceof Error \|\| error instanceof StagehandError) {`
`14`	`16`	`super(`
`15`	`17`	`\nHey! We're sorry you ran into an error. \nStagehand version: ${STAGEHAND_VERSION} \nIf you need help, please open a Github issue or reach out to us on Slack: https://stagehand.dev/slack\n\nFull error:\n${error.message}`,
`16`	`18`	`);`
	`19`	`+ this.causedBy = error;`
`17`	`20`	`}`
`18`	`21`	`}`
`19`	`22`	`}`