globalErrorInEffectCatch

Warns when catch callbacks return global Error type instead of typed errors

Property	Value
Category	Anti-pattern
Default severity	warning
Fixable	No
Effect versions	v3, v4
Diagnostic codes	TS377022
Language Service name	globalErrorInEffectCatch
Oxlint name	effecttsgo/global-error-in-effect-catch

Preview

import { Effect } from "effect"

export const preview = Effect.tryPromise({
/**
                       ^^^^^^^^^^^^^^^^^ effecttsgo(global-error-in-effect-catch): The `catch` callback in `Effect.tryPromise` returns the global `Error` type. Untagged errors merge together in the Effect error channel and lose type-level distinction; a tagged error preserves that distinction and can wrap the original error in a `cause` property.
*/
  try: async () => 1,
  catch: (error) => new Error(String(error))
})

Language Service Configuration

See the Language Service setup guide for installation instructions.

{
  "$schema": "./node_modules/@effect/tsgo/schema.json",
  "compilerOptions": {
    "plugins": [
      {
        "name": "@effect/language-service",
        "diagnosticSeverity": {
          "globalErrorInEffectCatch": "warning"
        }
      }
    ]
  }
}

Oxlint Configuration

See the Oxlint setup guide for installation and patching instructions.

{
  "$schema": "./node_modules/@effect/tsgo/oxlint-schema.json",
  "options": {
    "typeAware": true
  },
  "plugins": ["effecttsgo"],
  "rules": {
    "effecttsgo/global-error-in-effect-catch": "warn"
  }
}