TestResultsRestClient class

Base class that should be used (derived from) to make requests to VSS REST apis

Extends

Constructors

TestResultsRestClient(IVssRestClientOptions)

Properties

RESOURCE_AREA_ID

Methods

addCustomFields(CustomTestFieldDefinition[], string)
addTestResultsToTestRun(TestCaseResult[], string, number)
addTestResultsToTestRunSession(TestCaseResult[], string, number)

Add Test Results to test run session

addWorkItemToTestLinks(WorkItemToTestLinks, string)
createBuildAttachmentInLogStore(TestAttachmentRequestModel, string, number)

Creates an attachment in the LogStore for the specified buildId.

createEnvironment(TestSessionEnvironment[], string)

Creates Environment object in TCM data store

createEnvironmentAndMachine(SessionEnvironmentAndMachine, string, number)

For the provided sessionId, creates environment, configuration, and machine objects in TCM data store

createFailureType(TestResultFailureTypeRequestModel, string)

Creates a new test failure type

createNotification(TestSessionNotification[], string, number)

Creates Notification object in TCM data store for a given session

createTestIterationResultAttachment(TestAttachmentRequestModel, string, number, number, number, string)
createTestResultAttachment(TestAttachmentRequestModel, string, number, number)
createTestRun(RunCreateModel, string)
createTestRunAttachment(TestAttachmentRequestModel, string, number)
createTestRunLogStoreAttachment(TestAttachmentRequestModel, string, number)

Creates an attachment in the LogStore for the specified runId.

createTestSession(TestResultsSession, string)

Creates TestResultsSession object in TCM data store

createTestSettings(TestSettings, string)
createTestSubResultAttachment(TestAttachmentRequestModel, string, number, number, number)
deleteCustomFieldById(string, number)
deleteFailureType(string, number)

Deletes a test failure type with specified failureTypeId

deleteTestMethodToWorkItemLink(string, string, number)
deleteTestResultAttachment(string, number, number, number)
deleteTestRun(string, number)
deleteTestRunAttachment(string, number, number)
deleteTestRunLogStoreAttachment(string, number, string)

Deletes the attachment with the specified filename for the specified runId from the LogStore.

deleteTestSettings(string, number)
fetchSourceCodeCoverageReport(string, number)
getBugsLinkedToTestResult(string, number, number)
getBuildCodeCoverage(string, number, number)
getCodeCoverageSummary(string, number, number)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10&deltaBuildId=9 Request: build id and delta build id (optional)

getCoverageStatusBadge(string, string, string, string)

<p>Gets the coverage status for the last successful build of a definition, optionally scoped to a specific branch</p>

getFailureTypes(string)

Returns the list of test failure types.

getFileLevelCodeCoverage(FileCoverageRequest, string)

Get file coverage for the specified file

getFlakyTestResultsByBuildDefinitionId(string, number, Date)
getFlakyTestResultsByTestRun(string, number)
getResultGroupsByBuild(string, number, string, string[], string)
getResultGroupsByRelease(string, number, string, number, string[], string)
getSessionNotifications(string, number)

Retrieves TestResultsSession Notification objects in TCM data store

getSimilarTestResults(string, number, number, number, number, String)

Gets the list of results whose failure matches with the provided one.

getTestIterationAttachmentContent(string, number, number, number, number)

Returns a test iteration attachment

getTestIterationAttachmentZip(string, number, number, number, number)

Returns a test iteration attachment

getTestLogsForBuild(string, number, TestLogType, string, string, boolean, number, String)

Get list of build attachments reference

getTestLogStoreEndpointDetailsForBuildLog(string, number, TestLogType, string)

Get SAS Uri of a build attachment

getTestLogStoreEndpointDetailsForResultLog(string, number, number, TestLogType, string)

Get SAS Uri of a test results attachment

getTestLogStoreEndpointDetailsForRunLog(string, number, TestLogType, string)

Get SAS Uri of a test run attachment

getTestLogStoreEndpointDetailsForSubResultLog(string, number, number, number, TestLogType, string)

Get SAS Uri of a test subresults attachment

getTestPipelineMetrics(string, number, string, string, string, Metrics[], boolean)

Get summary of test results.

getTestResultAttachmentContent(string, number, number, number)

Returns a test result attachment

getTestResultAttachments(string, number, number)
getTestResultAttachmentZip(string, number, number, number)

Returns a test result attachment

getTestResultById(string, number, number, ResultDetails)
getTestResultDetailsForBuild(string, number, string, string, string, string, boolean, boolean)
getTestResultDetailsForRelease(string, number, number, string, string, string, string, boolean, boolean)
getTestResultLogs(string, number, number, TestLogType, string, string, boolean, number, String)

Get list of test result attachments reference

getTestResults(string, number, ResultDetails, number, number, TestOutcome[], boolean)
getTestResultsByBuild(string, number, string, TestOutcome[], number, string)
getTestResultsByPipeline(string, number, string, string, string, TestOutcome[], number, String)

Get a list of results.

getTestResultsByQuery(TestResultsQuery, string)
getTestResultsByQueryWiql(QueryModel, string, boolean, boolean, number, number)
getTestResultsByRelease(string, number, number, string, TestOutcome[], number, string)
getTestResultsSettings(string, TestResultsSettingsType)

Get TestResultsSettings data

getTestResultWorkItemsById(string, number, number)
getTestRunAttachmentContent(string, number, number)

Returns a test run attachment

getTestRunAttachments(string, number)
getTestRunAttachmentZip(string, number, number)

Returns a test run attachment

getTestRunById(string, number, boolean, boolean)
getTestRunCodeCoverage(string, number, number)
getTestRunLogs(string, number, TestLogType, string, string, boolean, number, String)

Get list of test run attachments reference

getTestRunLogStoreAttachmentContent(string, number, string)

Returns the attachment with the specified filename for the specified runId from the LogStore.

getTestRunLogStoreAttachments(string, number)

Returns a list of attachments for the specified runId from the LogStore.

getTestRunLogStoreAttachmentZip(string, number, string)

Returns the attachment with the specified filename for the specified runId from the LogStore.

getTestRunMessageLogs(string, number)

Get test run message logs

getTestRuns(string, string, string, string, number, boolean, boolean, number, number)
getTestRunsBySessionId(string, number)

Retrieves Test runs associated to a session

getTestRunStatistics(string, number)

Get test run statistics , used when we want to get summary of a run by outcome.

getTestRunSummaryByOutcome(string, number)

Get test run summary, used when we want to get summary of a run by outcome. Test run should be in completed state.

getTestSession(string, number)

Retrieves TestResultsSession metadata object in TCM data store

getTestSessionLayout(string, string)

Retrieves TestResultsSession Layout object in TCM data store

getTestSessionLayoutBySessionId(string, number)

Retrieves TestResultsSession Layout object in TCM data store

getTestSessionResults(string, number, ResultDetails, number, number, TestOutcome[], boolean)
getTestSettingsById(string, number)
getTestSubResultAttachmentContent(string, number, number, number, number)

