Programmatische APIs — JZ und JUSTZIX

Was die seiteninterne Helfer-API ist

Jedes JavaScript-Snippet in einer JustZix-Regel — und der Code hinter jedem Aktionsbutton — läuft in einem Kontext, in dem zwei fertige Globals auf dich warten: window.JZ und window.JUSTZIX. Nichts zu importieren, nichts zu laden; sie sind ab der ersten Zeile deines Skripts verfügbar.

Das ist eine bewusst kleine API. Statt Hunderter Methoden gibt sie dir zwei feste Ankerpunkte: einen, um Aktionsbuttons zu steuern, einen zum Loggen. Alles andere erledigst du mit dem normalen JavaScript der Seite.

JZ — Aktionsbuttons steuern

Das JZ-Objekt verbindet deinen Code mit den Aktionsbuttons der Erweiterung. Die wichtigsten Methoden:

• JZ.click('LBL') — klickt den mit „LBL" beschrifteten Aktionsbutton programmatisch.
• JZ.action('LBL') — gibt das DOM-Element des Buttons zurück, damit du es stylen oder Attribute prüfen kannst.
• JZ.actions() — ein Array aller sichtbaren Aktionsbuttons.
• JZ.labels() — ein Array der originalen Labels mit erhaltener Groß-/Kleinschreibung.

Die Label-Suche ist case-insensitive — JZ.click('btn') und JZ.click('BTN') treffen denselben Button.

JUSTZIX — Logging in die Output Console

Das JUSTZIX-Objekt ist ein Logger, der direkt ins Output-Console-Fenster der Erweiterung schreibt. Es bietet JUSTZIX.log(), .warn(), .error(), .info() und .debug() — jede hängt einen Eintrag mit der passenden Stufe an. Die Aliase __JUSTZIX__ und JZ.log stehen ebenfalls bereit.

So verfolgst du, was eine Regel tut, ohne die DevTools zu öffnen. Meldungen landen an einem ruhigen Ort, getrennt vom Lärm der Browserkonsole.

Warum eine stabile API selbstgebaute DOM-Logik schlägt

Du könntest Buttons per Selektor abfragen und eigene Events auslösen, aber dieser Code bricht, sobald sich das Layout der Erweiterung verschiebt. JZ und JUSTZIX geben dir einen festen Vertrag: derselbe Methodenname funktioniert, egal wie sich das Innenleben ändert.

Kombiniere das mit einem Mutation Observer und du hast einen echten Workflow — eine Regel wartet auf ein Element, klickt eine Reihe von Aktionen und meldet das Ergebnis:

// Aktion „AUTO" — drei andere Aktionen verketten
JZ.click('LOAD');
setTimeout(() => JZ.click('PROC'), 500);
setTimeout(() => { JZ.click('SAVE'); JUSTZIX.info('fertig'); }, 1500);