console-error-scanner
Features CLI Verantwortung Installation GitHub
Open Source TUI Tool · v1.13.0

Console Error
Scanner

Scannt Websites automatisch auf JavaScript Console-Errors, HTTP-Fehler und CSP-Violations — mit Live-Ergebnissen, Top-10-Analyse und Scan-History direkt im Terminal.

GitHub Repository Installation
Ein Scan erzeugt Last. Jede Seite wird in einem echten Browser geprüft und läuft damit an den Zwischenspeichern des Servers vorbei - eine Seite wiegt ein Vielfaches eines einfachen Abrufs. Der Scanner ist deshalb von Haus aus auf 60 Seiten pro Minute gedrosselt. Setze ihn nur gegen Systeme ein, für die Du eine Berechtigung hast — Einzelheiten unter Verantwortung.
Features

Was es kann

Automatisierte Fehlersuche auf Websites — ein Scan statt stundenlanger manueller Arbeit.

🗺️

Sitemap Auto-Discovery

Findet Sitemaps automatisch über robots.txt und typische Pfade — einfach Domain eingeben und loslegen. Keine Sitemap? Mit dem Sitemap Generator erstellen.

🔍

Console Errors & Warnings

Erfasst JavaScript console.error(), console.warn() und CSP-Violations auf jeder gescannten Seite.

🔗

Tote Links & HTTP-Fehler

Findet 404er, 5xx-Fehler und fehlgeschlagene Netzwerk-Requests automatisch beim Crawlen.

📊

Top 10 Fehler-Analyse

Übersicht der häufigsten Fehler mit Balkendiagramm — gruppiert nach Console Errors, Warnings, 404 und 5xx.

📜

Lazy-Loading-Erkennung

Scrollt Seiten automatisch durch, um per IntersectionObserver nachgeladene Bilder und Inhalte zu prüfen.

🍪

Cookie-Banner-Handling

3-Phasen-Consent für Usercentrics, OneTrust, CookieBot und generische Banner — automatisch oder nur verstecken.

📋

HTML & JSON Reports

Exportiert Scan-Ergebnisse als übersichtlichen HTML-Report oder maschinenlesbares JSON.

🎫

JIRA-Export

Taste j kopiert eine Tabelle der Fehler-Seiten in die Zwischenablage - direkt ins Ticket einfügbar. Markdown für Jira Cloud (Auto-Umwandlung beim Einfügen) oder Wiki Markup für Server/Data Center, wählbar in den Einstellungen.

Whitelist-Support

Bekannte, irrelevante Fehler per Wildcard-Pattern ignorieren — für saubere Ergebnisse.

🌐

Mehrsprachig

Deutsch und Englisch — alle UI-Texte, Log-Meldungen und Reports ueber JSON-Sprachdateien steuerbar (--lang en).

🎨

Themes

Anpassbare Farbthemen über textual-themes — die TUI-Oberfläche lässt sich visuell individualisieren.

Tech Stack

Gebaut mit

Die Technologien hinter dem Projekt.

Python 3
Textual
Playwright
Chromium
Rich
CLI

Parameter

Alle Optionen für die Kommandozeile.

Parameter Beschreibung Default
URL URL der Website oder Sitemap (XML)
--concurrency -c Max parallele Browser-Tabs 8
--timeout -t Timeout pro Seite (Sekunden) 60
--filter -f Nur URLs scannen die TEXT enthalten
--console-level error, warn oder all warn
--cookie Cookie setzen (NAME=VALUE, mehrfach)
--whitelist -w Pfad zur Whitelist-JSON
--output-json JSON-Report automatisch speichern
--output-html HTML-Report automatisch speichern
--lang Sprache der Oberflaeche (de, en) de
--no-consent Cookie-Consent nur verstecken, nicht akzeptieren false
--no-scroll Seite nicht scrollen (kein Lazy-Loading) false
--no-headless Browser sichtbar starten (Debugging) false
Verantwortung

Nutzung auf eigene Verantwortung

Was ein Scan auf dem Zielsystem anrichtet - und wer dafür geradesteht.

Jede Seite wird in einem echten Browser geprüft: Skripte, Schriften und Bilder werden geladen, der Aufruf läuft an den Zwischenspeichern des Servers vorbei. Eine Seite wiegt damit ein Vielfaches eines einfachen HTTP-Abrufs. Bei einer großen Sitemap kommen so schnell mehrere hundert schwere Aufrufe pro Minute zusammen - genug, um ein Produktivsystem spürbar zu verlangsamen.

Deshalb ist der Scanner voreingestellt gedrosselt: 60 Seiten pro Minute. --concurrency ist dabei kein Rate-Limit, sondern begrenzt nur, wie viele Browser-Tabs gleichzeitig laufen. Und gezählt werden die Seitenaufrufe - was der Browser pro Seite nachlädt, zählt nicht extra.

Mit der Nutzung erklären Sie:

  1. Sie setzen das Programm ausschließlich gegen Systeme ein, für die Ihnen eine ausdrückliche Berechtigung des Betreibers vorliegt.
  2. Sie tragen die alleinige Verantwortung für den Einsatz, die gewählten Einstellungen und alle daraus entstehenden Folgen.
  3. Vor einem Lauf gegen ein Produktivsystem prüfen Sie, ob die eingestellten Grenzwerte für dieses System angemessen sind.

Die Software wird unentgeltlich und ohne jede Gewährleistung bereitgestellt ("as is"), wie in Abschnitt 7 der Apache-Lizenz 2.0 beschrieben. Eine Haftung des Autors (Michael Blaess) für Schäden, die aus der Nutzung entstehen, ist ausgeschlossen, soweit dies gesetzlich zulässig ist. Unberührt bleibt die Haftung für Vorsatz und grobe Fahrlässigkeit, für Schäden aus der Verletzung des Lebens, des Körpers oder der Gesundheit sowie nach dem Produkthaftungsgesetz.

Beim ersten Start fragt das Programm diesen Hinweis ab; ohne Zustimmung startet es nicht. Die Sprache richtet sich nach Deiner Systemumgebung - Deutsch nur bei deutschsprachiger Umgebung, sonst Englisch.

Installation

Schnellstart

One-Liner Installation — kein Python, kein Git, kein Chrome nötig.

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/michaelblaess/console-error-scanner/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/michaelblaess/console-error-scanner/main/install.ps1 | iex
Windows
Linux
macOS