application/com.varabyte.kobweb.gradle.application.extensions/AppBlock/ExportBlock/enableTraces

enableTraces

fun enableTraces(tracesRoot: Path = kobwebFolder.path.resolve("export-traces"), filter: (String) -> Boolean = { true }, showScreenshots: Boolean = true)(source)

Enable traces for your export.

Traces are a feature provided by Playwright (the engine we use to download a browser and take export snapshots). Traces should rarely be required, but they can help you understand what's going on under the hood when an export takes significantly longer than you'd expect.

When enabled, a bunch of zip files will be saved under your specified trace path, which can be dragged / dropped into the Playwright Trace Viewer to get a breakdown of what's going on. This can be useful to do in combination with setting the server logs level to "TRACE" (and then checking .kobweb/server/logs/kobweb-server.log to get a deeper look into what's gone wrong.)

You can read more about traces in the official documentation.

See the docs for TraceConfig for more details about the parameters for this method. The tracesRoot location defaults to .kobweb/export-traces.

See also