description |
---|
API Reference - Test Results |
This API resource allows to query test results based on its signature.
{% hint style="info" %} Learn how to retrieve before using this resource test-signature.md {% endhint %}
The unique signature of the test, see test-signature.md.
Date start - the test results included within the date range will be included.
Date end - the test results included within the date range will be included.
Pagination cursor, see pagination.md.
Pagination cursor.
Pagination cursor.
Pagination limit
1-100.
Default:10
Git branches filter. To provide multiple values, use
branch[]=valueA&branch[]=valueB
Tags filter. To provide multiple values, use
branch[]=valueA&branch[]=valueB
Git authors filter. To provide multiple values, use
git_author[]=valueA&git_author[]=valueB
Group filter. To provide multiple values, use
group[]=valueA&group[]=valueB
Test status filter. To provide multiple values, use
status
[]=failed&status[]=passed
{% tabs %} {% tab title="200: OK Successful Response" %}
{
"status": "OK",
"has_more": false,
"data": [
{
"cursor": "67b8dac9413406575084b5b0",
"signature": "a298aed2635166ffd75a5a88d29aaba4",
"framework": {
"clientVersion": "1.9.0",
"type": "pw",
"version": "1.49.0"
},
"createdAt": "2025-02-21T19:57:41.437Z",
"projectId": "C3lBM6",
"groupId": "Project A",
"runId": "1aadb82f23eec93c",
"instanceId": "Kw9tznsG3FUqMkGX",
"spec": "1-failing.spec.ts",
"machineId": "Iod3wzFiqQUF",
"tags": ["basic"],
"title": ["basic test @basic"],
"testId": "57ab34a754efae6a0981-782e8b09a9c1dd694d18",
"displayError": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m",
"commit": {
"branch": "test-staging-pr",
"authorEmail": "author@email.com",
"authorName": "John Smith",
"sha": "768c70d1946661182e5029c35169405e9c0c0473",
"message": "Testing staging PR"
},
"duration": 18658,
"flaky": false,
"expectedStatus": "passed",
"status": "failed",
"attempts": [
{
"attemptId": "xUFASNJTFZ0B79Pt-0",
"state": "failed",
"error": {
"message": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m",
"stack": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m\n\n at /Users/agoldis/playwright-gh-actions-demo/basic/1-failing.spec.ts:13:26",
"location": {
"line": 13,
"column": 26,
"file": "/Users/agoldis/playwright-gh-actions-demo/basic/1-failing.spec.ts"
}
},
"startedAt": "2025-02-21T19:57:41.437Z",
"duration": 6482
},
{
"attemptId": "xUFASNJTFZ0B79Pt-1",
"state": "failed",
"error": {
"message": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m",
"stack": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m\n\n at /Users/agoldis/playwright-gh-actions-demo/basic/1-failing.spec.ts:13:26",
"location": {
"line": 13,
"column": 26,
"file": "/Users/agoldis/playwright-gh-actions-demo/basic/1-failing.spec.ts"
}
},
"startedAt": "2025-02-21T19:57:48.278Z",
"duration": 5760
},
{
"attemptId": "xUFASNJTFZ0B79Pt-2",
"state": "failed",
"error": {
"message": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m",
"stack": "Error: �[31mTimed out 5000ms waiting for �[39m�[2mexpect(�[22m�[31mlocator�[39m�[2m).�[22mtoHaveText�[2m(�[22m�[32mexpected�[39m�[2m)�[22m\n\nLocator: locator('.todo-list')\nExpected string: �[32m\"Learn �[7mPlaywrigh�[27mt\"�[39m\nReceived string: �[31m\"Learn �[7mJavaScrip�[27mt\"�[39m\nCall log:\n�[2m - expect.toHaveText with timeout 5000ms�[22m\n�[2m - waiting for locator('.todo-list')�[22m\n�[2m 9 × locator resolved to <ul class=\"todo-list\">…</ul>�[22m\n�[2m - unexpected value \"Learn JavaScript\"�[22m\n\n at /Users/agoldis/playwright-gh-actions-demo/basic/1-failing.spec.ts:13:26",
"location": {
"line": 13,
"column": 26,
"file": "/Users/agoldis/playwright-gh-actions-demo/basic/1-failing.spec.ts"
}
},
"startedAt": "2025-02-21T19:57:54.406Z",
"duration": 5689
}
]
}
]
}
{% endtab %}
{% tab title="400: FAILED Bad Request " %}
type ResponsePayload = {
status: "FAILED";
error: string;
};
{% endtab %} {% endtabs %}
Name | Type | Description |
---|---|---|
cursor |
String |
Used for pagination. See pagination.md |
projectId |
String |
ID of the project of the test. projects |
groupId |
String |
ID of the group which the current test belongs to. |
runId |
String |
ID of the run which the current test belongs to. runs |
instanceId |
String |
ID of the instance which the current test belongs to. instances.md |
spec |
String |
Name of the spec file which the test belongs to. spec-files.md |
machineId |
String |
ID of the machine which executed the test. |
signature |
String |
Signature of the test test-signature.md |
title |
Array<String> |
Title of the test. See test title. |
testId |
String |
ID of the test as reporter by its framework. |
expectedStatus |
String<failed | passed | pending | skipped> |
Spected status of the test. Only available for Playwright. |
status |
String<failed | passed | pending | skipped> |
Final status of the test after the execution |
framework |
Framework |
Information about the framework and reporter used for the test execution #framework |
displayError |
String |
Latest error from the test execution |
commit |
Commit |
Git commit information #commit |
createdAt |
String (ISO Datetime) |
Date of the test execution |
duration |
Number |
Total duration of the test execution in milliseconds |
flaky |
Boolean |
Property that shows if the test is marked as flaky flaky-tests.md |
attempts |
Array<Attempt> |
List of test execution attempts #attempt |
annotations |
Array<Annotation> |
List of test annotations #annotation |
Name | Type | Description |
---|---|---|
branch |
String |
Git Commit Branch of the recorded result |
authorEmail |
String |
Git Commit Author Email of the recorded result |
authorName |
String |
Git Commit Author Name of the recorded result |
sha |
String |
Git Commit SHA of the recorded result |
message |
String |
Git Commit Message of the recorded result |
Name | Type | Description |
---|---|---|
clientVersion |
String |
Version of the reporter used in the test execution |
type |
Enum |
Type of the test execution framework |
version |
String |
Version of the testing framework |
Name | Type | Description |
---|---|---|
type |
String |
Type of the annotation |
description |
String |
Description of the annotation |
Name | Type | Description |
---|---|---|
attemptId |
String |
ID of the attempt |
state |
Enum<failed | passed | pending | skipped> |
Status of the attempt |
startedAt |
String (ISO Datetime) |
Start date of the attempt |
duration |
Number |
Total duration of the attempt in milliseconds |
error |
Error |
Error object of the attempt in case of failure #error |
Name | Type | Description |
---|---|---|
message |
String |
Description of the error |
stack |
String |
More detailed description of the error |
location |
Location |
Specific code location where the error happened #location |
Name | Type | Description |
---|---|---|
line |
Number |
Code line where an error occurred |
column |
Number |
Code column where an error occurred |
file |
String |
File path where an error occurred |