TestRestClient class

应使用基类(派生自)向 VSS REST API 发出请求

扩展

构造函数

TestRestClient(IVssRestClientOptions)

属性

RESOURCE_AREA_ID

方法

addCustomFields(CustomTestFieldDefinition[], string)
addTestCasesToSuite(string, number, number, string)

将测试用例添加到套件中。

addTestResultsToTestRun(TestCaseResult[], string, number)

将测试结果添加到测试运行。

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

附加文件以测试步骤结果

createTestResultAttachment(TestAttachmentRequestModel, string, number, number)

将文件附加到测试结果。

createTestRun(RunCreateModel, string)

创建新的测试运行。

createTestRunAttachment(TestAttachmentRequestModel, string, number)

将文件附加到测试运行。

createTestSession(TestSession, TeamContext)

创建测试会话

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

将文件附加到测试结果

deleteSharedParameter(string, number)
deleteSharedStep(string, number)
deleteTestCase(string, number)

删除测试用例。

deleteTestMethodToWorkItemLink(string, string, number)
deleteTestRun(string, number)

按其 ID 删除测试运行。

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

获取生成的代码覆盖率数据。

getCodeCoverageSummary(string, number, number)

获取生成的代码覆盖率摘要。

getLinkedWorkItemsByQuery(LinkedWorkItemsQuery, string)
getPoint(string, number, number, number, string)

获取测试点。

getPoints(string, number, number, string, string, string, string, boolean, number, number)

获取测试点列表。

getPointsByQuery(TestPointsQuery, string, number, number)

使用查询获取测试点。

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

获取测试结果保留设置

getTestCaseById(string, number, number, number)

在具有测试用例 ID 的测试套件中获取特定测试用例。

getTestCases(string, number, number)

在套件中获取所有测试用例。

getTestIteration(string, number, number, number, boolean)

获取结果的迭代

getTestIterations(string, number, number, boolean)

获取结果的迭代

getTestResultAttachmentContent(string, number, number, number)

按其 ID 下载测试结果附件。

getTestResultAttachments(string, number, number)

获取测试结果附件参考列表。

getTestResultAttachmentZip(string, number, number, number)

按其 ID 下载测试结果附件。

getTestResultById(string, number, number, ResultDetails)

获取测试运行的测试结果。

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

获取测试运行的测试结果。

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

此 API 将按 Id 返回结果,其中包含特定自动测试方法的指定字段/趋势。 我们仍在改进此 API,尚未最终确定正确的签名和合同。

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

按 ID 下载测试运行附件。

getTestRunAttachments(string, number)

获取测试运行附件参考列表。

getTestRunAttachmentZip(string, number, number)

按 ID 下载测试运行附件。

getTestRunById(string, number, boolean)

按其 ID 获取测试运行。

getTestRunCodeCoverage(string, number, number)

获取测试运行的代码覆盖率数据

getTestRunLogs(string, number)

获取测试运行消息日志

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

获取测试运行列表。

getTestRunStatistics(string, number)

获取测试运行统计信息 ,当我们想要获取运行结果的摘要时使用。

getTestSessions(TeamContext, number, boolean, boolean, TestSessionSource, boolean)

获取测试会话列表

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

下载测试子结果附件

getTestSubResultAttachments(string, number, number, number)

获取测试子结果附件列表

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

下载测试子结果附件

processSuitesForStaging(StagedSuitesRequestModel, string, number)

处理测试套件的集合,并返回包含套件和测试用例详细信息的响应模型。

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

使用 TestHistoryQuery 获取测试方法的历史记录

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

获取相应 testcasereferenceId 的测试结果元数据详细信息列表

queryTestResultsReportForBuild(string, number, string, boolean, BuildReference)
queryTestResultsReportForRelease(string, number, number, string, boolean, ReleaseReference)
queryTestResultsSummaryForReleases(ReleaseReference[], string)
queryTestResultWorkItems(string, string, string, number, Date, number, number)
queryTestRuns(string, Date, Date, TestRunState, number[], boolean, TestRunPublishContext, number[], number[], string, number[], number[], number[], number[], string, number, string)