Returns a test sub result attachment

getTestSubResultAttachments(string, number, number, number)

Returns attachment references for test sub result.

getTestSubResultAttachmentZip(string, number, number, number, number)

Returns a test sub result attachment

getTestSubResultLogs(string, number, number, number, TestLogType, string, string, boolean, number, String)

Get list of test subresult attachments reference

getTestTagsForBuild(string, number)

Get all the tags in a build.

getTestTagsForRelease(string, number, number)

Get all the tags in a release.

getTestTagSummaryForBuild(string, number)

Get all the tags in a build.

getTestTagSummaryForRelease(string, number, number)

Get all the tags in a release.

publishTestResultDocument(TestResultDocument, string, number)
queryCustomFields(string, CustomTestFieldScope)
queryResultTrendForBuild(TestResultTrendFilter, string)
queryResultTrendForRelease(TestResultTrendFilter, string)
queryTestHistory(TestHistoryQuery, string)

Get history of a test method using TestHistoryQuery

queryTestMethodLinkedWorkItems(string, string)
queryTestResultHistory(ResultsFilter, string)
queryTestResultsMetaData(string[], string, ResultMetaDataDetails)

Get list of test Result meta data details for corresponding testcasereferenceId

queryTestResultsReportForBuild(string, number, string, boolean, BuildReference)
queryTestResultsReportForPipeline(string, number, string, string, string, boolean)

Get summary of test results.

queryTestResultsReportForRelease(string, number, number, string, boolean, ReleaseReference)
queryTestResultsSummaryForReleases(ReleaseReference[], string)
queryTestResultWorkItems(string, string, string, number, Date, number, number)

Query Test Result WorkItems based on filter

queryTestRuns(string, Date, Date, TestRunState, number[], boolean, TestRunPublishContext, number[], number[], string, number[], number[], number[], number[], string, number, string)

Query Test Runs based on filters. Mandatory fields are minLastUpdatedDate and maxLastUpdatedDate.

queryTestSummaryByRequirement(TestResultsContext, string, number[])
testLogStoreEndpointDetailsForBuild(string, number, TestLogStoreOperationType)

Create and Get sas uri of the build container

testLogStoreEndpointDetailsForResult(string, number, number, number, string, TestLogType)

Create empty file for a result and Get Sas uri for the file

testLogStoreEndpointDetailsForRun(string, number, TestLogStoreOperationType, string, TestLogType)

Create empty file for a run and Get Sas uri for the file

testResultsGroupDetails(string, number, string, string, string, boolean, boolean)

Get all the available groups details and for these groups get failed and aborted results.

updateCodeCoverageSummary(string, number, CodeCoverageData)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10 Request: Json of code coverage summary

updateCustomField(CustomTestFieldUpdateDefinition, string)
updatePipelinesTestSettings(TestResultsUpdateSettings, string)

Update project settings of test results

updateTestResults(TestCaseResult[], string, number)
updateTestResultsMetaData(TestResultMetaDataUpdateInput, string, number)

Update properties of test result meta data

updateTestResultsToTestRunSession(TestCaseResult[], string, number)

Creates TestResultsMRX objects in TCM data store for existing test results

updateTestRun(RunUpdateModel, string, number)
updateTestRunTags(TestTagsUpdateModel, string, number)

Update tags of a run, Tags can be Added and Deleted

Constructor Details

TestResultsRestClient(IVssRestClientOptions)

new TestResultsRestClient(options: IVssRestClientOptions)

Parameters

Property Details

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Property Value

string

Method Details

addCustomFields(CustomTestFieldDefinition[], string)

function addCustomFields(newFields: CustomTestFieldDefinition[], project: string): Promise<CustomTestFieldDefinition[]>

Parameters

project

string

Project ID or project name

Returns

addTestResultsToTestRun(TestCaseResult[], string, number)

function addTestResultsToTestRun(results: TestCaseResult[], project: string, runId: number): Promise<TestCaseResult[]>

Parameters

results

TestCaseResult[]

project

string

Project ID or project name

runId

number

Returns

Promise<TestCaseResult[]>

addTestResultsToTestRunSession(TestCaseResult[], string, number)

Add Test Results to test run session

function addTestResultsToTestRunSession(results: TestCaseResult[], project: string, runId: number): Promise<TestCaseResult[]>

Parameters

results

TestCaseResult[]

project

string

Project ID or project name

runId

number

RunId of test run

Returns

Promise<TestCaseResult[]>

function addWorkItemToTestLinks(workItemToTestLinks: WorkItemToTestLinks, project: string): Promise<WorkItemToTestLinks>

Parameters

workItemToTestLinks
WorkItemToTestLinks
project

string

Project ID or project name

Returns

createBuildAttachmentInLogStore(TestAttachmentRequestModel, string, number)

Creates an attachment in the LogStore for the specified buildId.

function createBuildAttachmentInLogStore(attachmentRequestModel: TestAttachmentRequestModel, project: string, buildId: number): Promise<void>

Parameters

attachmentRequestModel
TestAttachmentRequestModel

Contains attachment info like stream, filename, comment, attachmentType

project

string

Project ID or project name

buildId

number

BuildId

Returns

Promise<void>

createEnvironment(TestSessionEnvironment[], string)

Creates Environment object in TCM data store

function createEnvironment(environments: TestSessionEnvironment[], project: string): Promise<void>

Parameters

environments

TestSessionEnvironment[]

Received Environment object.

project

string

Project ID or project name

Returns

Promise<void>

createEnvironmentAndMachine(SessionEnvironmentAndMachine, string, number)

For the provided sessionId, creates environment, configuration, and machine objects in TCM data store

function createEnvironmentAndMachine(sessionEnvironmentAndMachine: SessionEnvironmentAndMachine, project: string, sessionId: number): Promise<void>

Parameters

sessionEnvironmentAndMachine
SessionEnvironmentAndMachine
project

string

Project ID or project name

sessionId

number

Returns

Promise<void>

createFailureType(TestResultFailureTypeRequestModel, string)

Creates a new test failure type

function createFailureType(testResultFailureType: TestResultFailureTypeRequestModel, project: string): Promise<TestResultFailureType>

Parameters

testResultFailureType
TestResultFailureTypeRequestModel
project

string

Project ID or project name

Returns

createNotification(TestSessionNotification[], string, number)

Creates Notification object in TCM data store for a given session

function createNotification(notifications: TestSessionNotification[], project: string, sessionId: number): Promise<number[]>

Parameters

notifications

TestSessionNotification[]

Notification(s) to add for the specified sessionId

project

string

Project ID or project name

sessionId

number

ID of Session to add Notification

Returns

Promise<number[]>

createTestIterationResultAttachment(TestAttachmentRequestModel, string, number, number, number, string)

function createTestIterationResultAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number, testCaseResultId: number, iterationId: number, actionPath?: string): Promise<TestAttachmentReference>

