APIs programmatiques — JZ et JUSTZIX

Ce qu'est l'API d'aide intégrée à la page

Chaque extrait JavaScript d'une règle JustZix — et le code derrière chaque bouton d'action — s'exécute dans un contexte où deux objets globaux tout prêts vous attendent : window.JZ et window.JUSTZIX. Rien à importer, rien à charger ; ils sont disponibles dès la première ligne de votre script.

C'est une API volontairement réduite. Au lieu de centaines de méthodes, elle vous donne deux points d'ancrage solides : un pour piloter les boutons d'action, un pour journaliser. Tout le reste se fait avec le JavaScript ordinaire de la page.

JZ — piloter les boutons d'action

L'objet JZ relie votre code aux boutons d'action de l'extension. Les méthodes clés sont :

• JZ.click('LBL') — clique programmatiquement le bouton d'action étiqueté « LBL ».
• JZ.action('LBL') — renvoie l'élément DOM du bouton, pour le styler ou inspecter ses attributs.
• JZ.actions() — un tableau de tous les boutons d'action visibles.
• JZ.labels() — un tableau des labels originaux avec leur casse préservée.

La recherche de label est insensible à la casse — JZ.click('btn') et JZ.click('BTN') visent le même bouton.

JUSTZIX — journaliser vers l'Output Console

L'objet JUSTZIX est un logger qui écrit directement dans la fenêtre Output Console de l'extension. Il propose JUSTZIX.log(), .warn(), .error(), .info() et .debug() — chacune ajoute une entrée au niveau correspondant. Les alias __JUSTZIX__ et JZ.log sont aussi à portée de main.

Vous suivez ainsi ce que fait une règle sans ouvrir les DevTools. Les messages atterrissent dans un endroit calme, séparé du bruit de la console du navigateur.

Pourquoi une API stable vaut mieux que du bricolage DOM

Vous pourriez chercher les boutons par sélecteur et émettre vos propres événements, mais ce code casse dès que la mise en page de l'extension change. JZ et JUSTZIX vous donnent un contrat stable : le même nom de méthode fonctionne quelles que soient les évolutions internes.

Associez-le à un mutation observer et vous obtenez un vrai workflow — une règle attend un élément, clique une série d'actions et signale le résultat :

// Action « AUTO » — enchaîner trois autres actions
JZ.click('LOAD');
setTimeout(() => JZ.click('PROC'), 500);
setTimeout(() => { JZ.click('SAVE'); JUSTZIX.info('terminé'); }, 1500);