根据筛选器查询测试运行。 必填字段为 minLastUpdatedDate 和 maxLastUpdatedDate。

queryTestSummaryByRequirement(TestResultsContext, string, number[])
removeTestCasesFromSuiteUrl(string, number, number, string)

与测试用例关联的测试点将从测试套件中删除。 测试用例工作项不会从系统中删除。 请参阅测试用例资源以永久删除测试用例。

updateCodeCoverageSummary(CodeCoverageData, string, number)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10 请求:代码覆盖率摘要的 Json

updateResultRetentionSettings(ResultRetentionSettings, string)

更新测试结果保留设置

updateSuiteTestCases(SuiteTestCaseUpdateModel, string, number, number, string)

更新套件中测试用例关联的属性。

updateTestPoints(PointUpdateModel, string, number, number, string)

更新测试点。

updateTestResults(TestCaseResult[], string, number)

在测试运行中更新测试结果。

updateTestRun(RunUpdateModel, string, number)

按其 ID 更新测试运行。

updateTestSession(TestSession, TeamContext)

更新测试会话

构造函数详细信息

TestRestClient(IVssRestClientOptions)

new TestRestClient(options: IVssRestClientOptions)

参数

属性详细信息

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

属性值

string

方法详细信息

addCustomFields(CustomTestFieldDefinition[], string)

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

参数

project

string

项目 ID 或项目名称

返回

addTestCasesToSuite(string, number, number, string)

将测试用例添加到套件中。

function addTestCasesToSuite(project: string, planId: number, suiteId: number, testCaseIds: string): Promise<SuiteTestCase[]>

参数

project

string

项目 ID 或项目名称

planId

number

包含套件的测试计划的 ID。

suiteId

number

必须将测试用例添加到的测试套件的 ID。

testCaseIds

string

要添加到套件的测试用例的 ID。 ID 以逗号分隔格式指定。

返回

Promise<SuiteTestCase[]>

addTestResultsToTestRun(TestCaseResult[], string, number)

将测试结果添加到测试运行。

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

参数

results

TestCaseResult[]

要添加的测试结果列表。

project

string

项目 ID 或项目名称

runId

number

要将测试结果添加到的测试运行 ID。

返回

Promise<TestCaseResult[]>

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

参数

workItemToTestLinks
WorkItemToTestLinks
project

string

项目 ID 或项目名称

返回

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

附加文件以测试步骤结果

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

参数

attachmentRequestModel
TestAttachmentRequestModel

附件详细信息 TestAttachmentRequestModel

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含迭代的测试结果的 ID

iterationId

number

测试结果迭代的 ID。

actionPath

string

测试结果作路径的十六进制值。

返回

createTestResultAttachment(TestAttachmentRequestModel, string, number, number)

将文件附加到测试结果。

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

参数

attachmentRequestModel
TestAttachmentRequestModel

附件详细信息 TestAttachmentRequestModel

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

必须上传附件的测试结果的 ID。

返回

createTestRun(RunCreateModel, string)

创建新的测试运行。

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

参数

testRun
RunCreateModel

运行详细信息 RunCreateModel

project

string

项目 ID 或项目名称

返回

Promise<TestRun>

createTestRunAttachment(TestAttachmentRequestModel, string, number)

将文件附加到测试运行。

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

参数

attachmentRequestModel
TestAttachmentRequestModel

附件详细信息 TestAttachmentRequestModel

project

string

项目 ID 或项目名称

runId

number

必须上传附件的测试运行的 ID。

返回

createTestSession(TestSession, TeamContext)

创建测试会话

function createTestSession(testSession: TestSession, teamContext: TeamContext): Promise<TestSession>

参数

