← Tous les articles

API et helpers

Raccourcis clavier globaux Ctrl+Shift+L/S/K/H — workflow keyboard-first pour l'Output Console

15 mai 2026 · par JustZix Team

Un power user ne veut pas cliquer. Un power user veut Ctrl+Shift+quelque chose et voir un effet. Depuis v2.13.75, JustZix a ajouté 4 raccourcis globaux pour l'Output Console — tous vivent dans un listener en capture-phase sur document, donc ils fonctionnent même quand le focus est dans une textarea d'app, quand la page a un mode vim, ou quand vous êtes bloqué sur un popup modal. La seule condition : au moins un pane Output Console vit sur la page.

Quatre raccourcis — ce qu'ils font

Tous les raccourcis diffusent vers chaque Output Console rendue — si vous avez 3 panes OC dans un onglet (p. ex. un filtré sur « fetch », un deuxième sur « GTM », un troisième brut), Ctrl+Shift+L vide les trois.

Pourquoi Ctrl+Shift, et pas seulement Ctrl ?

Auparavant (v2.13.69-74), l'Output Console avait Ctrl+L comme clear. Problème : Ctrl+L dans certains navigateurs focalise la barre d'adresse si le focus est en dehors d'une textarea. Pas de résolution de conflit propre — le listener du content script ne bloque pas toujours le raccourci natif du navigateur.

Ctrl+Shift+L n'a aucune collision avec les raccourcis natifs. Bonus : même motif que les autres (Ctrl+Shift+S/K/H) — plus facile à retenir (« ils commencent tous par Ctrl+Shift »).

Listener en capture-phase — pourquoi ça marche partout

Imaginez un flux keydown typique sur une page :

document (capture) ↓
  body (capture) ↓
    div.container (capture) ↓
      textarea#commentBox (target) ← l'utilisateur tape ici
    div.container (bubble) ↑
  body (bubble) ↑
document (bubble) ↑

JustZix attache un listener sur document en capture-phase — premier dans la chaîne, avant tout handler de page. Sur un match (Ctrl+Shift+L/S/K/H), JustZix appelle e.preventDefault() + e.stopPropagation() et la page ne voit jamais l'event. Fonctionne même quand le focus est dans une textarea — où Ctrl+L ferait normalement « tout sélectionner ».

Cas d'usage 1 — Workflow QA keyboard-first

Vous testez cycliquement 5 flux dans une app. Chaque flux :

1. Effectuer une action (cliquer dans l'app)
2. Vérifier l'Output Console — le log a-t-il l'air OK
3. Vider le log avant le prochain flux

Sans raccourcis : étape 3 = clic droit sur l'en-tête de l'Output Console → « Vider le log ». Avec un raccourci : Ctrl+Shift+L. 5× plus rapide, les mains restent sur le clavier, le focus reste sur l'app testée.

Bonus : si un flux journalise des centaines de lignes, après l'avoir utilisé vous voudrez peut-être seulement vos JZ.log : Ctrl+Shift+K deux fois → mode [J] → seulement vos logs visibles. Un autre Ctrl+Shift+K → [C] (seulement la page). Un troisième → [C+J] (tout).

Cas d'usage 2 — Découverte de l'API via Ctrl+Shift+H

Un nouvel utilisateur de JustZix. Il sait qu'il y a JUSTZIX.log(), mais ne se souvient pas du reste. Au lieu d'ouvrir la documentation :

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

• API JZ : liste des méthodes d'action (JZ.click, JZ.value, JZ.setValue, JZ.action)
• Alias : window.JUSTZIX (primaire), window.__JUSTZIX__ (toujours), window.JZ (quand libre)
• Capture de console : quels events sont capturés (console.log/warn/error/info/debug + JZ.log)
• Raccourcis : Ctrl+Shift+L/S/K/H avec descriptions

Échap / clic en dehors / re-Ctrl+Shift+H le ferment. Depuis v2.13.80, le popup est déplaçable par l'en-tête — vous pouvez le pousser de côté pour voir quelque chose en dessous, contraint au viewport pour qu'il ne s'envole pas hors écran.

Cas d'usage 3 — Recherche sans toucher la souris

L'Output Console affiche 800 lignes. Vous cherchez « purchase ». Mode un : scroller et Ctrl+F (recherche du navigateur) — fonctionne, mais Ctrl+F trouve aussi du texte dans d'autres éléments de la page.

Mode deux : Ctrl+Shift+S → le champ de recherche se déploie au-dessus du log, focus là, vous tapez « purchase » → le filtre en direct n'affiche que les lignes correspondantes. Échap efface la recherche. Un autre Ctrl+Shift+S ferme le champ de recherche.

Bonus : la recherche est persistante par onglet dans sessionStorage. F5 → la recherche revient avec l'ancien filtre.

Cas d'usage 4 — Power user multi-écrans

Écran 1 : l'app testée. Écran 2 : le même onglet dans une autre fenêtre (Chrome « Déplacer vers une autre fenêtre » + glisser). Le premier onglet déclenche un flux, le second onglet affiche l'Output Console en plein écran. Ctrl+Shift+L avec le focus sur l'écran 2 → vide les deux onglets ? Non — le raccourci agit par onglet, donc seulement l'onglet où vous avez laissé le focus.

Pour une sync inter-onglets → utilisez une règle JS + JUSTZIX.log dans les deux, avec un timestamp pour filtrer.

Pièges

• Les raccourcis exigent ≥1 Output Console rendue. Sans OC sur la page, le listener ne s'attache même pas. Si la règle JustZix ne correspond pas au domaine actuel → pas d'OC → pas de raccourcis. C'est intentionnel — le listener s'attache seulement quand nécessaire.
• Certains navigateurs surchargent Ctrl+Shift+lettre pour leurs propres raccourcis (p. ex. Ctrl+Shift+T = restaurer l'onglet fermé). JustZix fait preventDefault, mais certains raccourcis de navigateur tournent en code natif et battent notre listener en capture. Si vous repérez un conflit — changez le raccourci dans l'extension (prévu ; pour l'instant codé en dur).
• Popup d'aide z-index 2147483646. Un en dessous du max int32 (2147483647). Les poignées de drag des autres panes ont un z-index de 2147483645, donc le popup est toujours au-dessus. Certaines pages utilisent aussi le max int — JustZix gagne quand même d'un cran sur les modaux de page.
• Le cycle de viewMode ne saute aucun état même si [J] serait vide. v2.13.78 fait toujours [C+J] → [C] → [J] → [C+J], même si [J] serait vide. Intentionnel — montre que le mode est actif même quand il n'y a pas de logs.
• Les raccourcis ne s'arrêtent PAS quand le focus est dans la JS Console / le JS pane. Là, l'utilisateur tape du code — Ctrl+Shift+L pourrait gêner. Le listener fait preventDefault, donc le raccourci fonctionne quand même sans supprimer de texte. Bonne pratique : si vous tapez activement dans un pane, utilisez la souris pour Clear / basculer le mode.

La suite

Les raccourcis globaux sont une « couche power user » au-dessus de l'Output Console — la plupart des utilisateurs se contenteront de cliquer sur les boutons dans l'en-tête du pane. Mais si une toolbar QA est votre outil quotidien, ces 4 raccourcis vous feront gagner des dizaines de minutes par semaine.

Voyez aussi les articles liés :

• Output Console deep-dive — API complète du panneau
• window.JUSTZIX + JZ helpers — l'API programmatique que les raccourcis exposent dans le popup d'aide
• Mini-IDE dans un onglet — carte complète de toutes les fenêtres

Installez JustZix — entièrement gratuit, sans compte, sans serveur.