Chromium Embedded Framework (CEF)  126.2.0+g5c56e98+chromium-126.0.6478.62
cef_trace.h File Reference

Classes

class  CefEndTracingCallback
 Implement this interface to receive notification when tracing has completed. More...
 

Functions

bool CefBeginTracing (const CefString &categories, CefRefPtr< CefCompletionCallback > callback)
 Start tracing events on all processes. More...
 
bool CefEndTracing (const CefString &tracing_file, CefRefPtr< CefEndTracingCallback > callback)
 Stop tracing events on all processes. More...
 
int64_t CefNowFromSystemTraceTime ()
 Returns the current system trace time or, if none is defined, the current high-res time. More...
 

Function Documentation

◆ CefBeginTracing()

bool CefBeginTracing ( const CefString categories,
CefRefPtr< CefCompletionCallback callback 
)

Start tracing events on all processes.

Tracing is initialized asynchronously and |callback| will be executed on the UI thread after initialization is complete.

If CefBeginTracing was called previously, or if a CefEndTracingAsync call is pending, CefBeginTracing will fail and return false.

|categories| is a comma-delimited list of category wildcards. A category can have an optional '-' prefix to make it an excluded category. Having both included and excluded categories in the same list is not supported.

Examples:

  • "test_MyTest*"
  • "test_MyTest*,test_OtherStuff"
  • "-excluded_category1,-excluded_category2"

This function must be called on the browser process UI thread.

◆ CefEndTracing()

bool CefEndTracing ( const CefString tracing_file,
CefRefPtr< CefEndTracingCallback callback 
)

Stop tracing events on all processes.

This function will fail and return false if a previous call to CefEndTracingAsync is already pending or if CefBeginTracing was not called.

|tracing_file| is the path at which tracing data will be written and |callback| is the callback that will be executed once all processes have sent their trace data. If |tracing_file| is empty a new temporary file path will be used. If |callback| is empty no trace data will be written.

This function must be called on the browser process UI thread.

◆ CefNowFromSystemTraceTime()

int64_t CefNowFromSystemTraceTime ( )

Returns the current system trace time or, if none is defined, the current high-res time.

Can be used by clients to synchronize with the time information in trace events.