testSession
TestSession

创建的测试会话详细信息

teamContext
TeamContext

操作的团队上下文

返回

Promise<TestSession>

createTestSettings(TestSettings, string)

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

参数

testSettings
TestSettings
project

string

项目 ID 或项目名称

返回

Promise<number>

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

将文件附加到测试结果

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

参数

attachmentRequestModel
TestAttachmentRequestModel

附件请求模型。

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含子结果的测试结果的 ID。

testSubResultId

number

必须上传附件的测试子结果的 ID。

返回

deleteSharedParameter(string, number)

function deleteSharedParameter(project: string, sharedParameterId: number): Promise<void>

参数

project

string

项目 ID 或项目名称

sharedParameterId

number

返回

Promise<void>

deleteSharedStep(string, number)

function deleteSharedStep(project: string, sharedStepId: number): Promise<void>

参数

project

string

项目 ID 或项目名称

sharedStepId

number

返回

Promise<void>

deleteTestCase(string, number)

删除测试用例。

function deleteTestCase(project: string, testCaseId: number): Promise<void>

参数

project

string

项目 ID 或项目名称

testCaseId

number

要删除的测试用例的 ID。

返回

Promise<void>

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

参数

project

string

项目 ID 或项目名称

testName

string

workItemId

number

返回

Promise<boolean>

deleteTestRun(string, number)

按其 ID 删除测试运行。

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

参数

project

string

项目 ID 或项目名称

runId

number

要删除的运行的 ID。

返回

Promise<void>

deleteTestSettings(string, number)

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

参数

project

string

项目 ID 或项目名称

testSettingsId

number

返回

Promise<void>

getBugsLinkedToTestResult(string, number, number)

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

参数

project

string

项目 ID 或项目名称

runId

number

testCaseResultId

number

返回

Promise<WorkItemReference[]>

getBuildCodeCoverage(string, number, number)

获取生成的代码覆盖率数据。

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

参数

project

string

项目 ID 或项目名称

buildId

number

需要获取代码覆盖率数据的构建的 ID。

flags

number

标志的值确定要获取的代码覆盖率详细信息的级别。 标志是累加的。 模块的期望值为 1,函数为 2,BlockData 为 4。

返回

Promise<BuildCoverage[]>

getCodeCoverageSummary(string, number, number)

获取生成的代码覆盖率摘要。

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

参数

project

string

项目 ID 或项目名称

buildId

number

需要获取代码覆盖率数据的构建的 ID。

deltaBuildId

number

增量内部版本 ID(可选)

返回

getLinkedWorkItemsByQuery(LinkedWorkItemsQuery, string)

function getLinkedWorkItemsByQuery(workItemQuery: LinkedWorkItemsQuery, project: string): Promise<LinkedWorkItemsQueryResult[]>

参数

workItemQuery
LinkedWorkItemsQuery
project

string

项目 ID 或项目名称

返回

getPoint(string, number, number, number, string)

获取测试点。

function getPoint(project: string, planId: number, suiteId: number, pointIds: number, witFields?: string): Promise<TestPoint>

参数

project

string

项目 ID 或项目名称

planId

number

测试计划的 ID。

suiteId

number

包含该点的套件的 ID。

pointIds

number

要获取的测试点的 ID。

witFields

string

工作项字段名称的逗号分隔列表。

返回

Promise<TestPoint>

getPoints(string, number, number, string, string, string, string, boolean, number, number)

获取测试点列表。

function getPoints(project: string, planId: number, suiteId: number, witFields?: string, configurationId?: string, testCaseId?: string, testPointIds?: string, includePointDetails?: boolean, skip?: number, top?: number): Promise<TestPoint[]>

参数

project

string

项目 ID 或项目名称

planId

number

测试计划的 ID。

suiteId

number

包含点的套件的 ID。

witFields

string

工作项字段名称的逗号分隔列表。

configurationId

string

