Convertir JS en JAR

Un appareil ou un programme basé sur Java peut nécessiter un package .jar, alors que le code source disponible est un fichier JavaScript .js. La solution correcte dépend du fait que vous ayez seulement besoin d’archiver le script ou que vous deviez le réécrire et l’exécuter via un moteur JavaScript compatible avec Java.

Qu’est-ce que le format JS ?

Un fichier .js contient normalement du code source JavaScript utilisé par les navigateurs web, Node.js, Electron, les applications Adobe, les systèmes de build ou Windows Script Host. JavaScript s’exécute dans un moteur tel que V8, SpiderMonkey, JavaScriptCore ou GraalJS.

JavaScript et Java sont des langages différents. Modifier .js en .jar, renommer le fichier ou le placer dans une archive ZIP ne le compile pas en fichiers de classes Java. Les scripts de navigateur peuvent également dépendre d’API telles que document et window, tandis que les scripts Node.js peuvent dépendre de require, de packages npm ou d’API propres à Node.

Qu’est-ce que le format JAR ?

Un JAR, ou Java ARchive, est un package basé sur ZIP destiné aux fichiers de classes Java, aux bibliothèques, aux ressources et aux métadonnées. Les applications et bibliothèques Java utilisent des JAR, car ils regroupent de nombreux fichiers dans un package distribuable unique, prennent en charge la compression et peuvent inclure un manifeste à l’emplacement META-INF/MANIFEST.MF. Les JAR peuvent également être signés afin de garantir leur intégrité et de vérifier leur éditeur.

Un JAR peut contenir du JavaScript en tant que ressource ordinaire, mais un JAR contenant uniquement un script n’est pas automatiquement exécutable. Un JAR exécutable nécessite une classe d’entrée Java compilée ainsi qu’une entrée de manifeste telle que Main-Class : cette classe doit ensuite démarrer ou interpréter le JavaScript.

Empaqueter le fichier JS dans un JAR

Utilisez l’utilitaire jar inclus dans un JDK lorsque le besoin consiste simplement à créer une archive JAR contenant le script d’origine.

1. Installez un JDK tel qu’Eclipse Temurin, Oracle JDK ou une autre distribution compatible ; un JRE seul ne fournit pas les outils d’empaquetage habituels.
2. Placez script.js et ses ressources dans un répertoire de projet, en conservant les chemins référencés par le script.
3. Ouvrez un terminal dans le répertoire du projet et exécutez jar --create --file app.jar script.js. Ajoutez les répertoires ou fichiers nécessaires, par exemple jar --create --file app.jar script.js lib config.
4. Vérifiez l’archive avec jar --list --file app.jar.

Dans les anciennes versions du JDK, la commande équivalente est jar cf app.jar script.js. Ce processus conserve le code source JavaScript et l’empaquette : il ne permet pas à java -jar app.jar d’exécuter le script.

Créer un wrapper Java exécutable

Pour distribuer une application Java qui exécute le script, créez un projet Java avec une classe de lancement. Le lanceur charge script.js depuis le JAR, crée un contexte de moteur JavaScript, fournit les arguments ou objets hôtes requis et évalue le script.

GraalJS peut être intégré via l’API GraalVM Polyglot et ses dépendances Java. Ajoutez les dépendances requises du SDK GraalVM et du moteur JavaScript via Maven ou Gradle, écrivez le lanceur, compilez-le et empaquetez la classe du lanceur, le script, les ressources et les dépendances. La configuration de GraalJS varie selon la version de GraalVM et des dépendances : utilisez donc les versions de dépendances prises en charge par le runtime sélectionné plutôt que de copier un exemple Nashorn obsolète.

Nashorn a été supprimé des distributions JDK standard à partir de JDK 15. Le code qui dépend de Nashorn doit utiliser une distribution de compatibilité maintenue séparément ou être migré vers un autre moteur ; un JDK actuel ne fournit normalement pas Nashorn.

Dans IntelliJ IDEA, une option d’empaquetage courante pour les applications de bureau est File → Project Structure → Artifacts → JAR → From modules with dependencies. Sélectionnez la classe du lanceur comme classe principale, choisissez si les dépendances doivent être extraites dans un fat JAR ou conservées à côté de l’application, puis construisez l’artifact. Une build Maven ou Gradle est généralement plus reproductible pour les projets ayant de nombreuses dépendances. Exécutez un package correctement configuré avec java -jar app.jar.

Si le fichier d’origine est une application Node.js, le conserver sous forme de projet Node.js est généralement l’option techniquement correcte. Un wrapper Java peut démarrer node comme processus externe, mais le système cible doit toujours disposer de Node.js et le résultat n’est pas une conversion en bytecode Java.

Options en ligne et de bureau

Il n’existe aucun convertisseur en ligne réputé capable de traduire de manière fiable un JavaScript arbitraire en classes Java équivalentes ou en JAR exécutable autonome. Les outils d’archivage en ligne peuvent parfois créer un package similaire à un ZIP, mais ils ne peuvent pas déduire un point d’entrée Java, installer un moteur JavaScript, résoudre les dépendances npm ou de navigateur, ni tester le comportement à l’exécution.

Pour une archive à fichier unique ne contenant pas de données sensibles, un outil de création de ZIP en ligne peut être utilisable uniquement si le destinataire accepte une archive ordinaire et si vous en vérifiez ensuite le contenu ; renommer un .zip téléchargé en .jar ne remplace pas sa création avec le JDK. Utilisez la commande locale jar du JDK, IntelliJ IDEA, Maven ou Gradle pour le code source et les projets comportant plusieurs fichiers, et ne téléversez pas de scripts propriétaires vers un service en ligne.

Vérifications de compatibilité

Testez le script dans le runtime exact destiné au JAR. Les variables globales du navigateur n’existent pas dans Node.js ou GraalJS, les modules Node.js ne fonctionnent pas automatiquement dans GraalJS et l’accès aux hôtes Java peut nécessiter une configuration explicite. Vérifiez les chemins relatifs, les permissions de fichiers, l’encodage des caractères, les bibliothèques natives, l’accès réseau, les variables d’environnement et toutes les dépendances tierces.

Un JAR contenant uniquement script.js est une archive. Un package exécutable nécessite un lanceur Java, un moteur JavaScript compatible, une entrée de manifeste Main-Class valide et une disposition des dépendances compatible avec le JDK cible.