{"record":{"id":"0513e76c94d0d83e","repo":"microsoft/playwright","slug":"text-engine-expects-a-single-string","errorCode":null,"errorMessage":"\"text\" engine expects a single string","messagePattern":"\"text\" engine expects a single string","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/injected/src/selectorEvaluator.ts","lineNumber":465,"sourceCode":"  },\n\n  matches(element: Element, args: (string | number | Selector)[], context: QueryContext, evaluator: SelectorEvaluator): boolean {\n    return evaluator.matches(element, args, { ...context, pierceShadow: false });\n  }\n};\n\nconst visibleEngine: SelectorEngine = {\n  matches(element: Element, args: (string | number | Selector)[], context: QueryContext, evaluator: SelectorEvaluator): boolean {\n    if (args.length)\n      throw new Error(`\"visible\" engine expects no arguments`);\n    return isElementVisible(element);\n  }\n};\n\nconst textEngine: SelectorEngine = {\n  matches(element: Element, args: (string | number | Selector)[], context: QueryContext, evaluator: SelectorEvaluator): boolean {\n    if (args.length !== 1 || typeof args[0] !== 'string')\n      throw new Error(`\"text\" engine expects a single string`);\n    const text = normalizeWhiteSpace(args[0]).toLowerCase();\n    const matcher = (elementText: ElementText) => elementText.normalized.toLowerCase().includes(text);\n    return elementMatchesText((evaluator as SelectorEvaluatorImpl)._cacheText, element, matcher) === 'self';\n  },\n};\n\nconst textIsEngine: SelectorEngine = {\n  matches(element: Element, args: (string | number | Selector)[], context: QueryContext, evaluator: SelectorEvaluator): boolean {\n    if (args.length !== 1 || typeof args[0] !== 'string')\n      throw new Error(`\"text-is\" engine expects a single string`);\n    const text = normalizeWhiteSpace(args[0]);\n    const matcher = (elementText: ElementText) => {\n      if (!text && !elementText.immediate.length)\n        return true;\n      return elementText.immediate.some(s => normalizeWhiteSpace(s) === text);\n    };\n    return elementMatchesText((evaluator as SelectorEvaluatorImpl)._cacheText, element, matcher) !== 'none';\n  },","sourceCodeStart":447,"sourceCodeEnd":483,"githubUrl":"https://github.com/microsoft/playwright/blob/c8fc3bf8d31542d59b4d4d9eaab1df93ff541dc6/packages/injected/src/selectorEvaluator.ts#L447-L483","documentation":"Error \"\"text\" engine expects a single string\" thrown in microsoft/playwright.","triggerScenarios":"Thrown at packages/injected/src/selectorEvaluator.ts:465 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c8fc3bf8d31542d59b4d4d9eaab1df93ff541dc6","analyzedAt":"2026-08-12T07:26:36.950Z","schemaVersion":2},"datasetVersion":"2026-08-12T13:17:24.610Z"}