获取特定配置的测试点。

testCaseId

string

获取特定测试用例的测试点,当未设置 configurationId 时有效。

testPointIds

string

获取以逗号分隔的测试点 ID 列表的测试点,仅在未设置 configurationId 和 testCaseId 时有效。

includePointDetails

boolean

包括测试点的所有属性。

skip

number

要跳过的测试点数..

top

number

要返回的测试点数。

返回

Promise<TestPoint[]>

getPointsByQuery(TestPointsQuery, string, number, number)

使用查询获取测试点。

function getPointsByQuery(query: TestPointsQuery, project: string, skip?: number, top?: number): Promise<TestPointsQuery>

参数

query
TestPointsQuery

TestPointsQuery 来获取测试点。

project

string

项目 ID 或项目名称

skip

number

要跳过的测试点数..

top

number

要返回的测试点数。

返回

Promise<TestPointsQuery>

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

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

参数

project

string

项目 ID 或项目名称

buildId

number

publishContext

string

fields

string[]

continuationToken

string

返回

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

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

参数

project

string

项目 ID 或项目名称

releaseId

number

publishContext

string

releaseEnvId

number

fields

string[]

continuationToken

string

返回

getResultRetentionSettings(string)

获取测试结果保留设置

function getResultRetentionSettings(project: string): Promise<ResultRetentionSettings>

参数

project

string

项目 ID 或项目名称

返回

getTestCaseById(string, number, number, number)

在具有测试用例 ID 的测试套件中获取特定测试用例。

function getTestCaseById(project: string, planId: number, suiteId: number, testCaseIds: number): Promise<SuiteTestCase>

参数

project

string

项目 ID 或项目名称

planId

number

包含套件的测试计划的 ID。

suiteId

number

包含测试用例的套件的 ID。

testCaseIds

number

要获取的测试用例的 ID。

返回

Promise<SuiteTestCase>

getTestCases(string, number, number)

在套件中获取所有测试用例。

function getTestCases(project: string, planId: number, suiteId: number): Promise<SuiteTestCase[]>

参数

project

string

项目 ID 或项目名称

planId

number

包含套件的测试计划的 ID。

suiteId

number

要获取的套件的 ID。

返回

Promise<SuiteTestCase[]>

getTestIteration(string, number, number, number, boolean)

获取结果的迭代

function getTestIteration(project: string, runId: number, testCaseResultId: number, iterationId: number, includeActionResults?: boolean): Promise<TestIterationDetailsModel>

参数

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含迭代的测试结果的 ID。

iterationId

number

测试结果迭代的 ID。

includeActionResults

boolean

包括测试迭代中执行的每个作的结果详细信息。 ActionResults 是指在运行手动测试过程中执行的测试步骤的结果(通过/失败)。 包含 ActionResults 标志可获取每个测试迭代的 actionResults 部分中的测试步骤结果和参数部分中的测试参数。

返回

getTestIterations(string, number, number, boolean)

获取结果的迭代

function getTestIterations(project: string, runId: number, testCaseResultId: number, includeActionResults?: boolean): Promise<TestIterationDetailsModel[]>

参数

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含迭代的测试结果的 ID。

includeActionResults

boolean

包括测试迭代中执行的每个作的结果详细信息。 ActionResults 是指在运行手动测试过程中执行的测试步骤的结果(通过/失败)。 包含 ActionResults 标志可获取每个测试迭代的 actionResults 部分中的测试步骤结果和参数部分中的测试参数。

返回

getTestResultAttachmentContent(string, number, number, number)

按其 ID 下载测试结果附件。

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

参数

project

string

项目 ID 或项目名称

runId

number

包含 testCaseResultId 的测试运行的 ID。

testCaseResultId

number

必须下载其附件的测试结果的 ID。

attachmentId

number

要下载的测试结果附件的 ID。

返回

Promise<ArrayBuffer>

getTestResultAttachments(string, number, number)

