Zum Hauptinhalt springen

Listener

Netzwerkinterceptions-Streams abonnieren, aktive Listener verwalten und deabonnieren.

otto listener subscribe-network

Abonniert einen Netzwerkinterceptions-Listener auf einem verwalteten Tab und streamt abgefangene HTTP-Antworten.

Verwendung

otto listener subscribe-network [Optionen]

Flags

FlagKurzformErforderlichTypStandardErlaubte WerteBeschreibung
--tab-sessionJastringTab-Session-ID, an die der Listener angehängt werden soll
--site-sJastringSite-Bereich (z. B. reddit.com) — wird gegen Tab-URL validiert
--patternNeinstring[]URL-Glob-Muster zum Abfangen (wiederholbar)
--request-hostNeinstring[]Explizite Cross-Host-Allowlist (wiederholbar)
--modeNeinstringnetworknetwork, fetch, hybridInterceptions-Aufnahmemodus
--include-bodyNeinbooleantrueAntwort-Body in Updates einschließen
--include-headersNeinbooleanfalseAntwort-Header einschließen (sensible Header werden redigiert)
--max-body-bytesNeinnumber256000Maximale Bytes des Antwort-Bodys zum Erfassen
--mime-typesNeinstring[]MIME-Präfix-Allowlist (wiederholbar)
--node-idNeinstringAutomatisch ausgewähltZiel-Node-ID
--jsonNeinbooleanfalseStream-Updates als NDJSON ausgeben

Beispiele

# Grundlegendes Netzwerk-Abonnement für Reddit-API-Verkehr
otto listener subscribe-network \
--tab-session <tabSessionId> \
--site reddit.com \
--pattern 'https://www.reddit.com/api/*'

# Hochvolumen-Aufnahme mit Body-Limit
otto listener subscribe-network \
--tab-session <tabSessionId> \
--site reddit.com \
--request-host matrix.redditspace.com \
--pattern 'https://matrix.redditspace.com/_matrix/client/v3/*' \
--mode network \
--max-body-bytes 200000

# Hybride Aufnahme mit Headern und JSON-Ausgabe
otto listener subscribe-network \
--tab-session <tabSessionId> \
--site reddit.com \
--mode hybrid \
--include-headers \
--json

Stream-Ausgabe

Jede abgefangene Antwort wird als listener_update-Frame ausgegeben. Der Stream läuft bis:

  • otto listener unsubscribe mit der subscribe-requestId aufgerufen wird
  • Die Tab-Session geschlossen wird
  • Ctrl+C gedrückt wird (sendet automatisch unsubscribe)

Die subscribe-requestId wird beim Start ausgegeben — speichern Sie sie, um später von einem anderen Terminal aus zu deabonnieren.

Beendigungscodes

CodeBedeutung
0Abonniert und streamend
1Abonnement fehlgeschlagen (ungültige Tab-Session, Site-Mismatch usw.)

otto listener unsubscribe

Deabonniert einen aktiven Netzwerk-Listener anhand seiner subscribe-requestId.

Verwendung

otto listener unsubscribe [Optionen]

Flags

FlagKurzformErforderlichTypStandardBeschreibung
--target-request-idJastringDie von subscribe-network zurückgegebene requestId
--node-idNeinstringAutomatisch ausgewähltZiel-Node-ID

Beispiele

otto listener unsubscribe --target-request-id <subscribeRequestId>

Beendigungscodes

CodeBedeutung
0Erfolgreich deabonniert
1Listener nicht gefunden oder Relay-Fehler

otto listener list

Listet aktive Netzwerk-Listener auf dem verbundenen Node auf.

Verwendung

otto listener list [Optionen]

Flags

FlagKurzformErforderlichTypStandardBeschreibung
--node-idNeinstringAutomatisch ausgewähltZiel-Node-ID
--jsonNeinbooleanfalseAls JSON ausgeben

Beispiele

otto listener list

otto listener list --json

Beendigungscodes

CodeBedeutung
0Listener aufgelistet
1Relay- oder Node-Fehler

Verwandte Befehle