Parameters

attachmentRequestModel
TestAttachmentRequestModel
project

string

Project ID or project name

runId

number

testCaseResultId

number

iterationId

number

actionPath

string

Returns

createTestResultAttachment(TestAttachmentRequestModel, string, number, number)

function createTestResultAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number, testCaseResultId: number): Promise<TestAttachmentReference>

Parameters

attachmentRequestModel
TestAttachmentRequestModel
project

string

Project ID or project name

runId

number

testCaseResultId

number

Returns

createTestRun(RunCreateModel, string)

function createTestRun(testRun: RunCreateModel, project: string): Promise<TestRun>

Parameters

testRun
RunCreateModel
project

string

Project ID or project name

Returns

Promise<TestRun>

createTestRunAttachment(TestAttachmentRequestModel, string, number)

function createTestRunAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number): Promise<TestAttachmentReference>

Parameters

attachmentRequestModel
TestAttachmentRequestModel
project

string

Project ID or project name

runId

number

Returns

createTestRunLogStoreAttachment(TestAttachmentRequestModel, string, number)

Creates an attachment in the LogStore for the specified runId.

function createTestRunLogStoreAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number): Promise<TestLogStoreAttachmentReference>

Parameters

attachmentRequestModel
TestAttachmentRequestModel

Contains attachment info like stream, filename, comment, attachmentType

project

string

Project ID or project name

runId

number

Test RunId

Returns

createTestSession(TestResultsSession, string)

Creates TestResultsSession object in TCM data store

function createTestSession(session: TestResultsSession, project: string): Promise<number>

Parameters

session
TestResultsSession

Received session object.

project

string

Project ID or project name

Returns

Promise<number>

createTestSettings(TestSettings, string)

function createTestSettings(testSettings: TestSettings, project: string): Promise<number>

Parameters

testSettings
TestSettings
project

string

Project ID or project name

Returns

Promise<number>

createTestSubResultAttachment(TestAttachmentRequestModel, string, number, number, number)

function createTestSubResultAttachment(attachmentRequestModel: TestAttachmentRequestModel, project: string, runId: number, testCaseResultId: number, testSubResultId: number): Promise<TestAttachmentReference>

Parameters

attachmentRequestModel
TestAttachmentRequestModel
project

string

Project ID or project name

runId

number

testCaseResultId

number

testSubResultId

number

Returns

deleteCustomFieldById(string, number)

function deleteCustomFieldById(project: string, testExtensionFieldId: number): Promise<void>

Parameters

project

string

Project ID or project name

testExtensionFieldId

number

Returns

Promise<void>

deleteFailureType(string, number)

Deletes a test failure type with specified failureTypeId

function deleteFailureType(project: string, failureTypeId: number): Promise<void>

Parameters

project

string

Project ID or project name

failureTypeId

number

Returns

Promise<void>

function deleteTestMethodToWorkItemLink(project: string, testName: string, workItemId: number): Promise<boolean>

Parameters

project

string

Project ID or project name

testName

string

workItemId

number

Returns

Promise<boolean>

deleteTestResultAttachment(string, number, number, number)

function deleteTestResultAttachment(project: string, runId: number, testCaseResultId: number, attachmentId: number): Promise<void>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

Returns

Promise<void>

deleteTestRun(string, number)

function deleteTestRun(project: string, runId: number): Promise<void>

Parameters

project

string

Project ID or project name

runId

number

Returns

Promise<void>

deleteTestRunAttachment(string, number, number)

function deleteTestRunAttachment(project: string, runId: number, attachmentId: number): Promise<void>

Parameters

project

string

Project ID or project name

runId

number

attachmentId

number

Returns

Promise<void>

deleteTestRunLogStoreAttachment(string, number, string)

Deletes the attachment with the specified filename for the specified runId from the LogStore.

function deleteTestRunLogStoreAttachment(project: string, runId: number, filename: string): Promise<void>

Parameters

project

string

Project ID or project name

runId

number

Test RunId

filename

string

Attachment FileName

Returns

Promise<void>

deleteTestSettings(string, number)

function deleteTestSettings(project: string, testSettingsId: number): Promise<void>

Parameters

project

string

Project ID or project name

testSettingsId

number

Returns

Promise<void>

fetchSourceCodeCoverageReport(string, number)

function fetchSourceCodeCoverageReport(project: string, buildId: number): Promise<SourceViewBuildCoverage[]>

Parameters

project

string

Project ID or project name

buildId

number

Returns

getBugsLinkedToTestResult(string, number, number)

function getBugsLinkedToTestResult(project: string, runId: number, testCaseResultId: number): Promise<WorkItemReference[]>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

Returns

Promise<WorkItemReference[]>

getBuildCodeCoverage(string, number, number)

function getBuildCodeCoverage(project: string, buildId: number, flags: number): Promise<BuildCoverage[]>

Parameters

project

string

Project ID or project name

buildId

number

flags

number

Returns

Promise<BuildCoverage[]>

getCodeCoverageSummary(string, number, number)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10&deltaBuildId=9 Request: build id and delta build id (optional)

function getCodeCoverageSummary(project: string, buildId: number, deltaBuildId?: number): Promise<CodeCoverageSummary>

Parameters

project

string

Project ID or project name

buildId

number

deltaBuildId

number

Returns

getCoverageStatusBadge(string, string, string, string)

<p>Gets the coverage status for the last successful build of a definition, optionally scoped to a specific branch</p>

function getCoverageStatusBadge(project: string, definition: string, branchName?: string, label?: string): Promise<string>

Parameters

project

string

Project ID or project name

definition

string

The ID or name of the definition.

branchName

string

The branch name.

label

string

The String to replace the default text on the left side of the badge.

Returns

Promise<string>

getFailureTypes(string)

Returns the list of test failure types.

function getFailureTypes(project: string): Promise<TestResultFailureType[]>

Parameters

project

string

Project ID or project name

Returns

getFileLevelCodeCoverage(FileCoverageRequest, string)

Get file coverage for the specified file

function getFileLevelCodeCoverage(fileCoverageRequest: FileCoverageRequest, project: string): Promise<string>

Parameters

fileCoverageRequest
FileCoverageRequest

File details with pull request iteration context

project

string

Project ID or project name

Returns

Promise<string>

getFlakyTestResultsByBuildDefinitionId(string, number, Date)

function getFlakyTestResultsByBuildDefinitionId(project: string, buildDefinitionId: number, minBuildCreatedDate: Date): Promise<TestCaseResult[]>

Parameters

project

string

Project ID or project name

buildDefinitionId

number

minBuildCreatedDate

Date

Returns

Promise<TestCaseResult[]>

getFlakyTestResultsByTestRun(string, number)

function getFlakyTestResultsByTestRun(project: string, runId: number): Promise<TestCaseResult[]>

Parameters

project

string

Project ID or project name

runId

number

Returns

Promise<TestCaseResult[]>

