# 13.2 Instrucciones básicas para probar con Postman

Postman cuenta con algunas funciones ya definidas y algunas librerías javascript para probar tus servicios.

La sintaxis básica es:

```javascript
pm.test("Descripción del caso de prueba", function() {
    //código para la prueba
    pm.expect("valor esperado").to.equal("valor")
});
```

Para indicar que quieres agregar un nuevo caso de prueba es con el objeto **pm** luego **.** luego la función **test** entre paréntesis el primer parámetro es la **descripción del test**, luego una función. 

Por lo general el código para probar es con **pm** luego **.** luego la función **expect** como parámetro agregas el **valor esperado** y luego el **valor** y la **condición** que deseas probar en el ejemplo se prueba que sea igual a un valor.

### Instrucciones básicas

| Prueba                                                 | Código                                                                                                                                                                              |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Revisar el status                                      | <p><code>pm.response.to.have.status(200);</code></p><p><code>pm.expect(pm.response.code).to.be.oneOf(\[201,202]);</code></p>                                                        |
| Revisar tiempo de respuesta                            | <p><code>pm.expect(pm.response.responseTime).to.be.below(200);</code></p><p><code>pm.response.to.have.status("Created");</code></p>                                                 |
| Revisar un header                                      | `pm.response.to.have.header("Content-Type");`                                                                                                                                       |
| Comparar el tipo de dato                               | <p><code>pm.expect('Postman').to.be.a('string');</code></p><p><code>pm.expect({a: 1}).to.be.an('object');</code></p><p><code>pm.expect(undefined).to.be.an('undefined');</code></p> |
| Revisar que el body tenga un texto                     | `pm.expect(pm.response.text()).to.include("string a buscar");`                                                                                                                      |
| Obtener el json                                        | `var jsonData = pm.response.json(`);                                                                                                                                                |
| Convertir un xml a json                                | `var jsonObject = xml2Json(responseBody);`                                                                                                                                          |
| Revisar que un valor en el json sea igual a otro valor | <p><code>var jsonData = pm.response.json();</code></p><p><code>pm.expect(jsonData.value).to.eql(100);</code></p>                                                                    |
| Revisa que exista una cadena en otra cadena            | `pm.expect('Cadena').to.have.string('de');`                                                                                                                                         |
| Revisar que un array o cadena este vacío               | <p><code>pm.expect(\[]).to.be.empty;</code></p><p><code>pm.expect('').to.be.empty;</code></p>                                                                                       |
| Revisar todas las propiedades de un objeto             | <p><code>pm.expect({a: 1, b: 2}).to.have.all.keys('a', 'b');</code></p><p>    <code>});</code></p>                                                                                  |
| Revisar que tenga solo algunas propiedades             | <p><code>pm.expect({a: 1, b: 2}).to.have.any.keys('a', 'b');</code></p><p>    <code>});</code></p>                                                                                  |
| Revisar que un objeto no tenga alguna propiedad        | <p><code>pm.expect({a: 1, b: 2}).to.not.have.any.keys('c', 'd');</code></p><p>    <code>});</code></p>                                                                              |
| Revisar la longitud de una cadena                      | `pm.expect('foo').to.have.lengthOf(3);`                                                                                                                                             |
| Revisar el número de elementos array                   | `pm.expect([1, 2, 3]).to.have.lengthOf(3);`                                                                                                                                         |
| Revisar que exista un elemento en un array             | `pm.expect([1, 2, 3]).to.include(2);`                                                                                                                                               |