<init>

JsExternalArgument()

При размещении на параметре функции, требует, чтобы тип передаваемого аргумента был внешним.

Компилятор изменяет идентификаторы свойств из не-внешних интерфейсов и классов, но не изменяет их из внешних. Требование, чтобы тип передаваемого аргумента был внешним, необходимо для предотвращения неочевидных ошибок, когда идентификатор имеет неустойчивое и непредсказуемое имя в сгенерированном коде JS.

Пример:

@OptIn(ExperimentalStdlibApi::class)
fun extractUuid(@JsExternalArgument x: dynamic) = x.uuid as String

external interface User {
    val uuid: String
}

interface Owner {
    val uuid: String
}

fun checkUser(user: User, owner: Owner): Boolean {
    val userUuid = extractUuid(user) // OK
    val ownerUuid = extractUuid(owner) // Compilation error! Possible bug
    return userUuid == ownerUuid
}

Эта аннотация экспериментальная, что означает, что упомянутые выше ограничения могут быть изменены.