TestComplete can access web pages in applications based on the Chromium Embedded Framework (CEF). Before you can test CEF applications, you need to prepare your TestComplete project or tested application.
Instrument CEF Application
TestComplete can automatically expose elements in CEF-based applications. To enable this, add your application to the Tested Applications collection and launch it in Simple run mode while one of the following conditions is met:
- The application’s executable imports the libcef.dll library.
— or —
- The libcef.dll library and the application’s executable are located in the same folder.
— or —
- The application has the
injectCefHookcommand-line argument (in any letter case and with any prefix).
This is the recommended way to work with CEF-based applications.
Support for CEF Applications Launched by Using the ClickOnce Technology
To recognize objects of such applications, support for these applications must be enabled. To do this, enable the Allow TestComplete to interact with embedded Chromium content option specified for the tested application in the TestedApps editor.
To enable support from a test, you can use the
Disable Windows (Off-Screen) Rendering
A CEF application can use windowed or windowless (off-screen) rendering. TestComplete supports CEF applications that use windowed rendering. Windowless (off-screen) rendering mode is supported only for WPF components of the CefSharp framework. Other applications that use windowless rendering are not supported. If your application uses windowless rendering, you need to disable it for testing purposes.
The way you disable windowless rendering depends on the programming language and framework used. Refer to the documentation of your CEF framework for details.
Verify CEF Support
Start your tested application (for example, from TestedApps) and switch to the Object Browser. You should see the Page object in your application. You can use it to automate web pages and web page elements in the application’s embedded web browser.