npm 종속성 사용

Kotlin/JS 프로젝트에서는 모든 종속성을 Gradle 플러그인을 통해 관리할 수 있습니다. 여기에는 kotlinx.coroutines, kotlinx.serialization, ktor-client와 같은 Kotlin/멀티플랫폼 라이브러리가 포함됩니다.

npm의 JavaScript 패키지에 의존하기 위해 Gradle DSL은 가져오려는 패키지를 지정할 수 있는 npm 함수를 노출합니다. is-sorted라는 NPM 패키지를 가져오는 것을 고려해 봅시다.

Gradle 빌드 파일의 해당 부분은 다음과 같습니다.

dependencies {
    // ...
    implementation(npm("is-sorted", "1.0.5"))
}

JavaScript 모듈은 일반적으로 동적으로 타입이 지정되며 Kotlin은 정적으로 타입이 지정되는 언어이므로, 일종의 어댑터를 제공해야 합니다. Kotlin에서는 이러한 어댑터를 _외부 선언 (external declarations)_이라고 합니다. 하나의 함수만 제공하는 is-sorted 패키지의 경우, 이 선언은 작성하기 간단합니다. 소스 폴더 내부에 is-sorted.kt라는 새 파일을 생성하고 다음 내용으로 채웁니다.

@JsModule("is-sorted")
@JsNonModule
external fun <T> sorted(a: Array<T>): Boolean

CommonJS를 대상으로 사용하는 경우 @JsModule 및 @JsNonModule 어노테이션은 그에 따라 조정되어야 한다는 점에 유의하십시오.

이 JavaScript 함수는 이제 일반 Kotlin 함수처럼 사용될 수 있습니다. 헤더 파일에 타입 정보를 제공했기 때문에 (단순히 매개변수와 반환 타입을 dynamic으로 정의하는 것과 달리), 적절한 컴파일러 지원과 타입 검사도 사용할 수 있습니다.

console.log("Hello, Kotlin/JS!")
console.log(sorted(arrayOf(1,2,3)))
console.log(sorted(arrayOf(3,1,2)))

브라우저나 Node.js 중 하나에서 이 세 줄을 실행하면, sorted 호출이 is-sorted 패키지에서 내보낸 함수에 제대로 매핑되었음을 출력이 보여줍니다.

Hello, Kotlin/JS!
true
false

JavaScript 생태계는 패키지에서 함수를 노출하는 여러 가지 방법(예를 들어, 명명된 내보내기 또는 기본 내보내기를 통해)을 가지고 있기 때문에, 다른 npm 패키지는 해당 외부 선언에 대해 약간 변경된 구조가 필요할 수 있습니다.

선언을 작성하는 방법에 대해 더 자세히 알아보려면 Kotlin에서 JavaScript 호출하기를 참조하십시오.