Function get_chrome_path

tests/integration/lighthouse_utils.py:809–857

Resolve the Chromium executable used by Lighthouse. Returns: The path to the Chromium executable Lighthouse should launch.

()

def get_chrome_path() -> str:
    """Resolve the Chromium executable used by Lighthouse.

    Returns:
        The path to the Chromium executable Lighthouse should launch.
    """
    if chrome_path := os.environ.get(LIGHTHOUSE_CHROME_PATH_ENV_VAR):
        resolved_path = Path(chrome_path).expanduser()
        if not resolved_path.exists():
            pytest.skip(
                f"{LIGHTHOUSE_CHROME_PATH_ENV_VAR} points to a missing binary: {resolved_path}"
            )
        return str(resolved_path)

    sync_api = pytest.importorskip(
        "playwright.sync_api",
        reason="Playwright is required to locate a Chromium binary for Lighthouse.",
    )
    candidates: list[Path] = []
    with sync_api.sync_playwright() as playwright:
        candidates.append(Path(playwright.chromium.executable_path))

    browser_cache_dirs = [
        Path.home() / ".cache" / "ms-playwright",
        Path.home() / "Library" / "Caches" / "ms-playwright",
    ]
    if local_app_data := os.environ.get("LOCALAPPDATA"):
        browser_cache_dirs.append(Path(local_app_data) / "ms-playwright")

    browser_glob_patterns = [
        "chromium_headless_shell-*/*/chrome-headless-shell",
        "chromium-*/*/chrome",
        "chromium-*/*/chrome.exe",
        "chromium-*/*/Chromium.app/Contents/MacOS/Chromium",
    ]
    for cache_dir in browser_cache_dirs:
        if not cache_dir.exists():
            continue
        for pattern in browser_glob_patterns:
            candidates.extend(sorted(cache_dir.glob(pattern), reverse=True))

    for resolved_path in candidates:
        if resolved_path.exists():
            return str(resolved_path)

    pytest.skip(
        "Playwright Chromium is not installed. "
        "Run `uv run playwright install chromium --only-shell` first."
    )


def get_category_failure_details(report: dict[str, Any], category_name: str) -> str: