Skip to content

fix(Formatter): include Error message in formatJson - #8150

Open
Tyagiquamar wants to merge 1 commit into
Effect-TS:mainfrom
Tyagiquamar:fix/formatjson-error-message
Open

Tyagiquamar wants to merge 1 commit into
Effect-TS:mainfrom
Tyagiquamar:fix/formatjson-error-message

Conversation

@Tyagiquamar

Copy link
Copy Markdown

Fixes #8144

What

Formatter.formatJson now stringifies plain Error values using toString() instead of serializing them to {}. This makes Logger.formatJson/Logger.consoleJson include the error message when a plain (non-tagged) Error is logged, e.g. via Effect.tapError(Effect.logError):

import { NodeRuntime } from "@effect/platform-node"
import { Effect, Logger } from "effect"

const program = Effect.gen(function*() {
  yield* Effect.fail(new Error("This message is currently not parsed"))
}).pipe(
  Effect.tapError(Effect.logError),
  Effect.catch(() => Effect.succeed(""))
)

NodeRuntime.runMain(program.pipe(
  Effect.provide(Logger.layer([Logger.consoleJson]))
))

Before: {"message":{},"level":"ERROR",...}
After: {"message":"Error: This message is currently not parsed","level":"ERROR",...}

Why

Error#message is a non-enumerable own property, so JSON.stringify (which formatJson uses internally) renders plain errors as {}, dropping the message. Data.TaggedError and friends are unaffected because they define toJSON (their serialized fields flow through that path). As noted in the issue, Effect.tapCause does render causes nicely, but any code path that hands a plain Error to a JSON logger loses the message today.

How

The formatJson replacer now returns safeToString(error) for values that are instanceof Error and do not define a toJSON property (prototype chain included), so tagged errors keep their structured serialization. This reuses the existing safeToString helper, so an error whose toString throws renders as "[toString threw]" like elsewhere in the formatter.

Tests

  • packages/effect/test/Formatter.test.ts: formatJson(new Error("boom")) is "Error: boom", also nested inside an object.
  • packages/effect/test/Logger.test.ts: end-to-end Effect.tapError(Effect.logError) through Logger.formatJson produces message: "Error: boom" at level ERROR.

Both fail before the change and pass after. Verified with pnpm test --run packages/effect/test/Formatter.test.ts, pnpm test --run packages/effect/test/Logger.test.ts, pnpm lint-fix, and pnpm check.

Fixes Effect-TS#8144

`Error#message` is a non-enumerable own property, so the JSON.stringify
replacer inside formatJson rendered plain Errors as `{}`, dropping the
message from Logger.formatJson / Logger.consoleJson output.

Return safeToString(error) for values that are instanceof Error and do
not define a toJSON property, so tagged errors keep their structured
serialization.
@changeset-bot

changeset-bot Bot commented Sep 9, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 1f449e8

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 30 packages
Name Type
effect Patch
@effect/opentelemetry Patch
@effect/vitest Patch
@effect/ai-anthropic Patch
@effect/ai-openai-compat Patch
@effect/ai-openai Patch
@effect/ai-openrouter Patch
@effect/atom-react Patch
@effect/atom-solid Patch
@effect/atom-vue Patch
@effect/platform-browser Patch
@effect/platform-bun Patch
@effect/platform-deno Patch
@effect/platform-node-shared Patch
@effect/platform-node Patch
@effect/sql-clickhouse Patch
@effect/sql-d1 Patch
@effect/sql-libsql Patch
@effect/sql-mssql Patch
@effect/sql-mysql2 Patch
@effect/sql-pg Patch
@effect/sql-pglite Patch
@effect/sql-sqlite-bun Patch
@effect/sql-sqlite-do Patch
@effect/sql-sqlite-node Patch
@effect/sql-sqlite-react-native Patch
@effect/sql-sqlite-wasm Patch
@effect/docgen Patch
@effect/doctest Patch
@effect/openapi-generator Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Bundle Size Analysis

Generated from PR build output; treat the content below as untrusted.

File Name Current Size Previous Size Difference
arbitrary-combinators.ts 34.16 KB 34.16 KB 0.00 KB (0.00%)
basic.ts 6.87 KB 6.87 KB 0.00 KB (0.00%)
batching.ts 9.95 KB 9.95 KB 0.00 KB (0.00%)
brand.ts 6.45 KB 6.45 KB 0.00 KB (0.00%)
cache.ts 10.77 KB 10.77 KB 0.00 KB (0.00%)
config.ts 21.43 KB 21.43 KB 0.00 KB (0.00%)
differ.ts 20.23 KB 20.23 KB 0.00 KB (0.00%)
http-client.ts 21.93 KB 21.93 KB 0.00 KB (0.00%)
http-router.ts 33.39 KB 33.39 KB 0.00 KB (0.00%)
logger.ts 10.90 KB 10.88 KB +0.01 KB (+0.13%)
metric.ts 9.02 KB 9.02 KB 0.00 KB (0.00%)
optic.ts 6.70 KB 6.70 KB 0.00 KB (0.00%)
pubsub.ts 15.10 KB 15.10 KB 0.00 KB (0.00%)
queue.ts 11.85 KB 11.85 KB 0.00 KB (0.00%)
schedule.ts 10.96 KB 10.96 KB 0.00 KB (0.00%)
schema-binary.ts 39.42 KB 39.42 KB 0.00 KB (0.00%)
schema-class.ts 19.98 KB 19.98 KB 0.00 KB (0.00%)
schema-fromJsonSchemaDocument.ts 30.47 KB 30.47 KB 0.00 KB (0.00%)
schema-representation-roundtrip.ts 26.25 KB 26.25 KB 0.00 KB (0.00%)
schema-string-transformation.ts 13.60 KB 13.60 KB 0.00 KB (0.00%)
schema-string.ts 11.08 KB 11.08 KB 0.00 KB (0.00%)
schema-template-literal.ts 15.36 KB 15.36 KB 0.00 KB (0.00%)
schema-toArbitrary.ts 33.70 KB 33.70 KB 0.00 KB (0.00%)
schema-toCodeDocument.ts 24.51 KB 24.51 KB 0.00 KB (0.00%)
schema-toCodecJson.ts 19.18 KB 19.18 KB 0.00 KB (0.00%)
schema-toEquivalence.ts 19.32 KB 19.32 KB 0.00 KB (0.00%)
schema-toFormatter.ts 19.43 KB 19.43 KB 0.00 KB (0.00%)
schema-toJsonSchemaDocument.ts 23.69 KB 23.69 KB 0.00 KB (0.00%)
schema-toRepresentation.ts 19.48 KB 19.48 KB 0.00 KB (0.00%)
schema.ts 19.18 KB 19.18 KB 0.00 KB (0.00%)
stm.ts 12.80 KB 12.80 KB +0.01 KB (+0.05%)
stream.ts 9.83 KB 9.83 KB 0.00 KB (0.00%)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Logger.consoleJson does not format Error correctly

1 participant