Aller au contenu principal

Rapporteur Testrail

@wdio/testrail-reporter est un package tiers, pour plus d'informations, veuillez consulter GitHub | npm

Ce rapporteur crée des rapports TestRail. La première chose dont vous avez besoin est d'activer l'API TestRail afin que le rapport puisse communiquer avec TestRail et transmettre les résultats des tests. Pour ce faire, connectez-vous à votre compte TestRail et allez dans Administration > Paramètres du site > API et assurez-vous de cocher la case près de Activer l'API.

Ajoutez l'ID de cas de test TestRail à la description du test. Par exemple :

it("C123456 Page loads correctly", async () => {

Cela prend également en charge plusieurs caseIDs. Par exemple :

it("C123456 C678910 Page loads correctly", async () => {

Installation

Pour utiliser le rapporteur, ajoutez-le à votre package.json :

npm i --save-dev @wdio/testrail-reporter

Utilisation

Ajoutez le rapporteur à votre fichier de configuration WDIO.

Exemple pour créer une nouvelle série de tests :

export const config = {
// ...
reporters:
[
['testrail', {
projectId: 1,
suiteId: 1,
domain: 'xxxxx.testrail.io',
username: process.env.TESTRAIL_USERNAME,
apiToken: process.env.TESTRAIL_API_TOKEN,
runName: 'name for the test run',
oneReport: true,
includeAll: false,
caseIdTagPrefix: '' // used only for multi-platform Cucumber Scenarios
}
]
],
// ...
}

Exemple pour mettre à jour une série de tests existante :

export const config = {
// ...
reporters:
[
['testrail', {
projectId: 1,
suiteId: 1,
domain: 'xxxxx.testrail.io',
username: process.env.TESTRAIL_USERNAME,
apiToken: process.env.TESTRAIL_API_TOKEN,
existingRunId: 2345,
oneReport: true,
includeAll: false
}
]
],
// ...
}

Exemple lorsque vous avez besoin de différents identifiants de projet et/ou de suite en fonction de la suite de tests à exécuter :

export const config = {
// ...
reporters:
[
['testrail', {
projectId: process.env.TESTRAIL_PROJECT_NAME == 'PROJECT_A' ? 1 : 2,
suiteId: process.env.TESTRAIL_SUITE_NAME == 'SUITE_A' ? 10 : 20,
domain: 'xxxxx.testrail.io',
username: process.env.TESTRAIL_USERNAME,
apiToken: process.env.TESTRAIL_API_TOKEN,
runName: 'name for the test run',
oneReport: true,
includeAll: false
}
]
],
// ...
}

Options

projectId

ID du projet testrail.

Type: string

suiteId

ID de la suite, la suite 1 est par défaut.

Type: string

domain

Domaine de votre instance testrail, par exemple your-domain.testrail.io.

Type: string

username

Nom d'utilisateur de votre instance testrail.

Type: string

apiToken

Jeton API de votre instance testrail.

Type: string

runName

Nom personnalisé pour la série de tests.

Type: string

existingRunId

ID d'une série de tests existante à mettre à jour.

Type: string

oneReport

Créer une seule série de tests.

Type: boolean

includeAll

Inclure tous les tests de la suite dans la série de tests.

Type: boolean

caseIdTagPrefix

Préfixe utilisé pour localiser l'ID de cas dans les balises Cucumber, utile pour les exécutions de scénarios Cucumber multi-plateformes.

Type: string

useCucumber

Indique si les tests sont écrits en utilisant le framework Cucumber. Par défaut, il est réglé sur false.

Type: boolean


Pour plus d'informations sur WebdriverIO, consultez la page d'accueil.

Welcome! How can I help?

WebdriverIO AI Copilot