no-element-handle

// See https://doc.codiga.io/docs/rosie/ast/javascript/rosie-ast-javascript-functioncall/
function getFunctionName(node) {
  if (node?.astType === "member") {
    return node.name.value;
  }

  if (node?.astType === "string") {
    return node.value;
  }

  return "";
}

function visit(node, filename, code) {
  // only run inside spec files
  if (!filename.includes(".spec.") && !filename.includes(".test.")) return;

  // Check this is a function call and the function name is a simple string
  const functionName = getFunctionName(node.functionName);

  if (
    node.functionName &&
    node.functionName.astType === "member" &&
    (functionName === "$" || functionName === "$$") &&
    getFunctionName(node.functionName.parent) === "page"
  ) {
    const error = buildError(
      node.functionName.start.line,
      node.functionName.start.col,
      node.functionName.end.line,
      node.functionName.end.col,
      "Unexpected use of element handles.",
      "INFORMATIONAL",
      "BEST_PRACTICE"
    );

    const editUpdate = buildEditUpdate(
      node.functionName.name.start.line,
      node.functionName.name.start.col,
      node.functionName.name.end.line,
      node.functionName.name.end.col,
      "locator"
    );

    const fix = buildFix(
      `Replace page.${functionName} with page.locator`,
      [editUpdate]
    );

    addError(error.addFix(fix));
  }
}