获取测试结果附件参考列表。

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

参数

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

测试结果的 ID。

返回

Promise<TestAttachment[]>

getTestResultAttachmentZip(string, number, number, number)

按其 ID 下载测试结果附件。

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

参数

project

string

项目 ID 或项目名称

runId

number

包含 testCaseResultId 的测试运行的 ID。

testCaseResultId

number

必须下载其附件的测试结果的 ID。

attachmentId

number

要下载的测试结果附件的 ID。

返回

Promise<ArrayBuffer>

getTestResultById(string, number, number, ResultDetails)

获取测试运行的测试结果。

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

参数

project

string

项目 ID 或项目名称

runId

number

要提取的测试结果的测试运行 ID。

testCaseResultId

number

测试结果 ID。

detailsToInclude
ResultDetails

测试结果中包含的详细信息。 默认值为 None。 其他值包括 Iterations、WorkItems 和 SubResults。

返回

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>

参数

project

string

项目 ID 或项目名称

buildId

number

publishContext

string

groupBy

string

filter

string

orderby

string

shouldIncludeResults

boolean

queryRunSummaryForInProgress

boolean

返回

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>

参数

project

string

项目 ID 或项目名称

releaseId

number

releaseEnvId

number

publishContext

string

groupBy

string

filter

string

orderby

string

shouldIncludeResults

boolean

queryRunSummaryForInProgress

boolean

返回

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

获取测试运行的测试结果。

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

参数

project

string

项目 ID 或项目名称

runId

number

要提取的测试结果的测试运行 ID。

detailsToInclude
ResultDetails

测试结果中包含的详细信息。 默认值为 None。 其他值是 Iterations 和 WorkItems。

skip

number

从头开始跳过的测试结果数。

top

number

要返回的测试结果数。 当 detailsToInclude 为 None 时,最大值为 1000,否则为 200。

outcomes

TestOutcome[]

以逗号分隔的测试结果列表,用于筛选测试结果。

返回

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>>

参数

project

string

项目 ID 或项目名称

buildId

number

publishContext

string

outcomes

TestOutcome[]

top

number

continuationToken

string

返回

getTestResultsByQuery(TestResultsQuery, string)

此 API 将按 Id 返回结果,其中包含特定自动测试方法的指定字段/趋势。 我们仍在改进此 API,尚未最终确定正确的签名和合同。

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

参数

project

string

项目 ID 或项目名称

返回

Promise<TestResultsQuery>

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>>

参数

project

string

项目 ID 或项目名称

releaseId

number

releaseEnvid

number

publishContext

string

outcomes

TestOutcome[]

top

number

continuationToken

string

返回

getTestRunAttachmentContent(string, number, number)

按 ID 下载测试运行附件。

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

参数

project

string

项目 ID 或项目名称

runId

number

必须下载其附件的测试运行的 ID。

attachmentId

number

要下载的测试运行附件的 ID。

返回

Promise<ArrayBuffer>

getTestRunAttachments(string, number)

获取测试运行附件参考列表。

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

参数

project

string

项目 ID 或项目名称

runId

number

测试运行的 ID。

返回

Promise<TestAttachment[]>

getTestRunAttachmentZip(string, number, number)

按 ID 下载测试运行附件。

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

参数

project

string

项目 ID 或项目名称

runId

number

必须下载其附件的测试运行的 ID。

attachmentId

number

要下载的测试运行附件的 ID。

返回

Promise<ArrayBuffer>

getTestRunById(string, number, boolean)

按其 ID 获取测试运行。

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

参数

project

string

项目 ID 或项目名称

runId

number

要获取的运行的 ID。

includeDetails

boolean

默认值为 true。 它包括运行统计信息、发布、构建、测试环境、后处理状态等详细信息。

返回

Promise<TestRun>

getTestRunCodeCoverage(string, number, number)

获取测试运行的代码覆盖率数据

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

