← Tutti gli articoli

API e helper

Scorciatoie da tastiera globali Ctrl+Shift+L/S/K/H — workflow keyboard-first per la Output Console

15 maggio 2026 · di JustZix Team

Un power user non vuole cliccare. Un power user vuole Ctrl+Shift+qualcosa e vedere un effetto. Da v2.13.75 JustZix ha aggiunto 4 scorciatoie globali per la Output Console — tutte vivono in un listener in capture-phase su document, quindi funzionano anche quando il focus è in una textarea dell'app, quando la pagina ha una modalità vim, o quando sei bloccato su un popup modale. L'unica condizione: almeno un pane Output Console vive sulla pagina.

Quattro scorciatoie — cosa fanno

Tutte le scorciatoie fanno broadcast verso ogni Output Console renderizzata — se hai 3 pane OC in una scheda (es. uno filtrato su «fetch», un secondo su «GTM», un terzo grezzo), Ctrl+Shift+L svuota tutti e tre.

Perché Ctrl+Shift, non solo Ctrl?

In precedenza (v2.13.69-74) la Output Console aveva Ctrl+L come clear. Problema: Ctrl+L in alcuni browser mette il focus sulla barra degli indirizzi se il focus è fuori da una textarea. Nessuna risoluzione di conflitto pulita — il listener del content script non sempre blocca la scorciatoia nativa del browser.

Ctrl+Shift+L non ha collisioni con le scorciatoie native. Bonus: stesso schema delle altre (Ctrl+Shift+S/K/H) — più facile da ricordare («iniziano tutte con Ctrl+Shift»).

Listener in capture-phase — perché funziona ovunque

Immagina un tipico flusso keydown su una pagina:

document (capture) ↓
  body (capture) ↓
    div.container (capture) ↓
      textarea#commentBox (target) ← l'utente digita qui
    div.container (bubble) ↑
  body (bubble) ↑
document (bubble) ↑

JustZix aggancia un listener su document in capture-phase — primo nella catena, prima di qualsiasi handler della pagina. A un match (Ctrl+Shift+L/S/K/H), JustZix chiama e.preventDefault() + e.stopPropagation() e la pagina non vede mai l'evento. Funziona anche quando il focus è in una textarea — dove Ctrl+L normalmente farebbe «seleziona tutto il testo».

Caso d'uso 1 — Workflow QA keyboard-first

Stai testando ciclicamente 5 flussi in un'app. Ogni flusso:

1. Esegui un'azione (clic nell'app)
2. Controlla la Output Console — il log sembra OK
3. Svuota il log prima del flusso successivo

Senza scorciatoie: passo 3 = clic destro sull'header della Output Console → «Svuota il log». Con una scorciatoia: Ctrl+Shift+L. 5× più veloce, le mani restano sulla tastiera, il focus resta sull'app testata.

Bonus: se un flusso logga centinaia di righe, dopo averlo usato potresti volere solo i tuoi JZ.log: Ctrl+Shift+K due volte → modalità [J] → solo i tuoi log visibili. Un altro Ctrl+Shift+K → [C] (solo la pagina). Un terzo → [C+J] (tutto).

Caso d'uso 2 — Scoperta dell'API tramite Ctrl+Shift+H

Un nuovo utente di JustZix. Sa che c'è JUSTZIX.log(), ma non ricorda cos'altro. Invece di aprire la documentazione:

Ctrl+Shift+H → un overlay con un popup:

• API JZ: lista dei metodi delle azioni (JZ.click, JZ.value, JZ.setValue, JZ.action)
• Alias: window.JUSTZIX (primario), window.__JUSTZIX__ (sempre), window.JZ (quando libero)
• Cattura della console: quali eventi vengono catturati (console.log/warn/error/info/debug + JZ.log)
• Scorciatoie: Ctrl+Shift+L/S/K/H con descrizioni

Esc / clic fuori / di nuovo Ctrl+Shift+H lo chiudono. Da v2.13.80 il popup è trascinabile per l'header — puoi spostarlo di lato per vedere qualcosa sotto, vincolato al viewport così non vola fuori schermo.

Caso d'uso 3 — Ricerca senza toccare il mouse

La Output Console mostra 800 righe. Cerchi «purchase». Modalità uno: scrollare e Ctrl+F (ricerca del browser) — funziona, ma Ctrl+F trova anche testo in altri elementi della pagina.

Modalità due: Ctrl+Shift+S → il campo di ricerca si apre sopra il log, focus lì, digiti «purchase» → il filtro dal vivo mostra solo le righe corrispondenti. Esc svuota la ricerca. Un altro Ctrl+Shift+S chiude il campo di ricerca.

Bonus: la ricerca è persistente per scheda in sessionStorage. F5 → la ricerca torna con il vecchio filtro.

Caso d'uso 4 — Power user multi-monitor

Monitor 1: l'app sotto test. Monitor 2: la stessa scheda in un'altra finestra (Chrome «Sposta in un'altra finestra» + trascina). La prima scheda attiva un flusso, la seconda scheda mostra la Output Console a schermo intero. Ctrl+Shift+L con il focus sul monitor 2 → svuota entrambe le schede? No — la scorciatoia agisce per scheda, quindi solo la scheda su cui hai lasciato il focus.

Per la sincronizzazione tra schede → usa una regola JS + JUSTZIX.log in entrambe, con un timestamp per filtrare.

Trappole

• Le scorciatoie richiedono ≥1 Output Console renderizzata. Senza una OC sulla pagina il listener non si aggancia nemmeno. Se la regola JustZix non corrisponde al dominio attuale → nessuna OC → nessuna scorciatoia. È voluto — il listener si aggancia solo quando serve.
• Alcuni browser sovrascrivono Ctrl+Shift+lettera per le proprie scorciatoie (es. Ctrl+Shift+T = ripristina scheda chiusa). JustZix fa preventDefault, ma alcune scorciatoie del browser girano in codice nativo e battono il nostro listener in capture. Se noti un conflitto — cambia la scorciatoia nell'estensione (previsto; per ora hardcoded).
• Popup di aiuto z-index 2147483646. Uno sotto il max int32 (2147483647). Le maniglie di drag degli altri pane hanno z-index 2147483645, così il popup è sempre sopra. Alcune pagine usano anch'esse il max int — JustZix vince comunque di uno sui modali della pagina.
• Il ciclo del viewMode non salta stati anche se [J] sarebbe vuoto. v2.13.78 percorre sempre [C+J] → [C] → [J] → [C+J], anche se [J] sarebbe vuoto. Voluto — mostra che la modalità è attiva anche quando non ci sono log.
• Le scorciatoie NON si fermano quando il focus è nella JS Console / nel JS pane. Lì l'utente digita codice — Ctrl+Shift+L potrebbe disturbare. Il listener fa comunque preventDefault, quindi la scorciatoia funziona senza cancellare testo. Best practice: se stai digitando attivamente in un pane, usa il mouse per Clear / commutazione della modalità.

Cosa fare dopo

Le scorciatoie globali sono uno «strato da power user» sopra la Output Console — alla maggior parte degli utenti basta cliccare i pulsanti nell'header del pane. Ma se una toolbar QA è il tuo strumento quotidiano, queste 4 scorciatoie ti faranno risparmiare decine di minuti a settimana.

Vedi anche gli articoli correlati:

• Output Console deep-dive — API completa del pannello
• window.JUSTZIX + JZ helpers — l'API programmatica che le scorciatoie mostrano nel popup di aiuto
• Mini-IDE nella scheda — mappa completa di tutte le finestre

Installa JustZix — completamente gratuito, senza account, senza server.