Wie kann ich in Postman Umgebungsvariablen programmatisch ändern oder aktualisieren?

1. Grundprinzip der Umgebungsvariablen in Postman
2. Variablen programmatisch ändern – Methoden
3. Variablen auf andere Bereiche ändern (global, collection, lokal)
4. Variablen löschen oder zurücksetzen
5. Best Practices beim Ändern von Umgebungsvariablen
6. Zusammenfassung

Postman ist ein leistungsfähiges Werkzeug zum Testen von APIs, das unter anderem Umgebungsvariablen unterstützt, welche das flexible Arbeiten mit unterschiedlichen Umgebungen (z. B. Entwicklung, Test, Produktion) erleichtern. In vielen Situationen ist es wichtig, diese Umgebungsvariablen programmatisch innerhalb einer Collection oder eines Requests anzupassen oder zu aktualisieren, um dynamische Werte zu speichern oder zu verändern.

Grundprinzip der Umgebungsvariablen in Postman

Eine Umgebungsvariable in Postman besitzt einen Namen und einen Wert, welcher in verschiedenen Requests referenziert werden kann. Diese Variablen können manuell in der Benutzeroberfläche gesetzt werden, aber ebenso dynamisch über sogenannte Skripte vor oder nach dem Request (Pre-request Script bzw. Tests Tab) angepasst werden. Die Variablen sind an die aktive Umgebung gebunden und können beispielsweise URLs, Tokens, IDs oder andere Parameter flexibel speichern.

Variablen programmatisch ändern – Methoden

Wenn Sie eine Umgebungsvariable im Skript ändern möchten, stehen Ihnen dafür in Postman spezielle Funktionen bereit. Die wichtigste Methode ist pm.environment.set(name, value), welche eine Umgebungsvariable mit einem bestimmten Namen entweder neu anlegt oder überschreibt. Wenn Sie eine Variable auslesen möchten, nutzen Sie pm.environment.get(name).

Beispiel: Wenn Sie im Testtab eines Requests ein Token aus der Serverantwort auslesen und anschließend als Umgebungsvariable speichern möchten, schreiben Sie:

Damit wird die Umgebungsvariable authToken auf den Wert aus der Antwort gesetzt, und dieser Wert ist in allen folgenden Requests der aktuellen Umgebung verfügbar.

Variablen auf andere Bereiche ändern (global, collection, lokal)

Postman kennt verschiedene Variablenbereiche. Neben der Umgebung (environment) gibt es globale Variablen (pm.globals.set(name, value)) und Collection-Variablen (pm.collectionVariables.set(name, value)). Je nach Anwendungsfall können Sie so die Gültigkeit und Sichtbarkeit der Variablen steuern. Um nur Umgebungsvariablen anzupassen, ist aber pm.environment der richtige Namespace.

Variablen löschen oder zurücksetzen

Um eine Umgebungsvariable zu löschen, können Sie die Funktion pm.environment.unset("variablenname") verwenden. Das ist sinnvoll, wenn Sie eine nicht mehr benötigte Variable entfernen möchten. Alternativ können Sie eine Variable einfach mit leerem Wert überschreiben.

Best Practices beim Ändern von Umgebungsvariablen

Es ist wichtig, dass Änderungen an Umgebungsvariablen gut durchdacht sind, da sie Auswirkungen auf nachfolgende Requests haben. Insbesondere wenn mehrere Requests in einer Collection mit unterschiedlichen Variablenwerten arbeiten, sollten Sie sicherstellen, dass Variablen nur dort gesetzt bzw. geändert werden, wo es sinnvoll ist, z. B. im Pre-request Script oder im Tests Tab je nach Fluss der Tests. Auch kann es hilfreich sein, den aktuellen Wert einer Variable mit console.log(pm.environment.get("variablenname")) auszugeben, um Debugging zu betreiben.

Zusammenfassung

Um eine Umgebungsvariable in Postman programmatisch zu ändern oder zu aktualisieren, verwenden Sie pm.environment.set("variablenname", "wert") innerhalb von Pre-request Scripts oder Tests. Variablen können damit dynamisch aus API-Antworten oder Berechnungen heraus gesetzt werden. Das macht die Arbeit mit Postman flexibler und automatisierter, besonders bei komplexen API-Testabläufen.