Navigation
API > API/Plugins > API/Plugins/AutomationTestToolset > API/Plugins/AutomationTestToolset/UAutomationTestToolset
Description
Run automation tests selected by a filter expression. Requires DiscoverTests() to have completed. Much faster than RunTests when targeting a large batch because the engine narrows the report tree in a single pass instead of running a per-leaf membership check against the requested name list.
Filter syntax (multiple expressions joined by '+'): "StartsWith:System.Engine" prefix match against the full test path "^Foo" prefix anchor (equivalent to StartsWith:) "Bar$" suffix anchor "Substring" bare token matches anywhere in the path "Group:Smoke" expand a named group from AutomationControllerSettings ini Groups
Returns an async result that completes with the same JSON summary as RunTests.
| Name | RunTestsByFilter |
| Type | function |
| Header File | /Engine/Plugins/Experimental/Toolsets/AutomationTestToolset/Source/AutomationTestToolset/Public/AutomationTestToolset.h |
| Include Path | #include "AutomationTestToolset.h" |
| Source | /Engine/Plugins/Experimental/Toolsets/AutomationTestToolset/Source/AutomationTestToolset/Private/AutomationTestToolset.cpp |
UFUNCTION (Meta=(AICallable), Category="AutomationTestToolset")
static UToolCallAsyncResultString * RunTestsByFilter
(
const FString & FilterExpression
)
Parameters
| Name | Remarks |
|---|---|
| FilterExpression | Filter expression as described above. |