cdp/dev.kdriver.cdp.domain/Profiler

Profiler

Constructors

constructor(cdp: CDP)

Types

@Serializable

data class ConsoleProfileFinishedParameter(val id: String, val location: Debugger.Location, val profile: Profiler.Profile, val title: String? = null)

ConsoleProfileStartedParameter

@Serializable

data class ConsoleProfileStartedParameter(val id: String, val location: Debugger.Location, val title: String? = null)

Sent when new profile recording is started using console.profile() call.

CoverageRange

@Serializable

data class CoverageRange(val startOffset: Int, val endOffset: Int, val count: Int)

Coverage data for a source range.

FunctionCoverage

@Serializable

data class FunctionCoverage(val functionName: String, val ranges: List<Profiler.CoverageRange>, val isBlockCoverage: Boolean)

Coverage data for a JavaScript function.

GetBestEffortCoverageReturn

@Serializable

data class GetBestEffortCoverageReturn(val result: List<Profiler.ScriptCoverage>)

PositionTickInfo

@Serializable

data class PositionTickInfo(val line: Int, val ticks: Int)

Specifies a number of samples attributed to a certain source position.

PreciseCoverageDeltaUpdateParameter

@Serializable

data class PreciseCoverageDeltaUpdateParameter(val timestamp: Double, val occasion: String, val result: List<Profiler.ScriptCoverage>)

Reports coverage delta since the last poll (either from an event like this, or from takePreciseCoverage for the current isolate. May only be sent if precise code coverage has been started. This event can be trigged by the embedder to, for example, trigger collection of coverage data immediately at a certain point in time.

Profile

@Serializable

data class Profile(val nodes: List<Profiler.ProfileNode>, val startTime: Double, val endTime: Double, val samples: List<Int>? = null, val timeDeltas: List<Int>? = null)

Profile.

ProfileNode

@Serializable

data class ProfileNode(val id: Int, val callFrame: Runtime.CallFrame, val hitCount: Int? = null, val children: List<Int>? = null, val deoptReason: String? = null, val positionTicks: List<Profiler.PositionTickInfo>? = null)

Profile node. Holds callsite information, execution statistics and child nodes.

ScriptCoverage

@Serializable

data class ScriptCoverage(val scriptId: String, val url: String, val functions: List<Profiler.FunctionCoverage>)

Coverage data for a JavaScript script.

SetSamplingIntervalParameter

@Serializable

data class SetSamplingIntervalParameter(val interval: Int)

StartPreciseCoverageParameter

@Serializable

data class StartPreciseCoverageParameter(val callCount: Boolean? = null, val detailed: Boolean? = null, val allowTriggeredUpdates: Boolean? = null)

StartPreciseCoverageReturn

@Serializable

data class StartPreciseCoverageReturn(val timestamp: Double)

StopReturn

@Serializable

data class StopReturn(val profile: Profiler.Profile)

TakePreciseCoverageReturn

@Serializable

data class TakePreciseCoverageReturn(val result: List<Profiler.ScriptCoverage>, val timestamp: Double)

Properties

consoleProfileFinished

val consoleProfileFinished: Flow<Profiler.ConsoleProfileFinishedParameter>

consoleProfileStarted

val consoleProfileStarted: Flow<Profiler.ConsoleProfileStartedParameter>

Sent when new profile recording is started using console.profile() call.

preciseCoverageDeltaUpdate

val preciseCoverageDeltaUpdate: Flow<Profiler.PreciseCoverageDeltaUpdateParameter>

Functions

disable

suspend fun disable(mode: CommandMode = CommandMode.DEFAULT)

enable

suspend fun enable(mode: CommandMode = CommandMode.DEFAULT)

getBestEffortCoverage

suspend fun getBestEffortCoverage(mode: CommandMode = CommandMode.DEFAULT): Profiler.GetBestEffortCoverageReturn

Collect coverage data for the current isolate. The coverage data may be incomplete due to garbage collection.

setSamplingInterval

suspend fun setSamplingInterval(interval: Int)

suspend fun setSamplingInterval(args: Profiler.SetSamplingIntervalParameter, mode: CommandMode = CommandMode.DEFAULT)

Changes CPU profiler sampling interval. Must be called before CPU profiles recording started.

start

suspend fun start(mode: CommandMode = CommandMode.DEFAULT)

startPreciseCoverage

suspend fun startPreciseCoverage(args: Profiler.StartPreciseCoverageParameter, mode: CommandMode = CommandMode.DEFAULT): Profiler.StartPreciseCoverageReturn

suspend fun startPreciseCoverage(callCount: Boolean? = null, detailed: Boolean? = null, allowTriggeredUpdates: Boolean? = null): Profiler.StartPreciseCoverageReturn

Enable precise code coverage. Coverage data for JavaScript executed before enabling precise code coverage may be incomplete. Enabling prevents running optimized code and resets execution counters.

stop

suspend fun stop(mode: CommandMode = CommandMode.DEFAULT): Profiler.StopReturn

stopPreciseCoverage

suspend fun stopPreciseCoverage(mode: CommandMode = CommandMode.DEFAULT)

Disable precise code coverage. Disabling releases unnecessary execution count records and allows executing optimized code.

takePreciseCoverage

suspend fun takePreciseCoverage(mode: CommandMode = CommandMode.DEFAULT): Profiler.TakePreciseCoverageReturn

Collect coverage data for the current isolate, and resets execution counters. Precise code coverage needs to have started.