Kotlin/JS を始める
このチュートリアルでは、Kotlin/JavaScript (Kotlin/JS) を使用してブラウザ向けの Web アプリケーションを作成する方法を説明します。 アプリケーションを作成するには、ご自身のワークフローに最適なツールを選択してください:
- IntelliJ IDEA: バージョン管理システムからプロジェクトテンプレートをクローンし、IntelliJ IDEA で作業します。
- Gradle ビルドシステム: プロジェクトのビルドファイルを手動で作成し、内部でセットアップがどのように機能しているかをより深く理解します。
ブラウザをターゲットにするだけでなく、Kotlin/JS を使って他の環境向けにコンパイルすることもできます。 詳細については、実行環境を参照してください。
IntelliJ IDEA でアプリケーションを作成する
Kotlin/JS Web アプリケーションを作成するには、IntelliJ IDEA を使用できます。
環境のセットアップ
- 最新バージョンの IntelliJ IDEA をダウンロードしてインストールします。
- Kotlin Multiplatform IDE プラグイン をインストールします(Kotlin Multiplatform Gradle プラグインと混同しないでください)。
プロジェクトの作成
IntelliJ IDEA で、File | New | Project from Version Control を選択します。
Kotlin/JS テンプレートプロジェクト の URL を入力します:
texthttps://github.com/Kotlin/kmp-js-wizardClone をクリックします。
プロジェクトの設定
kmp-js-wizard/gradle/libs.versions.tomlファイルを開きます。これにはプロジェクトの依存関係のバージョンカタログが含まれています。Kotlin のバージョンが、Kotlin/JS をターゲットとする Web アプリケーションの作成に必要な Kotlin Multiplatform Gradle プラグインのバージョンと一致していることを確認します:
toml[versions] kotlin = "2.4.21" [plugins] kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }Gradle ファイルを同期します(
libs.versions.tomlファイルを更新した場合)。ビルドファイルに表示される Load Gradle Changes アイコンをクリックします。
または、Gradle ツールウィンドウの更新ボタンをクリックします。
マルチプラットフォームプロジェクトの Gradle 設定の詳細については、Multiplatform Gradle DSL リファレンス を参照してください。
アプリケーションのビルドと実行
src/jsMain/kotlin/Main.ktファイルを開きます。src/jsMain/kotlin/ディレクトリには、プロジェクトの JavaScript ターゲット向けのメインの Kotlin ソースファイルが含まれています。Main.ktファイルには、kotlinx.browserAPI を使用してブラウザページ上に「Hello, Kotlin/JS!」を描画するコードが含まれています。
main()関数にある Run アイコンをクリックして、コードを実行します。
ブラウザで Web アプリケーションが自動的に開きます。 あるいは、実行が完了した後にブラウザで次の URL を開くこともできます:
http://localhost:8080/Web アプリケーションが表示されます:

アプリケーションを初めて実行すると、IntelliJ IDEA は上部バーに対応する実行構成(jsMain [js])を作成します:

Ultimate サブスクリプション付きの IntelliJ IDEA では、JS Debugger を使用して IDE から直接コードをデバッグできます。
継続的ビルド(Continuous Build)を有効にする
Gradle は、変更を加えるたびにプロジェクトを自動的にリビルドできます:
実行構成のリストで jsMain [js] を選択し、More Actions | Edit をクリックします。

Run/Debug Configurations ダイアログの Run フィールドに、
jsBrowserDevelopmentRun --continuousと入力します。
OK をクリックします。
これで、アプリケーションを実行して何らかの変更を加えると、クラスファイルを保存(Ctrl + S / Cmd + S)または変更するたびに、Gradle がプロジェクトの増分ビルドを自動的に実行し、ブラウザをホットリロードします。
アプリケーションを変更する
単語内の文字数をカウントする機能を追加して、アプリケーションを変更してみましょう。
入力要素の追加
src/jsMain/kotlin/Main.ktファイルで、拡張関数 を使用してユーザー入力を読み取る HTML input 要素 を追加します:kotlin// Element.appendMessage() 関数を置き換えます fun Element.appendInput() { val input = document.createElement("input") appendChild(input) }main()内でappendInput()関数を呼び出します。これによりページに入力要素が表示されます:kotlinfun main() { // document.body!!.appendMessage(message) を置き換えます document.body?.appendInput() }アプリケーションを再度実行します。
アプリケーションは次のようになります:

