{"record":{"id":"8bd898c3bb5a0d47","repo":"microsoft/playwright","slug":"name-engine-expects-a-selector-list-and-optio","errorCode":null,"errorMessage":"\"${name}\" engine expects a selector list and optional maximum distance in pixels","messagePattern":"\"(.+?)\" engine expects a selector list and optional maximum distance in pixels","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/injected/src/selectorEvaluator.ts","lineNumber":514,"sourceCode":"const hasTextEngine: 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(`\"has-text\" engine expects a single string`);\n    if (shouldSkipForTextMatching(element))\n      return false;\n    const text = normalizeWhiteSpace(args[0]).toLowerCase();\n    const matcher = (elementText: ElementText) => elementText.normalized.toLowerCase().includes(text);\n    return matcher(elementText((evaluator as SelectorEvaluatorImpl)._cacheText, element));\n  },\n};\n\nfunction createLayoutEngine(name: LayoutSelectorName): SelectorEngine {\n  return {\n    matches(element: Element, args: (string | number | Selector)[], context: QueryContext, evaluator: SelectorEvaluator): boolean {\n      const maxDistance = args.length && typeof args[args.length - 1] === 'number' ? args[args.length - 1] : undefined;\n      const queryArgs = maxDistance === undefined ? args : args.slice(0, args.length - 1);\n      if (args.length < 1 + (maxDistance === undefined ? 0 : 1))\n        throw new Error(`\"${name}\" engine expects a selector list and optional maximum distance in pixels`);\n      const inner = evaluator.query(context, queryArgs);\n      const score = layoutSelectorScore(name, element, inner, maxDistance);\n      if (score === undefined)\n        return false;\n      (evaluator as SelectorEvaluatorImpl)._markScore(element, score);\n      return true;\n    }\n  };\n}\n\nconst nthMatchEngine: SelectorEngine = {\n  query(context: QueryContext, args: (string | number | Selector)[], evaluator: SelectorEvaluator): Element[] {\n    let index = args[args.length - 1];\n    if (args.length < 2)\n      throw new Error(`\"nth-match\" engine expects non-empty selector list and an index argument`);\n    if (typeof index !== 'number' || index < 1)\n      throw new Error(`\"nth-match\" engine expects a one-based index as the last argument`);\n    const elements = isEngine.query!(context, args.slice(0, args.length - 1), evaluator);","sourceCodeStart":496,"sourceCodeEnd":532,"githubUrl":"https://github.com/microsoft/playwright/blob/c8fc3bf8d31542d59b4d4d9eaab1df93ff541dc6/packages/injected/src/selectorEvaluator.ts#L496-L532","documentation":"Error \"\"${name}\" engine expects a selector list and optional maximum distance in pixels\" thrown in microsoft/playwright.","triggerScenarios":"Thrown at packages/injected/src/selectorEvaluator.ts:514 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"}