kobweb-core/com.varabyte.kobweb.browser/ApiFetcher/tryPost

tryPost

suspend fun <T> tryPost(apiPath: String, body: RequestBody? = null, headers: Map<String, Any>? = FetchDefaults.Headers, redirect: RequestRedirect? = FetchDefaults.Redirect, abortController: AbortController? = null, transform: suspend Response.() -> T): T?(source)

Like post, but returns null instead of throwing if the request fails.

This method also provides a transform step which you can use to convert the response into a different type. You are generally encouraged to call tryPost(...) { convert() } over tryPost(...)?.convert() as the former ill ensure that exception handling is covered in that case.

Additionally, if logOnError is set to true, any failure will be logged to the console (including the logic in the transform block).

If you do not care about converting the result, use the tryPost version that returns Response? instead.

Note: you should NOT prepend your path with "api/", as that will be added automatically.

suspend fun tryPost(apiPath: String, body: RequestBody? = null, headers: Map<String, Any>? = FetchDefaults.Headers, redirect: RequestRedirect? = FetchDefaults.Redirect, abortController: AbortController? = null): Response?(source)

Like post, but returns null if the request fails.

Additionally, if logOnError is set to true, any failure will be logged to the console. By default, this will be true for debug builds and false for release builds.

If you plan to do additional operations on the response and would also like to have logging / exception protection for them, consider using the other tryPost call which lets you pass in a transform callback. You are generally encouraged to call tryPost(...) { convert() } over tryPost(...)?.convert().

Note: you should NOT prepend your path with "api/", as that will be added automatically.