getResultGroupsByBuild(string, number, string, string[], string)

function getResultGroupsByBuild(project: string, buildId: number, publishContext: string, fields?: string[], continuationToken?: string): Promise<PagedList<FieldDetailsForTestResults>>

Parameters

project

string

Project ID or project name

buildId

number

publishContext

string

fields

string[]

continuationToken

string

Returns

getResultGroupsByRelease(string, number, string, number, string[], string)

function getResultGroupsByRelease(project: string, releaseId: number, publishContext: string, releaseEnvId?: number, fields?: string[], continuationToken?: string): Promise<PagedList<FieldDetailsForTestResults>>

Parameters

project

string

Project ID or project name

releaseId

number

publishContext

string

releaseEnvId

number

fields

string[]

continuationToken

string

Returns

getSessionNotifications(string, number)

Retrieves TestResultsSession Notification objects in TCM data store

function getSessionNotifications(project: string, sessionId: number): Promise<TestSessionNotification[]>

Parameters

project

string

Project ID or project name

sessionId

number

Id of TestResults session to obtain Notifications for.

Returns

getSimilarTestResults(string, number, number, number, number, String)

Gets the list of results whose failure matches with the provided one.

function getSimilarTestResults(project: string, runId: number, testResultId: number, testSubResultId: number, top?: number, continuationToken?: String): Promise<TestCaseResult[]>

Parameters

project

string

Project ID or project name

runId

number

id of test run

testResultId

number

id of test result inside a test run

testSubResultId

number

id of subresult inside a test result

top

number

Maximum number of results to return

continuationToken

String

Header to pass the continuationToken

Returns

Promise<TestCaseResult[]>

getTestIterationAttachmentContent(string, number, number, number, number)

Returns a test iteration attachment

