Open AIDoc

日本語

简体中文
繁體中文
한국어

日本語

简体中文
繁體中文
한국어

Appearance

JavaScriptからKotlinコードを使用する ​

選択したJavaScriptモジュールシステムに応じて、Kotlin/JSコンパイラは異なる出力を生成します。しかし一般的に、Kotlinコンパイラは通常のJavaScriptクラス、関数、プロパティを生成し、それらをJavaScriptコードから自由に利用できます。ただし、いくつかの注意点があります。

plainモードで宣言を個別のJavaScriptオブジェクトに分離する ​

モジュール種別を明示的にplainに設定した場合、Kotlinは現在のモジュール内のすべてのKotlin宣言を含むオブジェクトを作成します。これはグローバルオブジェクトを汚染しないようにするためです。つまり、myModuleというモジュールの場合、すべての宣言はmyModuleオブジェクトを介してJavaScriptから利用可能です。例:

kotlin
fun foo() = "Hello"

JavaScriptからは次のように呼び出せます。

javascript
alert(myModule.foo());

これは、KotlinモジュールをUMD（browserとnodejsターゲットの両方のデフォルト設定です）、CommonJS、またはAMDのようなJavaScriptモジュールにコンパイルする場合には適用されません。この場合、宣言は選択したJavaScriptモジュールシステムで指定された形式で公開されます。例えば、UMDまたはCommonJSを使用する場合、呼び出し箇所は次のようになります。

javascript
alert(require('myModule').foo());

JavaScriptモジュールシステムに関する詳細については、JavaScriptモジュールに関する記事を確認してください。

パッケージ構造 ​

Kotlinはパッケージ構造をJavaScriptに公開するため、宣言をルートパッケージに定義しない限り、JavaScriptで完全修飾名を使用する必要があります。例:

kotlin
package my.qualified.packagename

fun foo() = "Hello"

例えば、UMDまたはCommonJSを使用する場合、呼び出し箇所は次のようになります。

javascript
alert(require('myModule').my.qualified.packagename.foo())

または、plainをモジュールシステム設定として使用する場合:

javascript
alert(myModule.my.qualified.packagename.foo());

@JsNameアノテーション ​

場合によっては（例えば、オーバーロードをサポートするため）、KotlinコンパイラはJavaScriptコードで生成される関数や属性の名前をマングリングします。生成される名前を制御するには、@JsNameアノテーションを使用できます。

kotlin
// Module 'kjs'
class Person(val name: String) {
    fun hello() {
        println("Hello $name!")
    }

    @JsName("helloWithGreeting")
    fun hello(greeting: String) {
        println("$greeting $name!")
    }
}

このクラスはJavaScriptから次のように使用できます。

javascript
// If necessary, import 'kjs' according to chosen module system
var person = new kjs.Person("Dmitry");   // refers to module 'kjs'
person.hello();                          // prints "Hello Dmitry!"
person.helloWithGreeting("Servus");      // prints "Servus Dmitry!"

@JsNameアノテーションを指定しなかった場合、対応する関数の名前には、関数シグネチャから計算されたサフィックスが含まれます。例えばhello_61zpoeのようになります。

Kotlinコンパイラがマングリングを適用しない場合があることに注意してください。

  • external宣言はマングリングされません。
  • externalクラスから継承した非externalクラス内のオーバーライドされた関数はマングリングされません。

@JsNameのパラメーターは、有効な識別子である定数文字列リテラルである必要があります。コンパイラは、有効な識別子ではない文字列を@JsNameに渡そうとするとエラーを報告します。次の例はコンパイル時エラーを生成します。

kotlin
@JsName("new C()")   // error here
external fun newC()

@JsExportアノテーション ​

この機能は実験的です。 その設計は将来のバージョンで変更される可能性があります。

トップレベル宣言（クラスや関数など）に@JsExportアノテーションを適用することで、Kotlin宣言をJavaScriptから利用可能にします。このアノテーションは、Kotlinで指定された名前でネストされたすべての宣言をエクスポートします。@file:JsExportを使用してファイルレベルで適用することもできます。

エクスポートにおける曖昧さを解消するために（同名の関数のオーバーロードなど）、@JsExportアノテーションを@JsNameと組み合わせて使用し、生成およびエクスポートされる関数の名前を指定できます。

