Files

T

Dmitry Petrov 4dd100122b Explicitly remove NOPs inserted for bytecode analysis in post-conditional loops.

Remove redundant NOPs during bytecode optimization.

NOP instruction is required iff one of the following is true:
(a) it is a first bytecode instruction in a try-catch block (JVM BE assumption);
(b) it is a sole bytecode instruction in a source code line (breakpoints on that line will not work).
All other NOP instructions can be removed.

Note that it doesn't really affect the performance for mature JVM implementations.
However, the perceived quality of the generated code is somewhat improved :).

Related: KT-15609

2017-01-13 10:31:07 +03:00

js.ast

JS: make functions called call to inline properly. See KT-7004

2017-01-12 18:12:39 +03:00

js.frontend

Multi-platform refactoring: get rid of PlatformKind (replace with MultiTargetPlatform)

2017-01-12 18:58:13 +03:00

js.inliner

JS: fix translation of return statement surrounded by try..finally block in suspend lambda. See KT-15625

2017-01-12 18:12:39 +03:00

js.libraries

IDL2K: KT-15436 js stdlib: org.w3c.fetch.RequestInit has 12 parameters, all required

2017-01-11 18:07:47 +03:00

js.parser

JS: make JS parser to store function's name in AST. See KT-15475

2017-01-12 18:12:40 +03:00

js.serializer

JS: serialize type of local anonymous class as its denotable supertype. See KT-14888

2016-12-15 19:05:32 +03:00

js.tests

Explicitly remove NOPs inserted for bytecode analysis in post-conditional loops.

2017-01-13 10:31:07 +03:00

js.translator

JS: make JS parser to store function's name in AST. See KT-15475

2017-01-12 18:12:40 +03:00

npm.templates

JS: add templates for kotlin and kotlin-compiler packages

2016-10-13 23:22:36 +03:00

ReadMe.md

Updates link to JavaScript issues on YouTrack (#939 )

2016-08-27 21:18:20 +03:00

ReadMe.md

JavaScript Translation

This module performs the translation of Kotlin source code to JavaScript.

There are various Kotlin APIs to JavaScript environments and libraries in the js.libraries project.

Compiling the standard Kotlin library to JavaScript

the kotlin-js-library module creates a jar containing all the Kotlin source code for the runtime and standard kotlin library code (both definitions and implementation code) to be compiled to JavaScript.
the kotlin-js-tests module then compiles a selection of test cases from the Kotlin standard library for the JVM to JavaScript. These tests can then be run in a web browser using QUnit
the kotlin-js-tests-junit then runs the JavaScript tests for the standard library inside JUnit using Selenium and the underlying JavaScript & QUnit so that the JavaScript can be tested as part of the maven continuous integration build.

Reusing JVM based test cases in JavaScript

Any Kotlin test cases using the org.junit.Test annotation and the kotlin.test package, such as this test case are automatically converted to JavaScript using QUnit.

This allows the test cases to be ran directly in a web page in any web browser.

Using the Kotlin Library in JavaScript

There is a simple sample which shows how to use the Kotlin Standard Library from inside JavaScript in a web page or in a JVM using kool.io's JavaFX browser

Contributing

We love contributions! The JavaScript translation could really use your help! If you fancy contributing:

check the contributing section on general stuff like getting the code etc
here's the list of current excluded standard library unit tests from the JavaScript JUnit test run; see if you can fix one of those? (Check the TODO commands and the links to specific issues)
try fix one of the pending JavaScript translation issues