Priorität von Konfigurationswerten auflösen

Diese Funktion vergleicht Werte aus einem Anwendungsstandard, einer Konfigurationsdatei, einer Umgebungsvariable und einem Befehlszeilenargument und wendet anschließend die von Ihnen festgelegte Rangfolge an. Sie gibt sowohl den wirksamen Wert als auch dessen Quelle zurück, sodass sich die Entscheidung leicht prüfen, testen und dokumentieren lässt. Nicht angegebene Quellen bleiben von bewusst angegebenen leeren Zeichenfolgen unterscheidbar; dadurch wird übliches Überschreibungsverhalten präzise abgebildet.

Beschreiben Sie Werte, ohne Abwesenheit und Leerwert zu verwechseln

Tragen Sie die Quellwerte im Objekt values unter den kanonischen Namen default, config_file, environment_variable und cli_flag ein. Fehlt eine Eigenschaft, hat diese Quelle keine Einstellung geliefert. Diese Unterscheidung ist wichtig, weil eine leere Zeichenfolge eine beabsichtigte Überschreibung darstellen kann: Ein CLI-Argument könnte beispielsweise gezielt ein Präfix löschen, das in einer Datei steht. Daher behandelt der Resolver eine vorhandene leere Zeichenfolge als echten Wert und überspringt sie nicht stillschweigend. Jeder angegebene Wert muss eine Zeichenfolge sein. Dies entspricht der üblichen Rohform von Umgebungsvariablen und Befehlszeilenparsern und verhindert unerwartete Umwandlungen zwischen null, falsch und Textwerten. Sie können zusätzlich einen Einstellungsnamen angeben. Er beeinflusst die Auswahl nicht, wird aber im Ergebnis wiederholt, damit Protokolle und Testfälle bei mehreren Einstellungen verständlich bleiben. Unbekannte Quellnamen werden abgelehnt, um Tippfehler sichtbar zu machen. Ist keine der vier Eigenschaften vorhanden, schlägt die Auflösung fehl, auch wenn die Standardeigenschaft fehlt. So wird aus einer fehlenden Einstellung nicht unbemerkt ein erfundener Wert.

Legen Sie die Rangfolge ausdrücklich fest und wenden Sie sie an

Das Array precedence führt alle vier Quellen von der höchsten bis zur niedrigsten Priorität auf. Eine verbreitete Reihenfolge lautet CLI-Argument, Umgebungsvariable, Konfigurationsdatei und Standardwert. Der Resolver setzt diese Konvention jedoch nicht voraus, weil Anwendungen und Bereitstellungssysteme unterschiedlich arbeiten. Er prüft die geordneten Namen und wählt die erste Quelle, deren Eigenschaft im Objekt values vorhanden ist. Die zurückgegebene Quelle erklärt, weshalb sich der Wert durchgesetzt hat; das zurückgegebene Rangfolgen-Array bewahrt zugleich die verwendete Richtlinie. Jede unterstützte Quelle muss genau einmal vorkommen, damit die Richtlinie vollständig und überprüfbar ist. Ein doppelter oder unbekannter Name, eine fehlende Quelle oder ein zusätzlicher Eintrag erzeugt einen Eingabefehler statt eines mehrdeutigen Teilergebnisses. Das hilft bei Regeln aus Dokumentationen, Framework-Migrationen oder Testmatrizen: Die eingereichte Reihenfolge ist die gesamte Regel und kein Hinweis, der mit verborgenen Vorgaben kombiniert wird. Die Auswahl ist deterministisch und führt weder Typumwandlung noch Interpolation, Dateizugriff, Umgebungsabfrage oder Befehlsanalyse aus. Dieselbe Eingabe liefert daher im Browser, CI-Auftrag und API-Aufruf stets dieselbe Ausgabe.

Nutzen Sie das Ergebnis für Tests, Diagnose und Dokumentation

Die Antwort enthält effective_value, source und die geprüfte Rangfolge. Falls Sie einen Einstellungsnamen angegeben haben, ist auch dieser enthalten. Die kompakte Struktur eignet sich gut für Komponententests: Stellen Sie die vom Lader beobachteten Rohwerte zusammen, senden Sie die beabsichtigte Richtlinie und prüfen Sie, ob sowohl der gewählte Wert als auch seine Herkunft den Erwartungen entsprechen. Auch bei der Betriebsdiagnose ist das hilfreich. Ein Supportwerkzeug kann zeigen, dass eine Zeitüberschreitung aus einer Umgebungsvariable statt aus einer versionierten Datei stammt, ohne den gesamten Anwendungsstart nachzustellen. Dokumentationsteams können Beispiele geschichteter Einstellungen in ausführbare Demonstrationen verwandeln. Der Resolver liest absichtlich weder die Umgebung des Hostprozesses noch Konfigurationsdateien und interpretiert keine CLI-Syntax. Aufrufende müssen die Eingaben selbst erfassen und entscheiden, ob Geheimnisse übermittelt werden sollen; für reine Rangfolgentests sind harmlose Platzhalter vorzuziehen. Jede Anfrage löst eine Einstellung auf und kostet über die API $0.002; der Browserpfad der Stufe A nutzt dieselbe reine Logik. Ohne Netzwerk, Zufall, Uhr oder veränderlichen Zustand bleiben identische Anfragen stabil und leicht vergleichbar oder zwischenspeicherbar.