Dokumentation: getEnumerationContent Funktion in intlayer

Beschreibung:

Die getEnumerationContent Funktion ruft Inhalte ab, die einer bestimmten Menge basieren auf vordefinierten Bedingungen in einem Enumerationsobjekt entsprechen. Die Bedingungen werden als Schlüssel definiert, und ihre Priorität wird durch die Reihenfolge im Objekt bestimmt.

Parameter:

• enumerationContent: QuantityContent<Content>

  • Beschreibung: Ein Objekt, in dem Schlüssel Bedingungen darstellen (z.B. <=, <, >=, =) und Werte den entsprechenden Inhalt repräsentieren. Die Reihenfolge der Schlüssel definiert ihre Übereinstimmungspriorität.
  • Typ: QuantityContent<Content>
    • Content kann jeden Typ haben.

• quantity: number

  • Beschreibung: Der numerische Wert, der zur Übereinstimmung mit den Bedingungen in enumerationContent verwendet wird.
  • Typ: number

Rückgabewerte:

• Typ: Content
• Beschreibung: Der Inhalt, der der ersten übereinstimmenden Bedingung in enumerationContent entspricht. Wenn keine Übereinstimmung gefunden wird, wird standardmäßig basierend auf der Implementierung gehandhabt (z.B. Fehler oder Fallback-Inhalt).

Beispiel Verwendung:

Grundlegende Verwendung:

import { getEnumerationContent } from "@intlayer/config/client";

const content = getEnumerationContent(
  {
    "<=-2.3": "Sie haben weniger als -2.3",
    "<1": "Sie haben weniger als eins",
    "2": "Sie haben zwei",
    ">=3": "Sie haben drei oder mehr",
  },
  2
);

console.log(content); // Ausgabe: "Sie haben zwei"

Priorität der Bedingungen:

const content = getEnumerationContent(
  {
    "<4": "Sie haben weniger als vier",
    "2": "Sie haben zwei",
  },
  2
);

console.log(content); // Ausgabe: "Sie haben weniger als vier"

Randfälle:

• Keine Übereinstimmende Bedingung:

  • Wenn keine Bedingung mit der angegebenen Menge übereinstimmt, gibt die Funktion entweder undefined zurück oder behandelt das Standard-/Fallback-Szenario explizit.

• Mehrdeutige Bedingungen:

  • Wenn Bedingungen überlappen, hat die erste übereinstimmende Bedingung (basierend auf der Objektordnung) Vorrang.

• Ungültige Schlüssel:

  • Die Funktion geht davon aus, dass alle Schlüssel in enumerationContent gültig und als Bedingungen interpretierbar sind. Ungültige oder fehlerhaft formatierte Schlüssel können unerwartetes Verhalten verursachen.

• TypeScript Durchsetzung:

  • Die Funktion stellt sicher, dass der Content-Typ über alle Schlüssel konsistent ist, was eine Typsicherheit in den abgerufenen Inhalten ermöglicht.

Hinweise:

• Das findMatchingCondition Utility wird verwendet, um die geeignete Bedingung basierend auf der angegebenen Menge zu bestimmen.