Function checkFile

scripts/check-core-portability.mjs:140–185

* Check a single file for forbidden patterns * @param {string} filePath * @returns {Violation[]}

(filePath)

 * @returns {Violation[]}
 */
function checkFile(filePath) {
  /** @type {Violation[]} */
  const violations = [];

  let content;
  try {
    content = readFileSync(filePath, "utf-8");
  } catch {
    return violations;
  }

  const lines = content.split("\n");
  let inBlockComment = false;

  for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
    const line = lines[lineIdx];
    if (line === undefined) continue;

    // Strip comments from line before checking
    const result = stripComments(line, inBlockComment);
    const codeLine = result.cleanedLine;
    inBlockComment = result.inBlockComment;

    // Skip if line is empty after stripping comments
    if (codeLine.trim() === "") continue;

    for (const { pattern, name } of FORBIDDEN_PATTERNS) {
      // Reset the regex lastIndex for global patterns
      pattern.lastIndex = 0;

      for (;;) {
        const match = pattern.exec(codeLine);
        if (match === null) break;
        violations.push({
          file: filePath,
          line: lineIdx + 1,
          col: match.index + 1,
          pattern: name,
          match: match[0],
        });
      }
    }
  }

  return violations;
}

/**
 * Main entry point