cef_trace.h File Reference

#include "include/cef_base.h"
#include "include/cef_callback.h"

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.