{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-error-handling",
  "id": "error-handling",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-correctness-core",
    "json": "https://banes-lab.com/json/records/layer/correctness-core",
    "label": "Correctness Core",
    "markdown": "https://banes-lab.com/records/layer/correctness-core.md",
    "ref": "layer:correctness-core"
  },
  "name": "Error Handling",
  "ref": "architecture:error-handling",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-error-model",
          "json": "https://banes-lab.com/json/records/lexicon/error-model",
          "label": "Error Model",
          "markdown": "https://banes-lab.com/records/lexicon/error-model.md",
          "ref": "lexicon:error-model"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-observability",
          "json": "https://banes-lab.com/json/records/architecture/observability",
          "label": "Observability",
          "markdown": "https://banes-lab.com/records/architecture/observability.md",
          "ref": "architecture:observability"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-resilience",
          "json": "https://banes-lab.com/json/records/architecture/resilience",
          "label": "Resilience",
          "markdown": "https://banes-lab.com/records/architecture/resilience.md",
          "ref": "architecture:resilience"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-correctness",
          "json": "https://banes-lab.com/json/records/architecture/correctness",
          "label": "Correctness",
          "markdown": "https://banes-lab.com/records/architecture/correctness.md",
          "ref": "architecture:correctness"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-controlled-failure",
          "json": "https://banes-lab.com/json/records/lexicon/controlled-failure",
          "label": "Controlled Failure",
          "markdown": "https://banes-lab.com/records/lexicon/controlled-failure.md",
          "ref": "lexicon:controlled-failure"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-exception-swallowing",
          "json": "https://banes-lab.com/json/records/lexicon/exception-swallowing",
          "label": "Exception Swallowing",
          "markdown": "https://banes-lab.com/records/lexicon/exception-swallowing.md",
          "ref": "lexicon:exception-swallowing"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-exception-control-flow",
          "json": "https://banes-lab.com/json/records/architecture/exception-control-flow",
          "label": "Exception Control Flow",
          "markdown": "https://banes-lab.com/records/architecture/exception-control-flow.md",
          "ref": "architecture:exception-control-flow"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-simplicity",
          "json": "https://banes-lab.com/json/records/lexicon/simplicity",
          "label": "Simplicity",
          "markdown": "https://banes-lab.com/records/lexicon/simplicity.md",
          "ref": "lexicon:simplicity"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-error-handling-simplicity",
          "json": "https://banes-lab.com/json/records/tension/error-handling-simplicity",
          "label": "Error Handling / Simplicity",
          "markdown": "https://banes-lab.com/records/tension/error-handling-simplicity.md",
          "ref": "tension:error-handling-simplicity"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-exception-swallowing",
          "json": "https://banes-lab.com/json/records/lexicon/exception-swallowing",
          "label": "Exception Swallowing",
          "markdown": "https://banes-lab.com/records/lexicon/exception-swallowing.md",
          "ref": "lexicon:exception-swallowing"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-silent-failure",
          "json": "https://banes-lab.com/json/records/lexicon/silent-failure",
          "label": "Silent Failure",
          "markdown": "https://banes-lab.com/records/lexicon/silent-failure.md",
          "ref": "lexicon:silent-failure"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-introduce-typed-result",
          "json": "https://banes-lab.com/json/records/lexicon/introduce-typed-result",
          "label": "Introduce Typed Result",
          "markdown": "https://banes-lab.com/records/lexicon/introduce-typed-result.md",
          "ref": "lexicon:introduce-typed-result"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-distributed-tracing",
          "json": "https://banes-lab.com/json/records/architecture/distributed-tracing",
          "label": "Distributed Tracing",
          "markdown": "https://banes-lab.com/records/architecture/distributed-tracing.md",
          "ref": "architecture:distributed-tracing"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-mandatory",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-mandatory",
          "label": "mandatory",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-mandatory.md",
          "ref": "vocabulary:severity-mandatory"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/records/architecture-category/error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/records/architecture-category/error-handling-resilience.md",
          "ref": "architecture-category:error-handling-resilience"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-no-swallowed-failure-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/no-swallowed-failure.eslint.rule.ts",
          "label": "rules/eslint/no-swallowed-failure.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/no-swallowed-failure.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-no-swallowed-failure-eslint-rule-ts"
        },
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-require-signal-guard-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/require-signal-guard.eslint.rule.ts",
          "label": "rules/eslint/require-signal-guard.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/require-signal-guard.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-require-signal-guard-eslint-rule-ts"
        }
      ],
      "relation": "enforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-defensive-programming",
          "json": "https://banes-lab.com/json/records/architecture/defensive-programming",
          "label": "Defensive Programming",
          "markdown": "https://banes-lab.com/records/architecture/defensive-programming.md",
          "ref": "architecture:defensive-programming"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-fault-tolerance",
          "json": "https://banes-lab.com/json/records/architecture/fault-tolerance",
          "label": "Fault Tolerance",
          "markdown": "https://banes-lab.com/records/architecture/fault-tolerance.md",
          "ref": "architecture:fault-tolerance"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/pag/patterns#algorithm-integration",
          "json": "https://banes-lab.com/json/pag/patterns/algorithm-integration",
          "label": "Integrating algorithms",
          "markdown": "https://banes-lab.com/pag/patterns/algorithm-integration.md",
          "ref": "chapter:/pag/patterns#algorithm-integration"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#execution-joins-the-halves",
          "json": "https://banes-lab.com/json/software-architecture/principles/execution-joins-the-halves",
          "label": "Execution joins the halves",
          "markdown": "https://banes-lab.com/software-architecture/principles/execution-joins-the-halves.md",
          "ref": "chapter:/software-architecture/principles#execution-joins-the-halves"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-error-handling-resilience.md",
          "ref": "chapter:/ontology#architecture-category-error-handling-resilience"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-observability-auditability-traceability",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-observability-auditability-traceability",
          "label": "Observability / Auditability / Traceability",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-observability-auditability-traceability.md",
          "ref": "chapter:/ontology#architecture-category-observability-auditability-traceability"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-error-handling-resilience.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-error-handling-resilience"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-quality-attributes",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-quality-attributes",
          "label": "Quality Attributes",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-quality-attributes"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A design rule that every error is either handled with its context kept, or propagated as a typed error the caller must handle.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-error-boundaries",
      "json": "https://banes-lab.com/json/records/architecture/error-boundaries",
      "label": "Error Boundaries",
      "markdown": "https://banes-lab.com/records/architecture/error-boundaries.md",
      "ref": "architecture:error-boundaries"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-robustness-principle",
      "json": "https://banes-lab.com/json/records/architecture/robustness-principle",
      "label": "Robustness Principle",
      "markdown": "https://banes-lab.com/records/architecture/robustness-principle.md",
      "ref": "architecture:robustness-principle"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "type LoadFooResult =\n  | { ok: true; value: Foo }\n  | { ok: false; error: \"NOT_FOUND\" | \"STORE_UNAVAILABLE\" };\nasync function loadFoo(id: FooId): Promise<LoadFooResult> {\n  return fooStore.findResult(id);\n}",
    "before": "async function loadFoo(id: FooId) {\n  try { return await fooStore.find(id); } catch { return null; }\n}",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "function",
    "module",
    "service"
  ],
  "severity": "mandatory"
}