En aquest tema, aprendrem com realitzar proves basades en dades amb Postman. Aquesta tècnica ens permet executar la mateixa prova amb diferents conjunts de dades, la qual cosa és molt útil per validar el comportament d'una API amb diverses entrades.

Què són les Proves Basades en Dades?

Les proves basades en dades impliquen l'ús de diferents conjunts de dades per executar la mateixa prova diverses vegades. Això ajuda a assegurar que l'API funcioni correctament amb una varietat d'entrades possibles.

Avantatges de les Proves Basades en Dades:

  • Eficiència: Permet executar múltiples proves amb un sol script.
  • Cobertura: Augmenta la cobertura de proves al verificar l'API amb diferents dades.
  • Mantenibilitat: Facilita l'actualització de proves simplement canviant les dades d'entrada.

Configuració de Proves Basades en Dades a Postman

Pas 1: Preparar el Fitxer de Dades

  1. Format del Fitxer: Postman suporta fitxers CSV i JSON per a proves basades en dades.

  2. Estructura del Fitxer CSV:

    • La primera fila ha de contenir els noms de les variables.
    • Les files següents contenen els valors de les variables.

    Exemple de fitxer CSV:

    username,password
    user1,pass1
    user2,pass2
    

Pas 2: Crear una Sol·licitud a Postman

  1. Configura la Sol·licitud: Crea una sol·licitud a Postman que utilitzi variables per als camps que vols provar amb diferents dades.

    Exemple de sol·licitud POST:

    POST /api/login
    Host: example.com
    Content-Type: application/json
    
    {
      "username": "{{username}}",
      "password": "{{password}}"
    }
    

Pas 3: Executar la Prova amb el Fitxer de Dades

  1. Utilitza el Runner de Postman:

    • Obre el Runner de Postman.
    • Selecciona la col·lecció que conté la teva sol·licitud.
    • Adjunta el fitxer de dades (CSV o JSON).
    • Executa la col·lecció.
  2. Revisar els Resultats: Postman executarà la sol·licitud per a cada conjunt de dades i mostrarà els resultats de cada execució.

Exemple Pràctic

Fitxer CSV d'Exemple

username,password
testuser1,securepass1
testuser2,securepass2

Sol·licitud a Postman

POST /api/login
Host: example.com
Content-Type: application/json

{
  "username": "{{username}}",
  "password": "{{password}}"
}

Scripts de Prova

Afegeix un script de prova per verificar la resposta:

pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

pm.test("Response has token", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData).to.have.property("token");
});

Exercici Pràctic

Objectiu: Configura una prova basada en dades per a una API de registre d'usuaris.

  1. Crea un fitxer CSV amb els camps email, password, name.
  2. Configura una sol·licitud POST a l'endpoint /api/register que utilitzi aquestes variables.
  3. Executa la col·lecció amb el fitxer de dades i verifica que cada registre es creï correctament.

Solució de l'Exercici

  1. Fitxer CSV:

    email,password,name
    [email protected],pass123,User One
    [email protected],pass456,User Two
    
  2. Sol·licitud POST:

    POST /api/register
    Host: example.com
    Content-Type: application/json
    
    {
      "email": "{{email}}",
      "password": "{{password}}",
      "name": "{{name}}"
    }
    
  3. Scripts de Prova:

    pm.test("Status code is 201", function () {
        pm.response.to.have.status(201);
    });
    
    pm.test("Response has user ID", function () {
        var jsonData = pm.response.json();
        pm.expect(jsonData).to.have.property("id");
    });
    

Conclusió

Les proves basades en dades amb Postman són una tècnica poderosa per assegurar que les teves APIs funcionin correctament amb una varietat d'entrades. Aquesta tècnica no només augmenta l'eficiència de les proves, sinó que també millora la cobertura i la qualitat del teu procés de prova. En el següent tema, explorarem com provar APIs RESTful amb Postman.

© Copyright 2024. Tots els drets reservats