function getTestIterationAttachmentContent(project: string, runId: number, testCaseResultId: number, attachmentId: number, iterationId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

iterationId

number

Returns

Promise<ArrayBuffer>

getTestIterationAttachmentZip(string, number, number, number, number)

Returns a test iteration attachment

function getTestIterationAttachmentZip(project: string, runId: number, testCaseResultId: number, attachmentId: number, iterationId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

iterationId

number

Returns

Promise<ArrayBuffer>

getTestLogsForBuild(string, number, TestLogType, string, string, boolean, number, String)

Get list of build attachments reference

function getTestLogsForBuild(project: string, buildId: number, type: TestLogType, directoryPath?: string, fileNamePrefix?: string, fetchMetaData?: boolean, top?: number, continuationToken?: String): Promise<PagedList<TestLog>>

Parameters

project

string

Project ID or project name

buildId

number

Id of the build to get

type
TestLogType

type of the attachment to get

directoryPath

string

directory path for which attachments are needed

fileNamePrefix

string

file name prefix to filter the list of attachment

fetchMetaData

boolean

Default is false, set if metadata is needed

top

number

Number of test attachments reference to return

continuationToken

String

Header to pass the continuationToken

Returns

Promise<PagedList<TestLog>>

getTestLogStoreEndpointDetailsForBuildLog(string, number, TestLogType, string)

Get SAS Uri of a build attachment

function getTestLogStoreEndpointDetailsForBuildLog(project: string, build: number, type: TestLogType, filePath: string): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

build

number

Id of the build to get

type
TestLogType

type of the file

filePath

string

filePath for which sas uri is needed

Returns

getTestLogStoreEndpointDetailsForResultLog(string, number, number, TestLogType, string)

Get SAS Uri of a test results attachment

function getTestLogStoreEndpointDetailsForResultLog(project: string, runId: number, resultId: number, type: TestLogType, filePath: string): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run that contains result

resultId

number

Id of the test result whose files need to be downloaded

type
TestLogType

type of the file

filePath

string

filePath for which sas uri is needed

Returns

getTestLogStoreEndpointDetailsForRunLog(string, number, TestLogType, string)

Get SAS Uri of a test run attachment

function getTestLogStoreEndpointDetailsForRunLog(project: string, runId: number, type: TestLogType, filePath: string): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run whose file has to be downloaded

type
TestLogType

type of the file

filePath

string

filePath for which sas uri is needed

Returns

getTestLogStoreEndpointDetailsForSubResultLog(string, number, number, number, TestLogType, string)

Get SAS Uri of a test subresults attachment

function getTestLogStoreEndpointDetailsForSubResultLog(project: string, runId: number, resultId: number, subResultId: number, type: TestLogType, filePath: string): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run that contains result

resultId

number

Id of the test result that contains subresult

subResultId

number

Id of the test subresult whose file sas uri is needed

type
TestLogType

type of the file

filePath

string

filePath for which sas uri is needed

Returns

getTestPipelineMetrics(string, number, string, string, string, Metrics[], boolean)

Get summary of test results.

function getTestPipelineMetrics(project: string, pipelineId: number, stageName?: string, phaseName?: string, jobName?: string, metricNames?: Metrics[], groupByNode?: boolean): Promise<PipelineTestMetrics>

Parameters

project

string

Project ID or project name

pipelineId

number

Pipeline Id. This is same as build Id.

stageName

string

Name of the stage. Maximum supported length for name is 256 character.

phaseName

string

Name of the phase. Maximum supported length for name is 256 character.

jobName

string

Matrixing in YAML generates copies of a job with different inputs in matrix. JobName is the name of those input. Maximum supported length for name is 256 character.

metricNames

Metrics[]

groupByNode

boolean

Group summary for each node of the pipleine heirarchy

Returns

getTestResultAttachmentContent(string, number, number, number)

Returns a test result attachment

function getTestResultAttachmentContent(project: string, runId: number, testCaseResultId: number, attachmentId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

Returns

Promise<ArrayBuffer>

getTestResultAttachments(string, number, number)

function getTestResultAttachments(project: string, runId: number, testCaseResultId: number): Promise<TestAttachment[]>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

Returns

Promise<TestAttachment[]>

getTestResultAttachmentZip(string, number, number, number)

Returns a test result attachment

function getTestResultAttachmentZip(project: string, runId: number, testCaseResultId: number, attachmentId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

Returns

Promise<ArrayBuffer>

getTestResultById(string, number, number, ResultDetails)

function getTestResultById(project: string, runId: number, testResultId: number, detailsToInclude?: ResultDetails): Promise<TestCaseResult>

Parameters

project

string

Project ID or project name

runId

number

testResultId

number

detailsToInclude
ResultDetails

Returns

Promise<TestCaseResult>

getTestResultDetailsForBuild(string, number, string, string, string, string, boolean, boolean)

function getTestResultDetailsForBuild(project: string, buildId: number, publishContext?: string, groupBy?: string, filter?: string, orderby?: string, shouldIncludeResults?: boolean, queryRunSummaryForInProgress?: boolean): Promise<TestResultsDetails>

Parameters

project

string

Project ID or project name

buildId

number

publishContext

string

groupBy

string

filter

string

orderby

string

shouldIncludeResults

boolean

queryRunSummaryForInProgress

boolean

Returns

getTestResultDetailsForRelease(string, number, number, string, string, string, string, boolean, boolean)

function getTestResultDetailsForRelease(project: string, releaseId: number, releaseEnvId: number, publishContext?: string, groupBy?: string, filter?: string, orderby?: string, shouldIncludeResults?: boolean, queryRunSummaryForInProgress?: boolean): Promise<TestResultsDetails>

Parameters

project

string

Project ID or project name

releaseId

number

releaseEnvId

number

publishContext

string

groupBy

string

filter

string

orderby

string

shouldIncludeResults

boolean

queryRunSummaryForInProgress

boolean

Returns

getTestResultLogs(string, number, number, TestLogType, string, string, boolean, number, String)

Get list of test result attachments reference

function getTestResultLogs(project: string, runId: number, resultId: number, type: TestLogType, directoryPath?: string, fileNamePrefix?: string, fetchMetaData?: boolean, top?: number, continuationToken?: String): Promise<PagedList<TestLog>>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run that contains the result

resultId

number

Id of the test result

type
TestLogType

type of attachments to get

directoryPath

string

directory path of attachments to get

fileNamePrefix

string

file name prefix to filter the list of attachment

fetchMetaData

boolean

Default is false, set if metadata is needed

top

number

Numbe of attachments reference to return

continuationToken

String

Header to pass the continuationToken

Returns

Promise<PagedList<TestLog>>

getTestResults(string, number, ResultDetails, number, number, TestOutcome[], boolean)

function getTestResults(project: string, runId: number, detailsToInclude?: ResultDetails, skip?: number, top?: number, outcomes?: TestOutcome[], newTestsOnly?: boolean): Promise<TestCaseResult[]>

Parameters

project

string

Project ID or project name

runId

number

detailsToInclude
ResultDetails
skip

number

top

number

outcomes

TestOutcome[]

newTestsOnly

boolean

Returns

Promise<TestCaseResult[]>

getTestResultsByBuild(string, number, string, TestOutcome[], number, string)

function getTestResultsByBuild(project: string, buildId: number, publishContext?: string, outcomes?: TestOutcome[], top?: number, continuationToken?: string): Promise<PagedList<ShallowTestCaseResult>>

Parameters

project

string

Project ID or project name

buildId

number

publishContext

string

outcomes

TestOutcome[]

top

number

continuationToken

string

Returns

getTestResultsByPipeline(string, number, string, string, string, TestOutcome[], number, String)

Get a list of results.

function getTestResultsByPipeline(project: string, pipelineId: number, stageName?: string, phaseName?: string, jobName?: string, outcomes?: TestOutcome[], top?: number, continuationToken?: String): Promise<PagedList<ShallowTestCaseResult>>

Parameters

project

string

Project ID or project name

pipelineId

number

Pipeline Id. This is same as build Id.

stageName

string

Name of the stage. Maximum supported length for name is 256 character.

phaseName

string

Name of the phase. Maximum supported length for name is 256 character.

jobName

string

Matrixing in YAML generates copies of a job with different inputs in matrix. JobName is the name of those input. Maximum supported length for name is 256 character.

outcomes

TestOutcome[]

List of outcome of results

top

number

Maximum number of results to return

continuationToken

String

Header to pass the continuationToken

Returns

getTestResultsByQuery(TestResultsQuery, string)

function getTestResultsByQuery(query: TestResultsQuery, project: string): Promise<TestResultsQuery>

Parameters

project

string

Project ID or project name

Returns

Promise<TestResultsQuery>

getTestResultsByQueryWiql(QueryModel, string, boolean, boolean, number, number)

function getTestResultsByQueryWiql(queryModel: QueryModel, project: string, includeResultDetails?: boolean, includeIterationDetails?: boolean, skip?: number, top?: number): Promise<TestCaseResult[]>

Parameters

queryModel
QueryModel
project

string

Project ID or project name

includeResultDetails

boolean

includeIterationDetails

boolean

skip

number

top

number

Returns

Promise<TestCaseResult[]>

getTestResultsByRelease(string, number, number, string, TestOutcome[], number, string)

function getTestResultsByRelease(project: string, releaseId: number, releaseEnvid?: number, publishContext?: string, outcomes?: TestOutcome[], top?: number, continuationToken?: string): Promise<PagedList<ShallowTestCaseResult>>

Parameters

project

string

Project ID or project name

releaseId

number

releaseEnvid

number

publishContext

string

outcomes

TestOutcome[]

top

number

continuationToken

string

Returns

getTestResultsSettings(string, TestResultsSettingsType)

Get TestResultsSettings data

function getTestResultsSettings(project: string, settingsType?: TestResultsSettingsType): Promise<TestResultsSettings>

Parameters

project

string

Project ID or project name

Returns

getTestResultWorkItemsById(string, number, number)

function getTestResultWorkItemsById(project: string, runId: number, testCaseResultId: number): Promise<WorkItemReference[]>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

Returns

Promise<WorkItemReference[]>

getTestRunAttachmentContent(string, number, number)

Returns a test run attachment

function getTestRunAttachmentContent(project: string, runId: number, attachmentId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

attachmentId

number

Returns

Promise<ArrayBuffer>

getTestRunAttachments(string, number)

function getTestRunAttachments(project: string, runId: number): Promise<TestAttachment[]>

Parameters

project

string

Project ID or project name

runId

number

Returns

Promise<TestAttachment[]>

getTestRunAttachmentZip(string, number, number)

Returns a test run attachment

function getTestRunAttachmentZip(project: string, runId: number, attachmentId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

attachmentId

number

Returns

Promise<ArrayBuffer>

getTestRunById(string, number, boolean, boolean)

function getTestRunById(project: string, runId: number, includeDetails?: boolean, includeTags?: boolean): Promise<TestRun>

Parameters

project

string

Project ID or project name

runId

number

includeDetails

boolean

includeTags

boolean

Returns

Promise<TestRun>

getTestRunCodeCoverage(string, number, number)

function getTestRunCodeCoverage(project: string, runId: number, flags: number): Promise<TestRunCoverage[]>

Parameters

project

string

Project ID or project name

runId

number

flags

number

Returns

Promise<TestRunCoverage[]>

getTestRunLogs(string, number, TestLogType, string, string, boolean, number, String)

Get list of test run attachments reference

function getTestRunLogs(project: string, runId: number, type: TestLogType, directoryPath?: string, fileNamePrefix?: string, fetchMetaData?: boolean, top?: number, continuationToken?: String): Promise<PagedList<TestLog>>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run

type
TestLogType

type of the attachments to get

directoryPath

string

directory path for which attachments are needed

fileNamePrefix

string

file name prefix to filter the list of attachment

fetchMetaData

boolean

Default is false, set if metadata is needed

top

number

Number of attachments reference to return

continuationToken

String

Header to pass the continuationToken

Returns

Promise<PagedList<TestLog>>

getTestRunLogStoreAttachmentContent(string, number, string)

Returns the attachment with the specified filename for the specified runId from the LogStore.

function getTestRunLogStoreAttachmentContent(project: string, runId: number, filename: string): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

Test RunId

filename

string

Attachment FileName

Returns

Promise<ArrayBuffer>

getTestRunLogStoreAttachments(string, number)

Returns a list of attachments for the specified runId from the LogStore.

function getTestRunLogStoreAttachments(project: string, runId: number): Promise<TestLogStoreAttachment[]>

Parameters

project

string

Project ID or project name

runId

number

Test RunId

Returns

getTestRunLogStoreAttachmentZip(string, number, string)

Returns the attachment with the specified filename for the specified runId from the LogStore.

function getTestRunLogStoreAttachmentZip(project: string, runId: number, filename: string): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

Test RunId

filename

string

Attachment FileName

Returns

Promise<ArrayBuffer>

getTestRunMessageLogs(string, number)

Get test run message logs

function getTestRunMessageLogs(project: string, runId: number): Promise<TestMessageLogDetails[]>

Parameters

project

string

Project ID or project name

runId

number

ID of the run to get.

Returns

getTestRuns(string, string, string, string, number, boolean, boolean, number, number)

function getTestRuns(project: string, buildUri?: string, owner?: string, tmiRunId?: string, planId?: number, includeRunDetails?: boolean, automated?: boolean, skip?: number, top?: number): Promise<TestRun[]>

Parameters

project

string

Project ID or project name

buildUri

string

owner

string

tmiRunId

string

planId

number

includeRunDetails

boolean

automated

boolean

skip

number

top

number

Returns

Promise<TestRun[]>

getTestRunsBySessionId(string, number)

Retrieves Test runs associated to a session

function getTestRunsBySessionId(project: string, sessionId: number): Promise<number[]>

Parameters

project

string

Project ID or project name

sessionId

number

Id of TestResults session to obtain Test Runs for.

Returns

Promise<number[]>

getTestRunStatistics(string, number)

Get test run statistics , used when we want to get summary of a run by outcome.

function getTestRunStatistics(project: string, runId: number): Promise<TestRunStatistic>

Parameters

project

string

Project ID or project name

runId

number

ID of the run to get.

Returns

Promise<TestRunStatistic>

getTestRunSummaryByOutcome(string, number)

Get test run summary, used when we want to get summary of a run by outcome. Test run should be in completed state.

function getTestRunSummaryByOutcome(project: string, runId: number): Promise<TestRunStatistic>

Parameters

project

string

Project ID or project name

runId

number

ID of the run to get.

Returns

Promise<TestRunStatistic>

getTestSession(string, number)

Retrieves TestResultsSession metadata object in TCM data store

function getTestSession(project: string, buildId: number): Promise<TestResultsSession[]>

Parameters

project

string

Project ID or project name

buildId

number

Returns

Promise<TestResultsSession[]>

getTestSessionLayout(string, string)

Retrieves TestResultsSession Layout object in TCM data store

function getTestSessionLayout(project: string, sessionId: string): Promise<any[]>

Parameters

project

string

Project ID or project name

sessionId

string

Returns

Promise<any[]>

getTestSessionLayoutBySessionId(string, number)

Retrieves TestResultsSession Layout object in TCM data store

function getTestSessionLayoutBySessionId(project: string, sessionId: number): Promise<any[]>

Parameters

project

string

Project ID or project name

sessionId

number

Retrieve session object.

Returns

Promise<any[]>

getTestSessionResults(string, number, ResultDetails, number, number, TestOutcome[], boolean)

function getTestSessionResults(project: string, runId: number, detailsToInclude?: ResultDetails, skip?: number, top?: number, outcomes?: TestOutcome[], newTestsOnly?: boolean): Promise<TestCaseResult[]>

Parameters

project

string

Project ID or project name

runId

number

detailsToInclude
ResultDetails
skip

number

top

number

outcomes

TestOutcome[]

newTestsOnly

boolean

Returns

Promise<TestCaseResult[]>

getTestSettingsById(string, number)

function getTestSettingsById(project: string, testSettingsId: number): Promise<TestSettings>

Parameters

project

string

Project ID or project name

testSettingsId

number

Returns

Promise<TestSettings>

getTestSubResultAttachmentContent(string, number, number, number, number)

Returns a test sub result attachment

function getTestSubResultAttachmentContent(project: string, runId: number, testCaseResultId: number, attachmentId: number, testSubResultId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

testSubResultId

number

Returns

Promise<ArrayBuffer>

getTestSubResultAttachments(string, number, number, number)

Returns attachment references for test sub result.

function getTestSubResultAttachments(project: string, runId: number, testCaseResultId: number, testSubResultId: number): Promise<TestAttachment[]>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

testSubResultId

number

Returns

Promise<TestAttachment[]>

getTestSubResultAttachmentZip(string, number, number, number, number)

Returns a test sub result attachment

function getTestSubResultAttachmentZip(project: string, runId: number, testCaseResultId: number, attachmentId: number, testSubResultId: number): Promise<ArrayBuffer>

Parameters

project

string

Project ID or project name

runId

number

testCaseResultId

number

attachmentId

number

testSubResultId

number

Returns

Promise<ArrayBuffer>

getTestSubResultLogs(string, number, number, number, TestLogType, string, string, boolean, number, String)

Get list of test subresult attachments reference

function getTestSubResultLogs(project: string, runId: number, resultId: number, subResultId: number, type: TestLogType, directoryPath?: string, fileNamePrefix?: string, fetchMetaData?: boolean, top?: number, continuationToken?: String): Promise<PagedList<TestLog>>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run that contains the results

resultId

number

Id of the test result that contains subresult

subResultId

number

Id of the test subresult

type
TestLogType

type of the attachments to get

directoryPath

string

directory path of the attachment to get

fileNamePrefix

string

file name prefix to filter the list of attachments

fetchMetaData

boolean

Default is false, set if metadata is needed

top

number

Number of attachments reference to return

continuationToken

String

Header to pass the continuationToken

Returns

Promise<PagedList<TestLog>>

getTestTagsForBuild(string, number)

Get all the tags in a build.

function getTestTagsForBuild(project: string, buildId: number): Promise<TestTag[]>

Parameters

project

string

Project ID or project name

buildId

number

Build ID

Returns

Promise<TestTag[]>

getTestTagsForRelease(string, number, number)

Get all the tags in a release.

function getTestTagsForRelease(project: string, releaseId: number, releaseEnvId: number): Promise<TestTag[]>

Parameters

project

string

Project ID or project name

releaseId

number

Release ID

releaseEnvId

number

Release environment ID

Returns

Promise<TestTag[]>

getTestTagSummaryForBuild(string, number)

Get all the tags in a build.

function getTestTagSummaryForBuild(project: string, buildId: number): Promise<TestTagSummary>

Parameters

project

string

Project ID or project name

buildId

number

Build ID

Returns

Promise<TestTagSummary>

getTestTagSummaryForRelease(string, number, number)

Get all the tags in a release.

function getTestTagSummaryForRelease(project: string, releaseId: number, releaseEnvId: number): Promise<TestTagSummary>

Parameters

project

string

Project ID or project name

releaseId

number

Release ID

releaseEnvId

number

Release environment ID

Returns

Promise<TestTagSummary>

publishTestResultDocument(TestResultDocument, string, number)

function publishTestResultDocument(document: TestResultDocument, project: string, runId: number): Promise<TestResultDocument>

Parameters

project

string

Project ID or project name

runId

number

Returns

queryCustomFields(string, CustomTestFieldScope)

function queryCustomFields(project: string, scopeFilter: CustomTestFieldScope): Promise<CustomTestFieldDefinition[]>

Parameters

project

string

Project ID or project name

scopeFilter
CustomTestFieldScope

Returns

queryResultTrendForBuild(TestResultTrendFilter, string)

function queryResultTrendForBuild(filter: TestResultTrendFilter, project: string): Promise<AggregatedDataForResultTrend[]>

Parameters

project

string

Project ID or project name

Returns

queryResultTrendForRelease(TestResultTrendFilter, string)

function queryResultTrendForRelease(filter: TestResultTrendFilter, project: string): Promise<AggregatedDataForResultTrend[]>

Parameters

project

string

Project ID or project name

Returns

queryTestHistory(TestHistoryQuery, string)

Get history of a test method using TestHistoryQuery

function queryTestHistory(filter: TestHistoryQuery, project: string): Promise<TestHistoryQuery>

Parameters

filter
TestHistoryQuery

TestHistoryQuery to get history

project

string

Project ID or project name

Returns

Promise<TestHistoryQuery>

queryTestMethodLinkedWorkItems(string, string)

function queryTestMethodLinkedWorkItems(project: string, testName: string): Promise<TestToWorkItemLinks>

Parameters

project

string

Project ID or project name

testName

string

Returns

queryTestResultHistory(ResultsFilter, string)

function queryTestResultHistory(filter: ResultsFilter, project: string): Promise<TestResultHistory>

Parameters

filter
ResultsFilter
project

string

Project ID or project name

Returns

queryTestResultsMetaData(string[], string, ResultMetaDataDetails)

Get list of test Result meta data details for corresponding testcasereferenceId

function queryTestResultsMetaData(testCaseReferenceIds: string[], project: string, detailsToInclude?: ResultMetaDataDetails): Promise<TestResultMetaData[]>

Parameters

testCaseReferenceIds

string[]

TestCaseReference Ids of the test Result to be queried, comma separated list of valid ids (limit no. of ids 200).

project

string

Project ID or project name

detailsToInclude
ResultMetaDataDetails

Details to include with test results metadata. Default is None. Other values are FlakyIdentifiers.

Returns

Promise<TestResultMetaData[]>

queryTestResultsReportForBuild(string, number, string, boolean, BuildReference)

function queryTestResultsReportForBuild(project: string, buildId: number, publishContext?: string, includeFailureDetails?: boolean, buildToCompare?: BuildReference): Promise<TestResultSummary>

Parameters

project

string

Project ID or project name

buildId

number

publishContext

string

includeFailureDetails

boolean

buildToCompare
BuildReference

Returns

queryTestResultsReportForPipeline(string, number, string, string, string, boolean)

Get summary of test results.

function queryTestResultsReportForPipeline(project: string, pipelineId: number, stageName?: string, phaseName?: string, jobName?: string, includeFailureDetails?: boolean): Promise<TestResultSummary>

Parameters

project

string

Project ID or project name

pipelineId

number

Pipeline Id. This is same as build Id.

stageName

string

Name of the stage. Maximum supported length for name is 256 character.

phaseName

string

Name of the phase. Maximum supported length for name is 256 character.

jobName

string

Matrixing in YAML generates copies of a job with different inputs in matrix. JobName is the name of those input. Maximum supported length for name is 256 character.

includeFailureDetails

boolean

If true returns failure insights

Returns

queryTestResultsReportForRelease(string, number, number, string, boolean, ReleaseReference)

function queryTestResultsReportForRelease(project: string, releaseId: number, releaseEnvId: number, publishContext?: string, includeFailureDetails?: boolean, releaseToCompare?: ReleaseReference): Promise<TestResultSummary>

Parameters

project

string

Project ID or project name

releaseId

number

releaseEnvId

number

publishContext

string

includeFailureDetails

boolean

releaseToCompare
ReleaseReference

Returns

queryTestResultsSummaryForReleases(ReleaseReference[], string)

function queryTestResultsSummaryForReleases(releases: ReleaseReference[], project: string): Promise<TestResultSummary[]>

Parameters

releases

ReleaseReference[]

project

string

Project ID or project name

Returns

Promise<TestResultSummary[]>

queryTestResultWorkItems(string, string, string, number, Date, number, number)

Query Test Result WorkItems based on filter

function queryTestResultWorkItems(project: string, workItemCategory: string, automatedTestName?: string, testCaseId?: number, maxCompleteDate?: Date, days?: number, workItemCount?: number): Promise<WorkItemReference[]>

Parameters

project

string

Project ID or project name

workItemCategory

string

can take values Microsoft.BugCategory or all(for getting all workitems)

automatedTestName

string

testCaseId

number

maxCompleteDate

Date

days

number

workItemCount

number

Returns

Promise<WorkItemReference[]>

queryTestRuns(string, Date, Date, TestRunState, number[], boolean, TestRunPublishContext, number[], number[], string, number[], number[], number[], number[], string, number, string)

Query Test Runs based on filters. Mandatory fields are minLastUpdatedDate and maxLastUpdatedDate.

function queryTestRuns(project: string, minLastUpdatedDate: Date, maxLastUpdatedDate: Date, state?: TestRunState, planIds?: number[], isAutomated?: boolean, publishContext?: TestRunPublishContext, buildIds?: number[], buildDefIds?: number[], branchName?: string, releaseIds?: number[], releaseDefIds?: number[], releaseEnvIds?: number[], releaseEnvDefIds?: number[], runTitle?: string, top?: number, continuationToken?: string): Promise<PagedList<TestRun>>

Parameters

project

string

Project ID or project name

minLastUpdatedDate

Date

Minimum Last Modified Date of run to be queried (Mandatory).

maxLastUpdatedDate

Date

Maximum Last Modified Date of run to be queried (Mandatory, difference between min and max date can be atmost 7 days).

state
TestRunState

Current state of the Runs to be queried.

planIds

number[]

Plan Ids of the Runs to be queried, comma separated list of valid ids.

isAutomated

boolean

Automation type of the Runs to be queried.

publishContext
TestRunPublishContext

PublishContext of the Runs to be queried.

buildIds

number[]

Build Ids of the Runs to be queried, comma separated list of valid ids.

buildDefIds

number[]

Build Definition Ids of the Runs to be queried, comma separated list of valid ids.

branchName

string

Source Branch name of the Runs to be queried.

releaseIds

number[]

Release Ids of the Runs to be queried, comma separated list of valid ids.

releaseDefIds

number[]

Release Definition Ids of the Runs to be queried, comma separated list of valid ids.

releaseEnvIds

number[]

Release Environment Ids of the Runs to be queried, comma separated list of valid ids.

releaseEnvDefIds

number[]

Release Environment Definition Ids of the Runs to be queried, comma separated list of valid ids.

runTitle

string

Run Title of the Runs to be queried.

top

number

Number of runs to be queried. Limit is 100

continuationToken

string

continuationToken received from previous batch or null for first batch. It is not supposed to be created (or altered, if received from last batch) by user.

Returns

Promise<PagedList<TestRun>>

queryTestSummaryByRequirement(TestResultsContext, string, number[])

function queryTestSummaryByRequirement(resultsContext: TestResultsContext, project: string, workItemIds?: number[]): Promise<TestSummaryForWorkItem[]>

Parameters

resultsContext
TestResultsContext
project

string

Project ID or project name

workItemIds

number[]

Returns

testLogStoreEndpointDetailsForBuild(string, number, TestLogStoreOperationType)

Create and Get sas uri of the build container

function testLogStoreEndpointDetailsForBuild(project: string, buildId: number, testLogStoreOperationType: TestLogStoreOperationType): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

buildId

number

Id of the build to get

testLogStoreOperationType
TestLogStoreOperationType

Type of operation to perform using sas uri

Returns

testLogStoreEndpointDetailsForResult(string, number, number, number, string, TestLogType)

Create empty file for a result and Get Sas uri for the file

function testLogStoreEndpointDetailsForResult(project: string, runId: number, resultId: number, subResultId: number, filePath: string, type: TestLogType): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

runId

number

Id of the test run that contains the result

resultId

number

Id of the test results that contains sub result

subResultId

number

Id of the test sub result whose file sas uri is needed

filePath

string

file path inside the sub result for which sas uri is needed

type
TestLogType

Type of the file for download

Returns

testLogStoreEndpointDetailsForRun(string, number, TestLogStoreOperationType, string, TestLogType)

Create empty file for a run and Get Sas uri for the file

function testLogStoreEndpointDetailsForRun(project: string, runId: number, testLogStoreOperationType: TestLogStoreOperationType, filePath?: string, type?: TestLogType): Promise<TestLogStoreEndpointDetails>

Parameters

project

string

Project ID or project name

runId

number

Id of the run to get endpoint details

testLogStoreOperationType
TestLogStoreOperationType

Type of operation to perform using sas uri

filePath

string

file path to create an empty file

type
TestLogType

Default is GeneralAttachment, type of empty file to be created

Returns

testResultsGroupDetails(string, number, string, string, string, boolean, boolean)

Get all the available groups details and for these groups get failed and aborted results.

function testResultsGroupDetails(project: string, pipelineId: number, stageName?: string, phaseName?: string, jobName?: string, shouldIncludeFailedAndAbortedResults?: boolean, queryGroupSummaryForInProgress?: boolean): Promise<TestResultsDetails>

Parameters

project

string

Project ID or project name

pipelineId

number

Pipeline Id. This is same as build Id.

stageName

string

Name of the stage. Maximum supported length for name is 256 character.

phaseName

string

Name of the phase. Maximum supported length for name is 256 character.

jobName

string

Matrixing in YAML generates copies of a job with different inputs in matrix. JobName is the name of those input. Maximum supported length for name is 256 character.

shouldIncludeFailedAndAbortedResults

boolean

If true, it will return Ids of failed and aborted results for each test group

queryGroupSummaryForInProgress

boolean

If true, it will calculate summary for InProgress runs as well.

Returns

updateCodeCoverageSummary(string, number, CodeCoverageData)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10 Request: Json of code coverage summary

function updateCodeCoverageSummary(project: string, buildId: number, coverageData?: CodeCoverageData): Promise<void>

Parameters

project

string

Project ID or project name

buildId

number

coverageData
CodeCoverageData

Returns

Promise<void>

updateCustomField(CustomTestFieldUpdateDefinition, string)

function updateCustomField(updateCustomTestField: CustomTestFieldUpdateDefinition, project: string): Promise<CustomTestFieldDefinition>

Parameters

updateCustomTestField
CustomTestFieldUpdateDefinition
project

string

Project ID or project name

Returns

updatePipelinesTestSettings(TestResultsUpdateSettings, string)

Update project settings of test results

function updatePipelinesTestSettings(testResultsUpdateSettings: TestResultsUpdateSettings, project: string): Promise<TestResultsSettings>

Parameters

testResultsUpdateSettings
TestResultsUpdateSettings
project

string

Project ID or project name

Returns

updateTestResults(TestCaseResult[], string, number)

function updateTestResults(results: TestCaseResult[], project: string, runId: number): Promise<TestCaseResult[]>

Parameters

results

TestCaseResult[]

project

string

Project ID or project name

runId

number

Returns

Promise<TestCaseResult[]>

updateTestResultsMetaData(TestResultMetaDataUpdateInput, string, number)

Update properties of test result meta data

function updateTestResultsMetaData(testResultMetaDataUpdateInput: TestResultMetaDataUpdateInput, project: string, testCaseReferenceId: number): Promise<TestResultMetaData>

Parameters

testResultMetaDataUpdateInput
TestResultMetaDataUpdateInput

TestResultMetaData update input TestResultMetaDataUpdateInput

project

string

Project ID or project name

testCaseReferenceId

number

TestCaseReference Id of Test Result to be updated.

Returns

updateTestResultsToTestRunSession(TestCaseResult[], string, number)

Creates TestResultsMRX objects in TCM data store for existing test results

function updateTestResultsToTestRunSession(results: TestCaseResult[], project: string, runId: number): Promise<number[]>

Parameters

results

TestCaseResult[]

Results object with only test results MRX properties and existing testResultId

project

string

Project ID or project name

runId

number

RunId of test run

Returns

Promise<number[]>

updateTestRun(RunUpdateModel, string, number)

function updateTestRun(runUpdateModel: RunUpdateModel, project: string, runId: number): Promise<TestRun>

Parameters

runUpdateModel
RunUpdateModel
project

string

Project ID or project name

runId

number

Returns

Promise<TestRun>

updateTestRunTags(TestTagsUpdateModel, string, number)

Update tags of a run, Tags can be Added and Deleted

function updateTestRunTags(testTagsUpdateModel: TestTagsUpdateModel, project: string, runId: number): Promise<TestTag[]>

Parameters

testTagsUpdateModel
TestTagsUpdateModel

TestTagsUpdateModel

project

string

Project ID or project name

runId

number

RunId of the run

Returns

Promise<TestTag[]>