参数

project

string

项目 ID 或项目名称

runId

number

需要获取代码覆盖率数据的测试运行的 ID。

flags

number

标志的值确定要获取的代码覆盖率详细信息的级别。 标志是累加的。 模块的期望值为 1,函数为 2,BlockData 为 4。

返回

Promise<TestRunCoverage[]>

getTestRunLogs(string, number)

获取测试运行消息日志

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

参数

project

string

项目 ID 或项目名称

runId

number

要获取的运行的 ID。

返回

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[]>

参数

project

string

项目 ID 或项目名称

buildUri

string

运行使用的生成的 URI。

owner

string

运行所有者的团队基础 ID。

tmiRunId

string

planId

number

运行所属的测试计划的 ID。

includeRunDetails

boolean

如果为 true,则包括运行的所有属性。

automated

boolean

如果为 true,则仅返回自动运行。

skip

number

要跳过的测试运行数。

top

number

要返回的测试运行数。

返回

Promise<TestRun[]>

getTestRunStatistics(string, number)

获取测试运行统计信息 ,当我们想要获取运行结果的摘要时使用。

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

参数

project

string

项目 ID 或项目名称

runId

number

要获取的运行的 ID。

返回

Promise<TestRunStatistic>

getTestSessions(TeamContext, number, boolean, boolean, TestSessionSource, boolean)

获取测试会话列表

function getTestSessions(teamContext: TeamContext, period?: number, allSessions?: boolean, includeAllProperties?: boolean, source?: TestSessionSource, includeOnlyCompletedSessions?: boolean): Promise<TestSession[]>

参数

teamContext
TeamContext

操作的团队上下文

period

number

从现在起提取测试会话的天数。

allSessions

boolean

如果为 false,则返回当前用户的测试会话。 否则,它将返回所有用户的测试会话

includeAllProperties

boolean

如果为 true,则返回测试会话的所有属性。 否则,它将返回瘦版本。

source
TestSessionSource

测试会话的源。

includeOnlyCompletedSessions

boolean

如果为 true,则返回处于已完成状态的测试会话。 否则,它将返回所有状态的测试会话

返回

Promise<TestSession[]>

getTestSettingsById(string, number)

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

参数

project

string

项目 ID 或项目名称

testSettingsId

number

返回

Promise<TestSettings>

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

下载测试子结果附件

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

参数

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含子结果的测试结果的 ID。

attachmentId

number

要下载的测试结果附件的 ID

testSubResultId

number

必须下载其附件的测试子结果的 ID

返回

Promise<ArrayBuffer>

getTestSubResultAttachments(string, number, number, number)

获取测试子结果附件列表

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

参数

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含子结果的测试结果的 ID。

testSubResultId

number

必须下载其附件的测试子结果的 ID

返回

Promise<TestAttachment[]>

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

下载测试子结果附件

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

参数

project

string

项目 ID 或项目名称

runId

number

包含结果的测试运行的 ID。

testCaseResultId

number

包含子结果的测试结果的 ID。

attachmentId

number

要下载的测试结果附件的 ID

testSubResultId

number

必须下载其附件的测试子结果的 ID

返回

Promise<ArrayBuffer>

processSuitesForStaging(StagedSuitesRequestModel, string, number)

处理测试套件的集合,并返回包含套件和测试用例详细信息的响应模型。

function processSuitesForStaging(request: StagedSuitesRequestModel, project: string, workItemId: number): Promise<StagedSuitesResponseModel>

参数

request
StagedSuitesRequestModel

包含要处理的测试套件的请求模型。 不能为 null。

project

string

项目 ID 或项目名称

workItemId

number

返回

publishTestResultDocument(TestResultDocument, string, number)

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

参数

project

string

项目 ID 或项目名称

runId

number

返回

queryCustomFields(string, CustomTestFieldScope)

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

参数

project

string

项目 ID 或项目名称

