Wie JoyCheck deinen Controller ausliest

JoyCheck ist ein browserbasierter Controller-Tester, der deinen Controller über die W3C Gamepad API ausliest, ohne Installation und ohne dass etwas an einen Server gesendet wird.

6 Eingabearten · 4 Abschnitte · 10 Min. Lesezeit

JoyCheck liest deinen Controller mit der W3C Gamepad API[1], einer browser-nativen Schnittstelle, die jede Taste, jede Analogachse und jeden Trigger als numerische Werte ausgibt, 60 Mal pro Sekunde aktualisiert. Der Browser übernimmt den USB- oder Bluetooth-Handshake; JoyCheck fragt navigator.getGamepads() bei jedem Animationsframe ab und rendert den Live-Zustand, ohne Daten an einen Server zu senden.

Aktualisiert am 2026-05-27 von Taimoor Bamazai, Gründer der Elites Algorithm Limited (ein eingetragenes Technologieunternehmen in Dublin, Irland) und der Entwickler hinter JoyCheck.

Der Live-Datenfluss hat drei Eigenschaften, die es zu benennen lohnt:

• Browser-nativ. Standard-W3C-Gamepad-API. Kein natives Binary, keine Treiberinstallation. Funktioniert in jedem modernen Chromium-Browser, in Firefox und in Safari 16+.
• 60 bis 144 Hz Abtastung. JoyCheck liest navigator.getGamepads() bei jedem Animationsframe, im selben Takt, in dem der Browser neu zeichnet, passend zu deiner Display-Hz.
• Keine Datenübertragung. Jede Eingabe wird in deinem Browser-Prozess verarbeitet. Kein XHR, kein fetch, keine Analytics im Widget. In den DevTools überprüfbar.

Was bedeutet es, einen Controller “auszulesen”?

JoyCheck liest sechs Klassen von Eingaben von deinem Controller, und jede lässt sich einem bestimmten Feld der Gamepad API zuordnen.

• Tasten (gamepad.buttons[]). Jede Taste ist ein GamepadButton-Objekt, das ihren Druckzustand und, wo unterstützt, einen Analogwert meldet.
• Analog-Sticks (gamepad.axes[0..3]). Das axes-Array ist ein flaches Float-Array. Unter dem W3C-Standardmapping enthält es die X/Y-Positionen des linken und rechten Sticks.
• Trigger (gamepad.buttons[6,7].value). Trigger liegen im buttons-Array und werden unter dem Standardmapping als Tasten mit einem Analogwert behandelt.
• Touchpad (gamepad.touchEvents[]). DualShock 4 und DualSense geben Touchpad-Koordinaten als Erweiterung der Gamepad API aus. Die gemeldete Auflösung des Touchpads liegt bei etwa 1920×1080, und bis zu zwei gleichzeitige Berührungspunkte werden erfasst.
• Gyro und IMU (gamepad.imu, vorgeschlagen). DualSense, Joy-Con und Switch Pro geben alle Sechs-Achsen-IMU-Daten aus.
• Vibration (gamepad.vibrationActuator.playEffect()). Die vibrationActuator-Schnittstelle eines Gamepad-Objekts stellt eine playEffect()-Methode bereit, die für jeden Motor eine Dauer und Intensität entgegennimmt, bei den Standard-Controllern, die haptische Aktoren melden.

Wie funktioniert die W3C Gamepad API eigentlich?

Die Gamepad API ist eine W3C-Standard-Browserschnittstelle, die verbundene Spielecontroller für JavaScript zugänglich macht. Sie steckt seit Chrome 21 (2012), Firefox 29 (2014), Edge 12 (2015) und Safari 14.1 (2021) in jedem modernen Browser, siehe Can I Use für die aktuelle Support-Matrix.[2]

Der Browser übernimmt den zugrunde liegenden USB- oder Bluetooth-HID-Handshake. Dein Betriebssystem koppelt den Controller; der Browser sieht ihn über OS-Treiberschichten (XInput unter Windows, IOHIDDevice unter macOS, evdev unter Linux); die Seite ruft navigator.getGamepads() auf und erhält ein Snapshot-Array von Gamepad-Objekten.

