Ilya Gorbunov
28 lines
1.6 KiB
Markdown
28 lines
1.6 KiB
Markdown
# 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](https://github.com/JetBrains/kotlin/tree/master/js/js.libraries/src) project.
|
|
|
|
## Compiling the Kotlin Standard Library for JavaScript
|
|
|
|
The Kotlin Standard Library for JS is built with gradle, see the corresponding module's [ReadMe](../libraries/stdlib/js/ReadMe.md).
|
|
|
|
|
|
## Reusing JVM based test cases in JavaScript
|
|
|
|
Any Kotlin test cases using the **org.junit.Test** annotation and the [kotlin.test](../libraries/kotlin.test) package, such as [this test case](../libraries/stdlib/test/text/StringNumberConversionTest.kt#L16) are automatically converted to JavaScript using [QUnit](http://qunitjs.com/).
|
|
|
|
This allows the test cases to be [run directly in a web page in any web browser](../libraries/stdlib/js/ReadMe.md).
|
|
|
|
## Using the Kotlin Library in JavaScript
|
|
|
|
There is a [simple sample](../libraries/examples/browser-example/ReadMe.md) which shows how to use the [Kotlin Standard Library](https://kotlinlang.org/api/latest/jvm/stdlib/index.html) from inside JavaScript in a web page.
|
|
|
|
## Contributing
|
|
|
|
We love contributions! The JavaScript translation could really use your help! If you fancy contributing:
|
|
|
|
* check the [contributing section](https://github.com/JetBrains/kotlin/blob/master/ReadMe.md) on general stuff like getting the code etc
|
|
* try fix one of the pending [JavaScript translation issues](https://youtrack.jetbrains.com/issues/KT?q=Subsystems:%20%7BBack-end.%20JavaScript%7D%20-Resolved)
|