{"record":{"id":"4e74cf31e211f5b9","repo":"apache/beam","slug":"unexpected-tag-tag-for-wvalue-value-not-in-this-options","errorCode":null,"errorMessage":"Unexpected tag '${tag}' for ${wvalue.value} not in ${this.options.knownTags}","messagePattern":"Unexpected tag '(.+?)' for (.+?) not in (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"sdks/typescript/src/apache_beam/worker/operators.ts","lineNumber":837,"sourceCode":"\n  async startBundle() {}\n\n  process(wvalue: WindowedValue<unknown>) {\n    const result = new ProcessResultBuilder();\n    const keys = Object.keys(wvalue.value as object);\n    if (this.options.exclusive && keys.length !== 1) {\n      throw new Error(\n        \"Multiple keys for exclusively split element: \" + wvalue.value,\n      );\n    }\n    for (let tag of keys) {\n      if (!this.options.knownTags!.includes(tag)) {\n        if (this.options.unknownTagBehavior === \"rename\") {\n          tag = this.options.unknownTagName!;\n        } else if (this.options.unknownTagBehavior === \"ignore\") {\n          continue;\n        } else {\n          throw new Error(\n            \"Unexpected tag '\" +\n              tag +\n              \"' for \" +\n              wvalue.value +\n              \" not in \" +\n              this.options.knownTags,\n          );\n        }\n      }\n      const receiver = this.receivers[tag];\n      if (receiver) {\n        result.add(\n          receiver.receive({\n            value: (wvalue.value as object)[tag],\n            windows: wvalue.windows,\n            timestamp: wvalue.timestamp,\n            pane: wvalue.pane,\n          }),","sourceCodeStart":819,"sourceCodeEnd":855,"githubUrl":"https://github.com/apache/beam/blob/12126d8942aaf848030c478b4c6a28c6af861c66/sdks/typescript/src/apache_beam/worker/operators.ts#L819-L855","documentation":"SplittingDoFnOperator encountered an output tag on an element that is not in options.knownTags, and unknownTagBehavior is neither 'rename' nor 'ignore'. The tag and the element's own keys are the faulty inputs: the DoFn emitted to an output the operator was not configured to recognize.","triggerScenarios":"Thrown at sdks/typescript/src/apache_beam/worker/operators.ts:837 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add the tag shown in the message to the operator's knownTags list.","Set unknownTagBehavior to 'rename' (routes to unknownTagName) or 'ignore' so stray tags don't crash the bundle.","Fix the splitting DoFn to emit only to declared output tags."],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"12126d8942aaf848030c478b4c6a28c6af861c66","analyzedAt":"2026-09-13T01:50:10.254Z","contentChangedAt":"2026-09-13T01:50:10.254Z","schemaVersion":2},"datasetVersion":"2026-09-20T03:17:13.778Z"}