Facilitating the Spread of Knowledge and Innovation in Professional Software Development

Write for InfoQ


Choose your language

InfoQ Homepage News J2CL: A Java-to-JavaScript Transpiler

J2CL: A Java-to-JavaScript Transpiler

Leia em Português

This item in japanese

Lire ce contenu en français


Designed, developed, and open-sourced by Google, J2CL is a source-to-source compiler that converts Java to Javascript. J2CL developers say the compiler "enables seamless use of Java in your JavaScript applications."

J2CL attempts to solve a different problem than similar Java-to-Javascript frameworks such as GWT, and it is not meant to compete with or replace existing JavaScript frameworks. Instead, J2CL is about interoperability and cross-platform code reuse. According to the developers, "[y]ou can use J2CL to just make some Java code accessible from JavaScript or go all the way to create a whole application with it; whatever best suits your needs."

The tool was developed with flexibility in mind and can be applied in a number of different ways. One such way is to ensure complex logic running on multiple platforms implemented in different technologies, can be shared across platforms. For example, Thomas Deegan, a previous contributor to the J2CL project, says "the code powering Google Docs front end needs to be written for web ... J2CL does the transpilation of all document manipulation and rendering logic from Java -> JS". Another use might be reusing a library written in Java in a Node.js application.

J2CL can translate most existing Java code from source but not all Java APIs are supported, such as the Java reflection API. By default, translated code is not public and a number of Java annotations from JsInterop can be used to identify what classes, methods, instance variables, or other code should be exposed. The project includes a very simple "hello world" example to demonstrate usage. A slightly modified excerpt of that example is included below showing an annotated Java class and how it can be used in JavaScript.

The following Java class, ran through J2CL:

package com.acme

import jsinterop.annotations.JsType;

public class HelloWorld {

  public static String getHelloWorld() {
    return "Hello from Java!";


can be used in JavaScript like below.

const HelloWorld = goog.require('com.acme');

The developers claim it is production ready and serves as "the underlying technology of the most advanced GSuite apps developed by Google including GMail, Inbox, Docs, Slides and Calendar."

The project was open sourced late last year, but talks of the project go as far back as 2014. Originally, J2CL was associated with the GWT project. However, in early 2015, the developers determined that the goals of the project could not be accomplished as part of the GWT project and decided to break it out into its own project. Integration with existing tools is not yet available and support for Windows is currently limited.

For additional information, visit the project's Github page or getting started guide.

Rate this Article


Hello stranger!

You need to Register an InfoQ account or or login to post comments. But there's so much more behind being registered.

Get the most out of the InfoQ experience.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Community comments

  • Why detach from GWT?

    by Steve Zara,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    I'd be interested to know the reason for having this project separate from GWT. GWT does this transpiling but also has a rich UI library which makes writing web-based interfaces easy.

  • Re: Why detach from GWT?

    by Dustin Schultz,

    Your message is awaiting moderation. Thank you for participating in the discussion.

    According to their Github page

    There was no practical way to achieve those goals completely [and] incrementally out of GWT. We started from scratch using everything we learned from working on GWT over the years. In the meantime, we kept GWT steering committee members in the loop and gave contributors very early access so they could decide to build the next version of GWT on J2CL.

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p

Allowed html: a,b,br,blockquote,i,li,pre,u,ul,p