scopeFilter
CustomTestFieldScope

返回

queryResultTrendForBuild(TestResultTrendFilter, string)

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

参数

project

string

项目 ID 或项目名称

返回

queryResultTrendForRelease(TestResultTrendFilter, string)

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

参数

project

string

项目 ID 或项目名称

返回

queryTestHistory(TestHistoryQuery, string)

使用 TestHistoryQuery 获取测试方法的历史记录

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

参数

filter
TestHistoryQuery

TestHistoryQuery 获取历史记录

project

string

项目 ID 或项目名称

返回

Promise<TestHistoryQuery>

queryTestMethodLinkedWorkItems(string, string)

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

参数

project

string

项目 ID 或项目名称

testName

string

返回

queryTestResultHistory(ResultsFilter, string)

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

参数

filter
ResultsFilter
project

string

项目 ID 或项目名称

返回

queryTestResultsMetaData(string[], string)

获取相应 testcasereferenceId 的测试结果元数据详细信息列表

function queryTestResultsMetaData(testReferenceIds: string[], project: string): Promise<TestResultMetaData[]>

参数

testReferenceIds

string[]

要查询的测试结果的 TestCaseReference Ids,逗号分隔的有效 ID 列表(id 的限制数为 200)。

project

string

项目 ID 或项目名称

返回

Promise<TestResultMetaData[]>

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

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

参数

project

string

项目 ID 或项目名称

buildId

number

publishContext

string

includeFailureDetails

boolean

buildToCompare
BuildReference

返回

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

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

参数

project

string

项目 ID 或项目名称

releaseId

number

releaseEnvId

number

publishContext

string

includeFailureDetails

boolean

releaseToCompare
ReleaseReference

返回

queryTestResultsSummaryForReleases(ReleaseReference[], string)

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

参数

releases

ReleaseReference[]

project

string

项目 ID 或项目名称

返回

Promise<TestResultSummary[]>

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

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

参数

project

string

项目 ID 或项目名称

workItemCategory

string

automatedTestName

string

testCaseId

number

maxCompleteDate

Date

days

number

workItemCount

number

返回

Promise<WorkItemReference[]>

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

根据筛选器查询测试运行。 必填字段为 minLastUpdatedDate 和 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>>

参数

project

string

项目 ID 或项目名称

minLastUpdatedDate

Date

要查询的运行的最小上次修改日期(必填)。

maxLastUpdatedDate

Date

要查询的运行的最大上次修改日期(必填,最小日期和最大日期之间的差异最多可达 7 天)。

state
TestRunState

要查询的运行的当前状态。

planIds

number[]

要查询的运行的计划 ID,以逗号分隔的有效 ID 列表(id 10 的限制数)。

isAutomated

boolean

要查询的运行的自动化类型。

publishContext
TestRunPublishContext

PublishContext 的要查询的运行。

buildIds

number[]

要查询的运行的构建 ID,以逗号分隔的有效 ID 列表(ID 的限制数为 10)。

buildDefIds

number[]

要查询的运行的构建定义 ID,以逗号分隔的有效 ID 列表(id 10 的限制数)。

branchName

string

要查询的运行的源分支名称。

releaseIds

number[]

要查询的运行的发布 ID,以逗号分隔的有效 ID 列表(ID 的限制数 10)。

releaseDefIds

number[]

要查询的运行的发布定义 ID,以逗号分隔的有效 ID 列表(ID 的限制数 10)。

releaseEnvIds

number[]

释放要查询的运行的环境 ID,以逗号分隔的有效 ID 列表(ID 的限制数 10)。

releaseEnvDefIds

number[]

发布要查询的运行的环境定义 ID,以逗号分隔的有效 ID 列表(ID 的限制数 10)。

runTitle

string

要查询的运行的运行标题。

top

number

要查询的运行数。 限制为 100

continuationToken

string

continuationToken 从上一个批次接收或第一批的 null。 用户不应创建(或更改,如果从上一批收到)。