Jedes Gamepad-Objekt stellt eine Reihe von Feldern bereit:

• id: ein String-Bezeichner (z. B. “DualSense Wireless Controller (STANDARD GAMEPAD Vendor: 054c Product: 0ce6)”)
• axes[]: ein Float-Array mit den Positionen der Analogachsen (Sticks, typischerweise vier Einträge: links X/Y + rechts X/Y)
• buttons[]: ein Array aus GamepadButton-Objekten, jedes mit den Eigenschaften pressed, value und touched
• timestamp: Zeitpunkt der letzten Aktualisierung in Millisekunden
• mapping: “standard”, wenn der Controller dem W3C-Standard-Gamepad-Layout entspricht; sonst ""
• vibrationActuator: eine Schnittstelle für haptisches Feedback (wo unterstützt)

Die API verlangt eine Nutzeraktion (Tastendruck), bevor sie verbundene Controller freigibt. Das ist die Gestenanforderung: ein Datenschutzmerkmal, das verhindert, dass Seiten deinen Controller im Hintergrund per Fingerprinting erfassen. JoyCheck zeigt “Drücke eine beliebige Taste zum Starten”, bis die Geste ausgelöst wird.

Warum JoyCheck abfragt statt Events zu abonnieren

Die Gamepad API ist im Standard reine Abfrage (poll-only). Es gibt kein onbuttonpress-Event, das du abonnieren könntest: Dein Code fragt navigator.getGamepads() ab und bekommt einen Snapshot des aktuellen Zustands. JoyCheck fragt über requestAnimationFrame ab[5], das den Callback mit der Bildwiederholrate des Displays auslöst (typischerweise 60 Hz, bis zu 240 Hz an Displays mit hoher Bildwiederholrate).

Das Abfragen im Takt der Bildwiederholrate ist aus diesen Gründen der richtige Takt:

• Das OS aktualisiert den Controller-Zustand etwa in diesem Takt (USB-HID tastet mit 1 kHz ab; der Browser sampelt herunter)
• Das Rendern passiert mit der Bildwiederholrate, sodass zusätzliche Abfragen doppelte Frames ohne sichtbaren Unterschied erzeugen würden
• Es hält die CPU-Last minimal, der Abfrage-Callback ist ein Funktionsaufruf pro Frame

Schnelleres Abfragen (per setInterval oder setTimeout) verschwendet CPU und erzeugt doppelte Snapshots. Langsameres Abfragen (z. B. 30 Hz) verpasst schnelle Tastendrücke an Displays mit hoher Bildwiederholrate. requestAnimationFrame passt zum Display, das wiederum zu dem passt, was du tatsächlich siehst.

Warum ist JoyCheck ohne Datenübertragung und wie kann ich das überprüfen?

Wir sagen es dreimal, weil es wichtig ist:

1. JoyCheck überträgt niemals Controller-Daten an irgendeinen Server.

2. Die Gamepad API läuft vollständig in deinem Browser-Prozess. Der Controller-Zustand verlässt die Seite nie.

3. Sieh dir den Quelltext des Widgets an: Jeder API-Aufruf löst sich in einen requestAnimationFrame-Callback auf, der ausschließlich DOM-Knoten aktualisiert. Es gibt keine fetch()-Aufrufe, kein XMLHttpRequest, keine WebSocket-Zugriffe, die Controller-Daten transportieren.

Du kannst das in unter einer Minute selbst überprüfen: Öffne JoyCheck in einem beliebigen Browser, öffne die DevTools (F12), klicke auf den Tab Netzwerk, leere das Protokoll und bediene das Widget 30 Sekunden lang. Der Netzwerk-Tab bleibt bei Controller-Zustand-Anfragen leer. Vollständige Erklärung auf der Datenschutzseite.

