Ratgeber: Eine leere Prüfliste mit every nicht als vollständig bestandene Kontrolle melden

Kein Fehler gefunden bedeutet nicht immer etwas geprüft

Eine Anwendung kontrolliert mehrere Dokumente und zeigt anschließend „Alle gültig“. Wenn die Liste der Dokumente leer war, kann diese Aussage missverständlich sein. MDN beschreibt Array.every als Prüfung aller vorhandenen Elemente gegen eine Funktion. Für ein leeres Array liefert die Methode wahr. Das ist ihre definierte Bedeutung und kein Browserfehler. Eine fachliche Erfolgsmeldung braucht deshalb zusätzlich die Information, ob überhaupt eine geeignete Prüfliste vorlag.

Vollständigkeit getrennt definieren

Beschreibe im Projekt, welche Eingaben für den Vorgang mindestens erforderlich sind. Soll eine leere Sammlung erlaubt sein, sollte ihre Meldung genau das sagen. Muss mindestens ein Dokument vorhanden sein, prüfe diese Bedingung unabhängig vom Ergebnis der Einzelprüfungen. Ein wahrer Rückgabewert allein beweist weder einen abgeschlossenen Import noch die Existenz aller erwarteten Dateien. Überlege auch, ob ein vorgeschalteter Filter versehentlich sämtliche Elemente entfernt haben könnte. Eine leere gefilterte Menge ist etwas anderes als eine vollständig geprüfte ursprüngliche Lieferung.

Mit drei kleinen Listen testen

Verwende in einer Entwicklungsumgebung eine leere Liste, eine Liste mit nur gültigen Beispielen und eine Liste mit einem bewusst fehlerhaften Beispiel. Notiere vorher die jeweils erwartete Meldung. Beobachte neben dem Ergebnis auch, wie viele Elemente tatsächlich geprüft wurden. Bei dünn besetzten Arrays ruft every die Testfunktion nicht für leere Stellen auf; vermeide deshalb die Annahme, jede Indexposition sei ein vorhandener Datensatz. Erzeuge solche Strukturen nur bewusst und behandle sie nach einer klaren Datenregel.

Den Nachweis lesbar machen

Eine gute Zusammenfassung nennt Umfang und Ergebnis der konkreten Prüfung. Sie darf bei fehlenden Eingaben nicht denselben uneingeschränkten Erfolgsmarker wie nach einer vollständigen Kontrolle erzeugen. Prüfe zusätzlich den Weg, über den die Liste entsteht, und nicht nur die einzelne Hilfsfunktion. Die Abnahme gelingt, wenn „keine Eingaben“, „alles geprüft und gültig“ sowie „geprüft mit Fehler“ unterscheidbar bleiben. every ersetzt dabei keine Anforderung an die Vollständigkeit, keine Quellenfreigabe und keinen Nachweis, dass ein erwartetes Paket tatsächlich angekommen ist.

Prüfe die Umfangsangabe auch nach einem vollständig fehlgeschlagenen Datenabruf. Eine wegen dieses Fehlers leere Ersatzliste darf keinen vollständigen fachlichen Erfolg auslösen.