Programatyczne API — JZ i JUSTZIX

Czym jest API pomocnicze w stronie

Każdy skrypt JavaScript w regule JustZix — i kod każdego przycisku akcji — działa w kontekście, w którym czekają na Ciebie dwa gotowe globale: window.JZ oraz window.JUSTZIX. Nie musisz nic importować ani ładować; są dostępne od pierwszej linii skryptu.

To celowo wąskie API. Zamiast dawać setki metod, daje dwa pewne punkty zaczepienia: jeden do sterowania przyciskami akcji, drugi do logowania. Resztę robisz zwykłym JavaScriptem strony.

JZ — sterowanie przyciskami akcji

Obiekt JZ łączy Twój kod z przyciskami akcji wtyczki. Najważniejsze metody:

• JZ.click('LBL') — programatycznie klika przycisk akcji o etykiecie „LBL".
• JZ.action('LBL') — zwraca element DOM przycisku, więc możesz go stylizować lub sprawdzić atrybuty.
• JZ.actions() — tablica wszystkich widocznych przycisków akcji.
• JZ.labels() — tablica oryginalnych etykiet z zachowaną wielkością liter.

Wyszukiwanie etykiet jest niewrażliwe na wielkość liter — JZ.click('btn') i JZ.click('BTN') trafią w ten sam przycisk.

JUSTZIX — logger do Output Console

Obiekt JUSTZIX to logger, który pisze wprost do okna Output Console wtyczki. Ma metody JUSTZIX.log(), .warn(), .error(), .info() i .debug() — każda dopisuje wpis z odpowiednim poziomem. Pod ręką masz też aliasy __JUSTZIX__ oraz JZ.log.

Dzięki temu śledzisz, co robi reguła, bez otwierania DevTools. Komunikaty trafiają w jedno spokojne miejsce, oddzielone od szumu konsoli przeglądarki.

Czemu stabilne API bije ręczne sklejanie DOM

Mógłbyś szukać przycisków po selektorach i wysyłać własne zdarzenia, ale taki kod psuje się przy każdej zmianie układu wtyczki. JZ i JUSTZIX dają stały kontrakt: ta sama nazwa metody działa niezależnie od tego, jak zmieni się wnętrze.

Połącz to z mutation observerem, a zbudujesz prawdziwy workflow — reguła czeka na element, klika serię akcji i raportuje wynik:

// Akcja „AUTO" — łączy trzy inne akcje
JZ.click('LOAD');
setTimeout(() => JZ.click('PROC'), 500);
setTimeout(() => { JZ.click('SAVE'); JUSTZIX.info('gotowe'); }, 1500);