Warum einen Browser-Tester statt einer Desktop-App?

Drei Gründe:

Keine Installationshürde. Die Gamepad API ist inzwischen zuverlässig genug, dass es eine unnötige Belastung wäre, Nutzer zum Herunterladen und Ausführen eines Binaries zu bewegen. Ein Seitenaufruf ist schneller als ein Installer; ein Browser ist universeller als eine Windows-only-.exe-Verteilung.

Plattformübergreifend gratis. Dieselbe Seite läuft unter Windows, macOS, Linux und ChromeOS, ohne Builds pro Plattform. Ein Browser-Tester wird einmal ausgeliefert.

In 30 Sekunden prüfbar. Netzwerkaktivität und Speicher einer Webseite lassen sich von jedem Nutzer jederzeit mit den Browser-DevTools inspizieren. Für die Netzwerkaktivität einer Desktop-App braucht es tcpdump, Wireshark oder lsof und Root-Rechte. Die Prüfbarkeit zählt.

“Über Jahre der Hardware-Diagnosearbeit an PC-Peripherie und Spielecontrollern haben browserbasierte Tester rund zwei Drittel der Fehler gefunden, die ein Desktop-Diagnosetool nie sichtbar gemacht hätte. Der Browser liest, was der Controller physisch meldet, und das ist eine andere Ebene der Wahrheit als das, was irgendein installer-basierter Treiber offenlegt.”

Taimoor Bamazai, Gründer, Elites Algorithm Limited

Was sind die bekannten Grenzen von JoyCheck?

Ehrliche Liste, was JoyCheck nicht tut:

• Kein direkter HID-Zugriff. Das Auslesen des rohen USB-HID-Deskriptors würde WebHID erfordern, eine separate W3C-Spezifikation mit weniger einheitlicher Browser-Unterstützung (heute nur Chrome und Edge).

• Controller aus der Zeit vor der Gamepad API. DirectInput-only-Controller aus der Zeit vor XInput erscheinen im Browser nicht. Sie bräuchten WebHID plus eine Übersetzungsschicht.

• Vibrationsunterstützung variiert je nach Browser. Firefox hinkt Chrome beim vibrationActuator hinterher; Safari hat nur begrenzte Unterstützung. JoyCheck weist auf die Einschränkung sauber hin.

• Trigger-Druck bei Xbox-Controllern hängt von der Treiberschicht ab. Manche Bluetooth-Kopplungen melden binäre Trigger (nur an/aus, kein Analogbereich). Eine kabelgebundene USB-Verbindung behebt das meist.

Für plattformspezifische Diagnosewege jenseits dessen, was der Browser sehen kann, deckt die dedizierte Anleitung Fehlermuster ab, die einen Eingriff auf der Hardware-Seite erfordern.

Für controllerspezifische Diagnose-Anleitungen, die dieselbe browserbasierte Ausleseschicht nutzen, decken der Kopplungsleitfaden für den Switch Pro Controller, die DualSense-Kalibrierungsanleitung und der Kalibrierungsleitfaden für den PS4-Controller plattformspezifische Kopplungseigenheiten ab, die die Gamepad API allein nicht lösen kann. Speziell für DualShock-Nutzer zeigt die DualShock-Kalibrierungs-GUI das Prüfen von Mittellage, Totzone und Triggern im Browser.

Beobachtungen zur Abtastrate von JoyCheck (gemessen 2026-05)

Browser deckeln das Gamepad-API-Auslesen auf den requestAnimationFrame-Takt. In unserer Analyse haben wir dieselben Controller unter identischen Display-Bedingungen gemessen. Alle Messwerte: frische Chrome-120-Sitzung, USB-Verbindung sofern nicht anders angegeben, gleitendes 5-Sekunden-Fenster.

Gemessen mit dem In-Browser-Sampler von JoyCheck. 144-Hz-Displays heben die Deckelung proportional an; die Messwerte sind zum Vergleich zwischen Browsern auf eine 60-Hz-Basislinie normalisiert.