Un code d'état HTTP réussi ne garantit pas la justesse de la logique métier. Une API de connexion peut renvoyer 200 OK avec un message « identifiants invalides », ou une API de commande peut réussir au niveau HTTP tout en renvoyant un ensemble de résultats vide. Les points de contrôle vous permettent de définir des critères de réussite ou d'échec basés sur le contenu réel de la réponse : codes d'état, en-têtes, corps du texte et paramètres de sortie. Ainsi, le rapport de test de charge reflète les résultats métiers réels, et non simplement la réussite au niveau HTTP.
Types de points de contrôle
PTS prend en charge quatre types de points de contrôle, chacun validant une partie différente de la réponse de l'API :
| Type | Élément vérifié | Cas d'utilisation typique |
|---|---|---|
| Status Code | Code d'état de la réponse HTTP | Vérifiez que la réponse renvoie 2xx ou un code spécifique |
| Response Header | Valeurs des en-têtes de la réponse HTTP | Confirmez les en-têtes tels que Content-Type ou Cache-Control |
| Response Body | Contenu du corps de la réponse | Faites correspondre le texte attendu, les champs JSON ou les modèles |
| Output Parameters | Valeurs des paramètres de sortie extraits | Validez les valeurs dynamiques capturées à partir d'appels d'API précédents |
Évaluation des points de contrôle
Définissez un ou plusieurs points de contrôle dans l'onglet Check Point (Assertion) d'un nœud d'API dans votre scénario de test de charge.
Pour chaque requête durant le test, PTS évalue tous les points de contrôle par rapport à la réponse.
Tous les points de contrôle d'une même requête utilisent la logique ET : chaque point de contrôle doit être valide pour que la requête soit considérée comme une réussite métier.
La surveillance en temps réel et le rapport final de test de charge indiquent si le processus métier testé s'exécute comme prévu ou s'il a échoué. Vous pouvez décider de poursuivre ou non le test de charge en fonction de ces rapports.
Résultats des points de contrôle dans les rapports
Après avoir configuré les points de contrôle, les tests de charge en temps réel et les rapports de test de charge indiquent si le processus métier testé s'exécute comme prévu ou s'il a échoué. Utilisez ces résultats pour déterminer s'il convient de poursuivre le test de charge.
Conditions de vérification
Les conditions disponibles pour un point de contrôle dépendent du fait que la valeur Content soit numérique ou non numérique.
Valeurs non numériques
Si la valeur Content contient des caractères non numériques :
| Condition | Comportement |
|---|---|
| Equal To | Correspondance exacte |
| Not Equal To | Ne correspond pas exactement |
| Contain | Le contenu inclut la sous-chaîne spécifiée |
| Not Contain | Le contenu n'inclut pas la sous-chaîne spécifiée |
| Belong To | Le contenu est membre de l'ensemble spécifié |
| Not Belong To | Le contenu n'est pas membre de l'ensemble spécifié |
| Exist | L'objet de vérification existe dans la réponse |
| Not Exist | L'objet de vérification n'existe pas dans la réponse |
| Regular Expression | Le contenu correspond au modèle d'expression régulière spécifié |
Valeurs numériques
Si la valeur Content ne contient que des chiffres, des comparaisons numériques supplémentaires deviennent disponibles :
| Condition | Comportement |
|---|---|
| Greater Than | La valeur est strictement supérieure au seuil |
| Greater Than or Equal To | La valeur est supérieure ou égale au seuil |
| Equal To | La valeur est exactement égale au seuil |
| Less Than or Equal To | La valeur est inférieure ou égale au seuil |
| Less Than | La valeur est strictement inférieure au seuil |
| Belong To | La valeur se trouve dans l'ensemble ou la plage spécifiée |
| Not Belong To | La valeur se trouve en dehors de l'ensemble ou de la plage spécifiée |
| Exist | L'objet de vérification existe |
| Not Exist | L'objet de vérification n'existe pas |
| Regular Expression | La valeur correspond au modèle d'expression régulière spécifié |
Exist et Not Exist
Les conditions Exist et Not Exist s'appliquent à tous les types de données. Elles vérifient uniquement si l'objet cible existe dans la réponse ; elles n'évaluent pas la valeur réelle.
Expressions d'ensemble et de plage pour Belong To et Not Belong To
Les conditions Belong To et Not Belong To acceptent les entiers positifs, les entiers négatifs, 0 et les chaînes de caractères. Utilisez la notation mathématique standard pour définir les plages et les ensembles.
| Type d'expression | Syntaxe | Exemple | Correspondances |
|---|---|---|---|
| Intervalle fermé | [min,max] |
[-20,20] |
Tout entier de -20 à 20, inclus |
| Ensemble avec plages | {elements} |
{[-200,200],-1,2} |
-1, 2 et tout entier dans la plage [-200, 200] |
| Ensemble de chaînes | {"str1","str2"} |
{"abc","bcd","200","-200","Registered","Signed Up"} |
Toute chaîne correspondant exactement à un membre de l'ensemble |
Si un ensemble n'inclut pas d'entier négatif, vous pouvez l'écrire sous forme d'expression d'intervalle fermé. Toutefois, privilégiez une expression d'ensemble pour plus de clarté. Par exemple, [200-300,1] correspond à l'entier 1 et à tous les entiers dans l'intervalle fermé de 200 à 300.
Directives de syntaxe des expressions
Lorsque vous utilisez Belong To ou Not Belong To avec des nombres négatifs et des plages mixtes, utilisez toujours la notation d'ensemble ({...}) pour éviter toute ambiguïté liée au signe moins.
Exemple : valider un cookie et un code d'état
Supposons que le test ne réussisse que si les deux conditions suivantes sont remplies :
Le paramètre de sortie
export_cookiecontient des informations sandbox.Le code d'état de la réponse se situe dans la plage de 200 à 399.
Étape 1 : Définir le paramètre de sortie
Dans l'onglet Output Parameter Definition du nœud d'API cible, configurez le paramètre de sortie export_cookie.
Étape 2 : Configurer les points de contrôle
Dans l'onglet Check Point (Assertion) du même nœud d'API, ajoutez deux points de contrôle :
Un point de contrôle Output Parameters qui vérifie que
export_cookiecontient la valeur sandbox attendue.Un point de contrôle Status Code qui vérifie que le code de réponse appartient à la plage
[200,399].
Étant donné que les points de contrôle utilisent la logique ET, les deux conditions doivent être satisfaites pour que la requête soit considérée comme une réussite métier.