返回

Promise<PagedList<TestRun>>

queryTestSummaryByRequirement(TestResultsContext, string, number[])

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

参数

resultsContext
TestResultsContext
project

string

项目 ID 或项目名称

workItemIds

number[]

返回

removeTestCasesFromSuiteUrl(string, number, number, string)

与测试用例关联的测试点将从测试套件中删除。 测试用例工作项不会从系统中删除。 请参阅测试用例资源以永久删除测试用例。

function removeTestCasesFromSuiteUrl(project: string, planId: number, suiteId: number, testCaseIds: string): Promise<void>

参数

project

string

项目 ID 或项目名称

planId

number

包含套件的测试计划的 ID。

suiteId

number

要获取的套件的 ID。

testCaseIds

string

要从套件中删除的测试用例的 ID。

返回

Promise<void>

updateCodeCoverageSummary(CodeCoverageData, string, number)

http://(tfsserver):8080/tfs/DefaultCollection/_apis/test/CodeCoverage?buildId=10 请求:代码覆盖率摘要的 Json

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

参数

coverageData
CodeCoverageData
project

string

项目 ID 或项目名称

buildId

number

返回

Promise<void>

updateResultRetentionSettings(ResultRetentionSettings, string)

更新测试结果保留设置

function updateResultRetentionSettings(retentionSettings: ResultRetentionSettings, project: string): Promise<ResultRetentionSettings>

参数

retentionSettings
ResultRetentionSettings

要更新的测试结果保留设置详细信息

project

string

项目 ID 或项目名称

返回

updateSuiteTestCases(SuiteTestCaseUpdateModel, string, number, number, string)

更新套件中测试用例关联的属性。

function updateSuiteTestCases(suiteTestCaseUpdateModel: SuiteTestCaseUpdateModel, project: string, planId: number, suiteId: number, testCaseIds: string): Promise<SuiteTestCase[]>

参数

suiteTestCaseUpdateModel
SuiteTestCaseUpdateModel

用于更新测试用例套件关联属性的模型。

project

string

项目 ID 或项目名称

planId

number

包含套件的测试计划的 ID。

suiteId

number

必须将测试用例添加到的测试套件的 ID。

testCaseIds

string

要添加到套件的测试用例的 ID。 ID 以逗号分隔格式指定。

返回

Promise<SuiteTestCase[]>

updateTestPoints(PointUpdateModel, string, number, number, string)

更新测试点。

function updateTestPoints(pointUpdateModel: PointUpdateModel, project: string, planId: number, suiteId: number, pointIds: string): Promise<TestPoint[]>

参数

pointUpdateModel
PointUpdateModel

要更新的数据。

project

string

项目 ID 或项目名称

planId

number

测试计划的 ID。

suiteId

number

包含点的套件的 ID。

pointIds

string

要获取的测试点的 ID。 使用逗号分隔的 ID 列表来更新多个测试点。

返回

Promise<TestPoint[]>

updateTestResults(TestCaseResult[], string, number)

在测试运行中更新测试结果。

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

参数

results

TestCaseResult[]

要更新的测试结果列表。

project

string

项目 ID 或项目名称

runId

number

要更新其测试结果的测试运行 ID。

返回

Promise<TestCaseResult[]>

updateTestRun(RunUpdateModel, string, number)

按其 ID 更新测试运行。

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

参数

runUpdateModel
RunUpdateModel

运行详细信息 RunUpdateModel

project

string

项目 ID 或项目名称

runId

number

要更新的运行的 ID。

返回

Promise<TestRun>

updateTestSession(TestSession, TeamContext)

更新测试会话

function updateTestSession(testSession: TestSession, teamContext: TeamContext): Promise<TestSession>

参数

testSession
TestSession

更新的测试会话详细信息

teamContext
TeamContext

操作的团队上下文

返回

Promise<TestSession>