Client Plugin

User Agent

UserAgent 外掛程式可將 User-Agent 標頭新增至所有 請求。

新增相依性

UserAgent 僅需要 ktor-client-core 構件，不需要任何特定的相依性。

安裝與配置 UserAgent

要安裝 UserAgent，請將其傳遞至 用戶端配置區塊 內的 install 函式。接著，使用 agent 屬性來指定 User-Agent 值：

import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.plugins.*
// ...
val client = HttpClient(CIO) {
    install(UserAgent) {
        agent = "Ktor client"
    }
}

Ktor 也允許您使用對應的函式來新增類瀏覽器或類 curl 的 User-Agent 值：

val client = HttpClient(CIO) {
    BrowserUserAgent()
    // ... 或
    CurlUserAgent()
}