Использование кода JavaScript в Kotlin

Объявление (статических) членов класса

В JavaScript можно определять члены либо в прототипе, либо непосредственно в самом классе:

function MyClass() { ... }
MyClass.sharedMember = function() { /* implementation */ };
MyClass.prototype.ownMember = function() { /* implementation */ };

В Kotlin такого синтаксиса нет. Однако в Kotlin есть объекты companion. Kotlin особым образом обрабатывает объекты-компаньоны классов external: вместо того чтобы ожидать объект, он рассматривает члены объектов-компаньонов как члены самого класса. MyClass из примера выше можно описать так:

external class MyClass {
    companion object {
        fun sharedMember()
    }

    fun ownMember()
}

Объявление параметров со значениями по умолчанию

Если вы пишете внешнее объявление для функции JavaScript с параметром, имеющим значение по умолчанию, используйте definedExternally. Это позволяет передать вычисление значений по умолчанию самой функции JavaScript:

external fun myFunWithOptionalArgs(
    x: Int,
    y: String = definedExternally,
    z: String = definedExternally
)

С таким внешним объявлением можно вызывать myFunWithOptionalArgs с одним обязательным и двумя необязательными аргументами. Значения по умолчанию будут вычислены реализацией myFunWithOptionalArgs на JavaScript.

Наследование от классов JavaScript

Вы можете с лёгкостью наследоваться от классов JavaScript так же, как от классов Kotlin. Просто объявите класс external open и унаследуйте от него класс, не являющийся external. Например:

open external class Foo {
    open fun run()
    fun stop()
}

class Bar : Foo() {
    override fun run() {
        window.alert("Running!")
    }

    fun restart() {
        window.alert("Restarting")
    }
}

Есть несколько ограничений:

• Если функция внешнего базового класса перегружена по сигнатуре, переопределить её в производном классе нельзя.

• Нельзя переопределять функцию, содержащую параметры со значениями по умолчанию.

• От внешних классов нельзя наследоваться в невнешних классах.

Внешние интерфейсы

В JavaScript нет понятия интерфейсов. Если функция ожидает, что её параметр поддерживает два метода foo и bar, достаточно передать объект, у которого действительно есть эти методы.

В статически типизированном Kotlin это понятие можно выразить с помощью интерфейсов:

external interface HasFooAndBar {
    fun foo()

    fun bar()
}

external fun myFunction(p: HasFooAndBar)

Типичный вариант использования внешних интерфейсов — описание объектов настроек. Например:

external interface JQueryAjaxSettings {
    var async: Boolean

    var cache: Boolean

    var complete: (JQueryXHR, String) -> Unit

    // etc
}

fun JQueryAjaxSettings(): JQueryAjaxSettings = js("{}")

external class JQuery {
    companion object {
        fun get(settings: JQueryAjaxSettings): JQueryXHR
    }
}

fun sendQuery() {
    JQuery.get(JQueryAjaxSettings().apply {
        complete = { (xhr, data) ->
            window.alert("Request complete")
        }
    })
}

У внешних интерфейсов есть несколько ограничений:

• Их нельзя использовать в правой части проверок is.

• Их нельзя передавать в качестве аргументов reified-типа.

• Их нельзя использовать в выражениях с литералом класса (например, I::class).

• Приведения as к внешним интерфейсам всегда завершаются успешно. При приведении к внешним интерфейсам во время компиляции выводится предупреждение «Unchecked cast to external interface» (непроверяемое приведение к внешнему интерфейсу). Это предупреждение можно подавить с помощью аннотации @Suppress("UNCHECKED_CAST_TO_EXTERNAL_INTERFACE").

  IntelliJ IDEA также может автоматически сгенерировать аннотацию @Suppress. Откройте меню намерений с помощью значка лампочки или сочетания Alt-Enter и нажмите маленькую стрелку рядом с проверкой «Unchecked cast to external interface». Здесь можно выбрать область подавления, и IDE соответствующим образом добавит аннотацию в файл.

Приведения типов

Помимо «небезопасного» оператора приведения типов as, который выбрасывает ClassCastException, если приведение невозможно, Kotlin/JS также предоставляет unsafeCast<T>(). При использовании unsafeCast во время выполнения вообще не выполняется проверка типов. Например, рассмотрим следующие два метода:

fun usingUnsafeCast(s: Any) = s.unsafeCast<String>()
fun usingAsOperator(s: Any) = s as String

Они будут скомпилированы следующим образом:

function usingUnsafeCast(s) {
    return s;
}

function usingAsOperator(s) {
    var tmp$;
    return typeof (tmp$ = s) === 'string' ? tmp$ : throwCCE();
}