← Wszystkie wpisy

API i helpers

Globalne skróty klawiszowe Ctrl+Shift+L/S/K/H — keyboard-first workflow dla Output Console

15 maja 2026 · autor JustZix Team

Power user nie chce klikać. Power user chce Ctrl+Shift+coś i widzieć efekt. JustZix dorzucił od v2.13.75 zestaw 4 globalnych skrótów dla Output Console — wszystkie żyją w capture phase listenera na document, więc działają nawet kiedy fokus jest w textarea aplikacji, kiedy strona ma vim mode'a, czy kiedy zatrzymałeś się na pop-up modal'u. Jedyny warunek: na stronie żyje co najmniej jeden Output Console pane.

Cztery skróty — co robią

Wszystkie shortcuts broadcastują do każdego rendered Output Console — jeśli masz 3 OC pane'y w karcie (np. jeden filter na "fetch", drugi na "GTM", trzeci raw), Ctrl+Shift+L czyści wszystkie trzy.

Dlaczego Ctrl+Shift, nie tylko Ctrl?

Wcześniej (v2.13.69-74) Output Console miał Ctrl+L jako clear. Problem: Ctrl+L w niektórych przeglądarkach focusuje address bar jeśli fokus jest poza textarea. Brak zgrabnego conflict resolution — listener content scriptu nie zawsze blokuje native browser shortcut.

Ctrl+Shift+L nie ma kolizji z natywnymi shortcutami. Bonus: identyczny pattern co inne shortcuts (Ctrl+Shift+S/K/H) — łatwiejszy do zapamiętania ("wszystkie zaczynają od Ctrl+Shift").

Capture phase listener — dlaczego to działa wszędzie

Wyobraź sobie typowy event flow dla keydown na stronie:

document (capture) ↓
  body (capture) ↓
    div.container (capture) ↓
      textarea#commentBox (target) ← user wpisuje tu
    div.container (bubble) ↑
  body (bubble) ↑
document (bubble) ↑

JustZix attachuje listener na document w capture phase — pierwszy w łańcuchu, przed jakimkolwiek handler'em strony. Jeśli match shortcutowi (Ctrl+Shift+L/S/K/H), JustZix wywołuje e.preventDefault() + e.stopPropagation() i strona nawet nie widzi tego eventu. Działa nawet kiedy fokus jest w textarea — gdzie zwykle Ctrl+L by zrobił "select all text".

Use case 1 — Keyboard-first QA workflow

Robisz cykliczne testowanie 5 flow w aplikacji. Każdy flow:

1. Wykonaj akcję (klikanie w aplikacji)
2. Sprawdź Output Console — czy log wygląda OK
3. Wyczyść log przed następnym flow

Bez shortcutów: krok 3 = klik prawym myszki na header Output Console → "Clear log". Z shortcut'em: Ctrl+Shift+L. 5× szybciej, ręce nie odchodzą z klawiatury, fokus zostaje w aplikacji testowanej.

Plus: jeśli flow loguje setki linii, po użyciu możesz chcieć tylko swoje JZ.log: Ctrl+Shift+K dwa razy → tryb [J] → tylko twoje logi widoczne. Kolejny Ctrl+Shift+K → [C] (tylko strony). Trzeci → [C+J] (wszystko).

Use case 2 — Discovery API przez Ctrl+Shift+H

Nowy user JustZix. Wie że jest JUSTZIX.log(), ale nie pamięta co jeszcze. Zamiast otwierać dokumentację:

Ctrl+Shift+H → overlay z popup'em:

• JZ API: lista metod akcji (JZ.click, JZ.value, JZ.setValue, JZ.action)
• Aliasy: window.JUSTZIX (primary), window.__JUSTZIX__ (zawsze), window.JZ (gdy wolne)
• Console capture: jakie events są łapane (console.log/warn/error/info/debug + JZ.log)
• Skróty: Ctrl+Shift+L/S/K/H z opisami

Esc / klik poza modal / re-Ctrl+Shift+H zamykają. Od v2.13.80 popup jest draggable za header — możesz odsunąć go żeby zobaczyć coś pod nim, clampnięty do viewport żeby nie wyleciał off-screen.

Use case 3 — Search bez sięgania po mysz

Output Console wyświetla 800 linii. Szukasz "purchase". Tryb pierwszy: scroll i Ctrl+F (browser search) — działa, ale Ctrl+F znajduje też tekst w innych elementach strony.

Tryb drugi: Ctrl+Shift+S → search box rozsuwa się nad logiem, fokus tam, wpisujesz "purchase" → live filter pokazuje tylko matching linie. Esc czyści search. Następne Ctrl+Shift+S zamyka search box.

Bonus: search jest per-tab persistent w sessionStorage. F5 → wraca search ze starym filtrem.

Use case 4 — Multi-monitor power user

Monitor 1: aplikacja testowana. Monitor 2: ten sam tab w drugim oknie (Chrome "Move to other window" + drag). Pierwsza karta odpala flow, druga karta pokazuje Output Console pełnoekranowo. Ctrl+Shift+L z fokus na monitor 2 → clear obu kart? Nie — shortcut działa per-tab, więc tylko tej karty na której zostawiłeś fokus.

Dla synchronizacji między kartami → użyj JS rule + JUSTZIX.log w obu, daty timestamp żeby filtrować.

Pułapki

• Shortcuts wymagają ≥1 Output Console rendered. Bez OC na stronie listener nawet się nie zaczyna. Jeśli reguła JustZix nie matchuje aktualnej domeny → brak OC → shortcuts nie działają. To celowe — listener attached tylko gdy potrzebny.
• Niektóre browsery override'ują Ctrl+Shift+letter dla własnych skrótów (np. Ctrl+Shift+T = restore zamknięty tab). JustZix preventDefault'uje, ale niektóre browser shortcuts działają w native code i wyprzedzają nasz capture listener. Jeśli zauważysz konflikt — zmień shortcut w extension'ie (planowane, na razie hardcoded).
• Help popup z-index 2147483646. Jeden niżej niż max int32 (2147483647). Drag handles innych pane'ów mają z-index 2147483645, więc popup zawsze nad nimi. Niektóre strony też używają max int — JustZix wciąż wygrywa o jedno z modalami strony.
• viewMode cycle skip [J] gdy nie masz JZ.log line. Implementacja v2.13.78 zawsze przełącza [C+J] → [C] → [J] → [C+J], nawet jeśli [J] byłby pusty. To celowe — pokazuje że mode jest aktywny, nawet jeśli brak logów.
• Skróty NIE blokują się gdy fokus w JS Console / JS pane. Tam użytkownik pisze kod, Ctrl+Shift+L mógłby przeszkadzać. Listener jednak preventDefault'uje, więc skrót zadziała ale tekstu nie skasuje. Best practice: jeśli aktywnie piszesz w pane, użyj myszki dla Clear/Mode toggling.

Co dalej

Globalne skróty to "power user layer" nad Output Console — dla większości userów wystarczają klikanie buttonów w headerze pane'a. Ale jeśli QA toolbar to twoje codzienne narzędzie, te 4 skróty zaoszczędzą ci dziesiątki minut tygodniowo.

Sprawdź też powiązane:

• Output Console deep-dive — pełne API panelu
• window.JUSTZIX + JZ helpers — programmatic API które shortcuts otwierają w help popup
• Mini-IDE w karcie — pełna mapa wszystkich okien

Zainstaluj JustZix — kompletnie za darmo, bez konta, bez serwera.