Browser-Nachweise

Tests sagen dir, dass der Code funktioniert. Ein Browser-Nachweis zeigt es dir. Wenn eine Story etwas ändert, das Menschen sehen, etwa eine Seite, ein Formular oder einen Dialog, öffnet kanman die App in einem echten Browser, geht den Ablauf durch, wie es eine Person täte, und zeichnet ihn auf. Du siehst dir die Aufnahme an, statt kanman beim Wort zu nehmen.

Was ein Nachweis ist

Ein Nachweis ist ein kurzes Video, in dem kanman deine App bedient, mit einer Liste benannter Schritte daneben:

• Aktionen: was kanman getan hat, in einfachen Worten, zum Beispiel “Anmeldeseite öffnen” oder “Auf Speichern klicken”.
• Prüfungen: was kanman zu sehen erwartet hat, zum Beispiel “Die Meldung sagt Gespeichert”. Eine Prüfung besteht nur, wenn die Seite es wirklich zeigt.

Jeder Schritt hat seine Zeit im Video und einen Screenshot. Klicke auf einen Schritt, um dorthin zu springen.

Ein Nachweis gehört zu seiner Story. kanman zeichnet einen auf, wenn die Änderung für Menschen sichtbar ist; eine Änderung ohne etwas zu sehen, etwa eine Datenbankmigration oder ein Hintergrundjob, wird allein durch deine CI und das Review belegt. Siehe So prüft kanman seine Arbeit.

Wo du ihn ansiehst

Du findest denselben Nachweis überall dort, wo du die Arbeit verfolgst:

• An der Story: Das Log der Story zeigt den Nachweis als Karte. Öffne sie, um das Video mit den Schritten daneben abzuspielen, oder öffne den Nachweis auf seiner eigenen Seite, um einen Link darauf zu teilen.
• In der Unterhaltung: Die Zeile, die kanman für jede Story führt, trägt einen kleinen Nachweis-Chip. Klicke darauf, um den Nachweis abzuspielen, ohne die Unterhaltung zu verlassen.
• In die Coding-Werkzeug-Sitzung: Während du die Arbeit an einer Story live verfolgst, erscheinen ihre Nachweise dort, sobald sie aufgezeichnet sind.
• Am Merge Request: kanman schreibt einen Kommentar mit dem Ergebnis, den Schritten und einigen Schlüsselbildern, damit auch Reviewer auf deinem Code-Host das Ergebnis sehen.

Der Player lässt sich mit der Tastatur bedienen: Leertaste spielt ab und pausiert, die Pfeiltasten springen durch das Video, F schaltet auf Vollbild. Auf dem Telefon öffnet Alle Schritte die Schrittliste vom unteren Bildschirmrand.

Bestanden und fehlgeschlagen

• Bestanden: Jede Prüfung hat gefunden, was sie erwartet hat, und der Ablauf lief bis zum Ende.
• Fehlgeschlagen: Mindestens eine Prüfung hat nicht gefunden, was sie erwartet hat, oder ein Schritt war nicht möglich. Der Schritt ist rot markiert, mit dem Grund, zum Beispiel “Text nicht gefunden”, und der Nachweis zeigt “1 von 5 fehlgeschlagen”. kanman behebt die Änderung und zeichnet den Nachweis neu auf; einen fehlgeschlagenen Nachweis gibt kanman nie als erledigt aus.
• Vorzeitig beendet: Die Aufnahme hat vor dem Ende gestoppt, zum Beispiel weil sie ihre Längengrenze erreicht hat. Sie gilt als nicht belegt, nie als bestanden.

Auch ein fehlgeschlagener Nachweis ist nützlich: Er zeigt genau, wo der Ablauf bricht, so wie eine Person es erleben würde.

Welche Hosts ein Nachweis öffnen darf

Ein Nachweis läuft gegen die App, die kanman für die Story aus deinem Repository startet, auf der eigenen Maschine des Runs. Darüber hinaus öffnet der Browser nur die Hosts, die dein Team erlaubt, dieselbe Liste, die den Internetzugang während der Arbeit begrenzt. Produktion wird nie geöffnet, außer dein Team trägt sie ein.

Um einen Host zu erlauben, zum Beispiel eine Staging-Umgebung, trag ihn unter Team > Umgebung > Internetzugang ein. Versucht ein Nachweis, einen nicht erlaubten Host zu öffnen, zeigt der Schritt, dass der Host blockiert wurde, und nennt ihn. Siehe Internetzugang während der Arbeit.

Gegen eine Vorschau aus deiner CI

Wenn deine CI für einen Merge Request eine Vorschau deployt (eine Review-App oder Vorschau-Umgebung), kann kanman den Nachweis gegen diese Vorschau aufnehmen, statt die App selbst zu starten. kanman liest die Adresse der Vorschau aus deiner CI, aus der Umgebung des Deploy-Jobs; eine Adresse aus anderer Quelle nutzt es nie.

Ein Nachweis läuft gegen eine Vorschau nur auf den Hosts, die du unter Team > Umgebung > Internetzugang > Vorschau-Hosts einträgst, zum Beispiel *.review.example.com. Eine Produktionsumgebung wird nur geöffnet, wenn ihr eigener Host dort eingetragen ist; ein Platzhalter deckt Produktion nie ab. Ohne Vorschau-Hosts laufen Nachweise gegen die App, die kanman startet.

Ein Nachweis gegen eine Vorschau sagt das auf seiner Karte: Gegen die Vorschau und die Adresse, und der Kommentar am Merge Request nennt die Umgebung.

Aufnahmen zeigen nie die Passwörter, die kanman eintippt: Sie sind im Video, in den Schritten und im Kommentar am Merge Request verborgen.