SSE Tester

2 min di lettura

SSE Tester

L’SSE Tester è uno strumento per browser a file singolo situato in tools/test-sse. Permette di iscriversi a un numero qualsiasi di canali PostgreSQL NOTIFY tramite una connessione Server-Sent Events in tempo reale e di osservare gli eventi in arrivo.

Funzionalità

  • Più canali — aggiungi o rimuovi canali come tag prima di connetterti. Tutti i canali vengono passati come parametro ?channels= separato da virgole.
  • Tutti i metodi di autenticazione — la scheda Password usa HTTP Basic Auth (credenziali dirette, senza bisogno di JWT); la scheda Bearer Token accetta un JWT o un token API.
  • Stream in tempo reale — utilizza la Fetch Streams API con AbortController per una disconnessione pulita. Le righe SSE vengono analizzate manualmente, in modo che i campi event:, data: e heartbeat (:) siano gestiti tutti correttamente.
  • Evidenziazione sintassi JSON — i payload JSON vengono visualizzati con colori.
  • Impostazioni persistenti — URL, prefisso, database, nome utente e lista canali vengono salvati in localStorage.

Autenticazione

Lo strumento verifica le credenziali prima di mostrare il pannello di iscrizione. Facendo clic su Verify & Continue si chiama capabilities con l’header scelto — se PgArachne restituisce una risposta positiva, il pannello di iscrizione si sblocca.

  • Scheda Password — invia Authorization: Basic <base64(utente:password)>. L’utente del database deve avere GRANT EXECUTE sulle funzioni target e accesso all’endpoint SSE; non è richiesto alcun GRANT <ruolo> TO pgarachne.
  • Scheda Bearer Token — invia Authorization: Bearer <token>. Incolla un JWT (ottenuto tramite il JWT Getter) o un token API longevo.
Come abilitarlo: Imposta STATIC_FILES_PATH su tools/test-sse e visita http://localhost:8080. In alternativa, apri index.html direttamente nel browser.