Function run_lighthouse

tests/integration/lighthouse_utils.py:892–935

Run Lighthouse against a URL and return the parsed JSON report. Args: url: The URL to audit. report_path: Where to save the JSON report. Returns: The parsed Lighthouse JSON report.

(url: str, report_path: Path)

def run_lighthouse(url: str, report_path: Path) -> dict[str, Any]:
    """Run Lighthouse against a URL and return the parsed JSON report.

    Args:
        url: The URL to audit.
        report_path: Where to save the JSON report.

    Returns:
        The parsed Lighthouse JSON report.
    """
    command = [
        *_prepare_lighthouse_command(tuple(get_lighthouse_command())),
        url,
        "--output=json",
        f"--output-path={report_path}",
        f"--chrome-path={get_chrome_path()}",
        f"--only-categories={','.join(LIGHTHOUSE_CATEGORIES)}",
        "--quiet",
        "--chrome-flags=--headless=new --no-sandbox --disable-dev-shm-usage",
    ]

    try:
        subprocess.run(
            command,
            check=True,
            capture_output=True,
            text=True,
            timeout=LIGHTHOUSE_RUN_TIMEOUT_SECONDS,
        )
    except subprocess.CalledProcessError as err:
        pytest.fail(
            "Lighthouse execution failed.\n"
            f"Command: {' '.join(command)}\n"
            f"stdout:\n{_format_subprocess_output(err.stdout)}\n"
            f"stderr:\n{_format_subprocess_output(err.stderr)}"
        )
    except subprocess.TimeoutExpired as err:
        pytest.fail(
            f"Lighthouse execution timed out after {err.timeout}s.\n"
            f"Command: {' '.join(command)}\n"
            f"stdout:\n{_format_subprocess_output(err.stdout)}\n"
            f"stderr:\n{_format_subprocess_output(err.stderr)}"
        )
    return json.loads(report_path.read_text())


def _ensure_lighthouse_app(