現在のIRコンパイラバックエンドでは、@JsExportアノテーションは関数をKotlinから可視にする唯一の方法です。

マルチプラットフォームプロジェクトでは、@JsExportは共通コードでも利用可能です。これはJavaScriptターゲット向けにコンパイルする場合にのみ効果があり、プラットフォーム固有ではないKotlin宣言もエクスポートできます。

@JsStatic ​

この機能は実験的です。いつでも廃止または変更される可能性があります。 評価目的でのみ使用してください。これに関するフィードバックをYouTrackにていただけると幸いです。

@JsStaticアノテーションは、ターゲット宣言に対して追加の静的メソッドを生成するようにコンパイラに指示します。これは、Kotlinコードの静的メンバーをJavaScriptで直接使用するのに役立ちます。

@JsStaticアノテーションは、名前付きオブジェクトで定義された関数、およびクラスやインターフェース内に宣言されたコンパニオンオブジェクトに適用できます。このアノテーションを使用すると、コンパイラはオブジェクトの静的メソッドと、オブジェクト自体のインスタンスメソッドの両方を生成します。例:

kotlin
// Kotlin
class C {
    companion object {
        @JsStatic
        fun callStatic() {}
        fun callNonStatic() {}
    }
}

ここで、callStatic()関数はJavaScriptでは静的ですが、callNonStatic()関数はそうではありません。

javascript
// JavaScript
C.callStatic();              // Works, accessing the static function
C.callNonStatic();           // Error, not a static function in the generated JavaScript
C.Companion.callStatic();    // Instance method remains
C.Companion.callNonStatic(); // The only way it works

オブジェクトまたはコンパニオンオブジェクトのプロパティに@JsStaticアノテーションを適用することも可能です。これにより、そのオブジェクト、またはコンパニオンオブジェクトを含むクラスにおいて、そのゲッターおよびセッターメソッドを静的メンバーにします。

JavaScriptにおけるKotlinの型 ​

Kotlinの型がJavaScriptの型にどのようにマッピングされるかを参照してください。

KotlinJavaScriptコメント
Byte, Short, Int, Float, DoubleNumber
CharNumber数値は文字コードを表します。
LongNot supportedJavaScriptには64ビット整数型がないため、Kotlinクラスによってエミュレートされます。
BooleanBoolean
StringString
ArrayArray
ByteArrayInt8Array
ShortArrayInt16Array
IntArrayInt32Array
CharArrayUInt16Array$type$ == "CharArray"プロパティを持ちます。
FloatArrayFloat32Array
DoubleArrayFloat64Array
LongArrayArray<kotlin.Long>$type$ == "LongArray"プロパティを持ちます。KotlinのLong型に関するコメントも参照してください。
BooleanArrayInt8Array$type$ == "BooleanArray"プロパティを持ちます。
List, MutableListKtList, KtMutableListKtList.asJsReadonlyArrayViewまたはKtMutableList.asJsArrayViewを介してArrayを公開します。
Map, MutableMapKtMap, KtMutableMapKtMap.asJsReadonlyMapViewまたはKtMutableMap.asJsMapViewを介してES2015のMapを公開します。
Set, MutableSetKtSet, KtMutableSetKtSet.asJsReadonlySetViewまたはKtMutableSet.asJsSetViewを介してES2015のSetを公開します。
UnitUndefined戻り値の型として使用する場合はエクスポート可能ですが、パラメーターの型として使用する場合はエクスポートできません。
AnyObject
ThrowableError
enum class TypeType列挙型エントリは静的クラスプロパティ（Type.ENTRY）として公開されます。
Nullable Type?`Typenull
All other Kotlin types, except for those marked with @JsExportNot supportedKotlinの符号なし整数型が含まれます。

さらに、次の点を知っておくことが重要です。

  • Kotlinはkotlin.Int、kotlin.Byte、kotlin.Short、kotlin.Char、kotlin.Longのオーバーフローセマンティクスを保持します。

  • Kotlinは実行時に数値型を区別できません（kotlin.Longを除く）。そのため、次のコードが機能します。

    kotlin
    fun f() {
    val x: Int = 23
    val y: Any = x
    println(y as Float)
}

  • KotlinはJavaScriptで遅延オブジェクト初期化を保持します。

  • KotlinはJavaScriptでトップレベルプロパティの遅延初期化を実装しません。

Copyright © 2025 Open AIDoc.