Kotlin JsName用法及代碼示例

@Target([AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY, AnnotationTarget.CONSTRUCTOR, AnnotationTarget.PROPERTY_GETTER, AnnotationTarget.PROPERTY_SETTER]) annotation class JsName

常見的

在 JavaScript 中給出聲明(函數、屬性或類)的特定名稱。

對於 JS

在 JavaScript 中給出聲明(函數、屬性或類)的特定名稱。

這在以下情況下可能很有用：

• JavaScript 中有兩個函數編譯器會給出相同的名稱，你可以用@JsName(...) 標記其中一個函數，以防止編譯器報錯。
• 你正在用 Kotlin 編寫一個 JavaScript 庫。編譯器會為帶有參數的函數生成混亂的名稱，這對於普通的 JavaScript 開發人員來說是不自然的。您可以將@JsName(...) 放在希望從 JavaScript 中獲得的函數上。
• 出於某種原因，您想重命名聲明，例如聲明提供的概念在 JavaScript 中有一個通用術語，這在 Kotlin 中並不常見。

例子：

class Person(val name: String) {
    fun hello() {
        println("Hello $name!")
    }

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