ApexTestResult

Represents the result of an Apex test method execution. Available from API version 30.0 or later.

Supported SOAP API Calls

create(), delete(), describeSObjects(), query(), retrieve(), update()

Supported REST API HTTP Methods

Query, GET

Fields

Field Name Details
ApexClassId
Type
reference
Properties
Create, Filter, Group, Sort, Update
Description

The Apex class whose test methods were executed.

ApexLogId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description

Points to the ApexLog for this test method execution if debug logging is enabled; otherwise, null.

ApexTestRunResultId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description

The ID of the ApexTestRunResult that represents the entire test run.

AsyncApexJobId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description

Points to the AsyncApexJob that represents the entire test run.

This field points to the same object as ApexTestQueueItem.ParentJobId.

IsTestSetup
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description

Indicates if the results are for a test setup method. The default is false.

Message
Type
string
Properties
Create, Filter, Nillable, Sort, Update
Description

The exception error message if a test failure occurs; otherwise, null.

MethodName
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description

The name of the test method.

Outcome
Type
picklist
Properties
Create, Filter, Group, Restricted picklist, Sort, Update
Description
The result of the test. Valid values are:
  • Pass
  • Fail
  • CompileFail
  • Skip
QueueItemId
Type
reference
Properties
Create, Filter, Group, Nillable, Sort, Update
Description

Points to the ApexTestQueueItem which is the class that this test method is part of.

RunTime
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description

The time it took the test method to run, in seconds.

StackTrace
Type
string
Properties
Create, Filter, Nillable, Sort, Update
Description

The Apex stack trace if the test failed; otherwise, null.

TestTimestamp
Type
dateTime
Properties
Create, Filter, Sort, Update
Description

The start time of the test method.

Usage

You can query the fields of the ApexTestResult record that corresponds to a test method executed as part of an Apex class execution.

Each test method execution is represented by a single ApexTestResult record. For example, if an Apex test class contains six test methods, six ApexTestResult records are created. These records are in addition to the ApexTestQueueItem record that represents the Apex class.

Each ApexTestResult record has an associated ApexTestResultLimits record, which captures the Apex limits used during execution of the test method.

For example code, see ApexTestQueueItem.