入力イベント処理の追加
appendInput()関数の内部にリスナーを追加して、入力値を読み取り、変更に反応するようにします:kotlin// 現在の appendInput() 関数を置き換えます fun Element.appendInput(onChange: (String) -> Unit = {}) { val input = document.createElement("input").apply { addEventListener("change") { event -> onChange(event.target.unsafeCast<HTMLInputElement>().value) } } appendChild(input) }IDE のサジェストに従って、
HTMLInputElementの依存関係をインポートします。
main()でonChangeコールバックを呼び出します。これにより、入力値が読み取られて処理されます:kotlinfun main() { // document.body?.appendInput() を置き換えます document.body?.appendInput(onChange = { println(it) }) }
出力要素の追加
段落を作成する拡張関数を定義して、出力を表示するためのテキスト要素を追加します:
kotlinfun Element.appendTextContainer(): Element { return document.createElement("p").also(::appendChild) }main()でappendTextContainer()関数を呼び出します。これにより出力要素が作成されます:kotlinfun main() { // 出力用のテキストコンテナを作成します // val message = Message(topic = "Kotlin/JS", content = "Hello!") を置き換えます val output = document.body?.appendTextContainer() // 入力値を読み取ります document.body?.appendInput(onChange = { println(it) }) }
入力を処理して文字数をカウントする
空白を削除し、文字数をカウントして出力を表示するように入力を処理します。
main() 関数内の appendInput() 関数に次のコードを追加します:
fun main() {
// 出力用のテキストコンテナを作成します
val output = document.body?.appendTextContainer()
// 入力値を読み取ります
// 現在の appendInput() 関数を置き換えます
document.body?.appendInput(onChange = { name ->
name.replace(" ", "").let {
output?.textContent = "Your name contains ${it.length} letters"
}
})
}上記のコードについて:
replace()関数 は名前から空白文字を削除します。let{}スコープ関数 は、オブジェクトのコンテキスト内で関数を実行します。- 文字列テンプレート (
${it.length}) は、先頭にドル記号 ($) を付け、中括弧 ({}) で囲むことで、単語の長さを文字列に挿入します。 なお、itは ラムダパラメーター のデフォルトの名前です。
アプリケーションの実行
- アプリケーションを実行します。
- ご自身の名前を入力します。
- Enter を押します。
結果を確認できます:

入力を処理して一意な(重複を除いた)文字数をカウントする
追加の演習として、入力を処理して単語内の一意な(ユニークな)文字数を計算し、表示してみましょう:
src/jsMain/kotlin/Main.ktファイルで、Stringに対する.countDistinctCharacters()拡張関数 を追加します:kotlinfun String.countDistinctCharacters() = lowercase().toList().distinct().count()上記のコードについて:
.lowercase()関数 は名前を小文字に変換します。toList()関数 は入力文字列を文字のリストに変換します。distinct()関数 は単語から重複のない文字のみを選択します。count()関数 は一意な文字の数をカウントします。
main()で.countDistinctCharacters()関数を呼び出します。これにより、名前の一意な文字数がカウントされます:kotlinfun main() { // 出力用のテキストコンテナを作成します val output = document.body?.appendTextContainer() // 入力値を読み取ります document.body?.appendInput(onChange = { name -> name.replace(" ", "").let { // 一意な文字数を出力します // output?.textContent = "Your name contains ${it.length} letters" を置き換えます output?.textContent = "Your name contains ${it.countDistinctCharacters()} unique letters" } }) }手順に従って アプリケーションを実行し、名前を入力 します。
結果を確認できます:

Gradle を使用してアプリケーションを作成する
このセクションでは、Gradle を使用して Kotlin/JS アプリケーションを手動で作成する方法を学びます。
Gradle は、Kotlin/JS および Kotlin Multiplatform プロジェクトのデフォルトのビルドシステムです。 また、Java、Android、およびその他のエコシステムでも広く使用されています。
プロジェクトファイルの作成
Kotlin Gradle プラグイン (KGP) と互換性のある Gradle バージョンを使用していることを確認してください。 詳細については、互換性テーブル を参照してください。
ファイルエクスプローラー、コマンドライン、またはお好みのツールを使用して、プロジェクト用の空のディレクトリを作成します。
プロジェクトディレクトリ内に、次の内容の
build.gradle.ktsファイルを作成します:kotlin// build.gradle.kts plugins { kotlin("multiplatform") version "2.4.21" } repositories { mavenCentral() } kotlin { js { // ブラウザで実行する場合は browser()、Node.js で実行する場合は nodejs() を使用します browser() binaries.executable() } }groovy// build.gradle plugins { id 'org.jetbrains.kotlin.multiplatform' version '2.4.21' } repositories { mavenCentral() } kotlin { js { // ブラウザで実行する場合は browser()、Node.js で実行する場合は nodejs() を使用します browser() binaries.executable() } }browser()やnodejs()など、さまざまな 実行環境 を使用できます。 各環境はコードが実行される場所を定義し、Gradle がプロジェクト内でタスク名を生成する方法を決定します。プロジェクトディレクトリ内に、空の
settings.gradle.ktsファイルを作成します。プロジェクトディレクトリ内に、
src/jsMain/kotlinディレクトリを作成します。src/jsMain/kotlinディレクトリ内に、次の内容のhello.ktファイルを追加します:kotlinfun main() { println("Hello, Kotlin/JS!") }慣例として、すべてのソースコードは
src/<ターゲット名>[Main|Test]/kotlinディレクトリに配置されます:Mainはソースコードの配置場所です。Testはテストの配置場所です。<ターゲット名>はターゲットプラットフォームに対応します(この場合はjs)。
browser 環境の場合
browser 環境を使用している場合は、次の手順に従ってください。 nodejs 環境を使用している場合は、プロジェクトのビルドと実行 セクションに進んでください。
プロジェクトディレクトリ内に、
src/jsMain/resourcesディレクトリを作成します。src/jsMain/resourcesディレクトリ内に、次の内容のindex.htmlファイルを作成します:html<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Application title</title> </head> <body> <script src="$NAME_OF_YOUR_PROJECT_DIRECTORY.js"></script> </body> </html><$NAME_OF_YOUR_PROJECT_DIRECTORY>プレースホルダーを、ご自身のプロジェクトディレクトリの名前に置き換えます。
プロジェクトのビルドと実行
プロジェクトをビルドするには、ルートプロジェクトディレクトリから次のコマンドを実行します:
# ブラウザの場合
gradle jsBrowserDevelopmentRun
# または
# Node.js の場合
gradle jsNodeDevelopmentRunbrowser 環境を使用している場合、ブラウザが index.html ファイルを開き、ブラウザコンソールに "Hello, Kotlin/JS!" と出力されるのを確認できます。 コンソールは、Ctrl + Shift + J / Cmd + Option + J コマンドを使用して開くことができます。

nodejs 環境を使用している場合は、ターミナルに "Hello, Kotlin/JS!" と出力されるのが確認できます。

IDE でプロジェクトを開く
Gradle をサポートする任意の IDE でプロジェクトを開くことができます。
IntelliJ IDEA を使用する場合:
- File | Open を選択します。
- プロジェクトディレクトリを見つけます。
- Open をクリックします。
IntelliJ IDEA は、それが Kotlin/JS プロジェクトであるかどうかを自動的に検出します。 プロジェクトに問題が発生した場合、IntelliJ IDEA は Build ペインにエラーメッセージを表示します。
