Terima notifikasi tentang rilis Intlayer yang akan datang
    Dibuat:2025-08-23Terakhir diperbarui:2025-08-23

    Dokumentasi: Fungsi getEnumeration di intlayer

    Deskripsi

    Fungsi getEnumeration mengambil konten yang sesuai dengan kuantitas tertentu berdasarkan kondisi yang telah ditentukan dalam objek enumerasi. Kondisi-kondisi tersebut didefinisikan sebagai kunci, dan prioritasnya ditentukan oleh urutan mereka dalam objek.

    Parameter

    • enumerationContent: QuantityContent<Content>

      • Deskripsi: Sebuah objek di mana kunci mewakili kondisi (misalnya, <=, <, >=, =) dan nilai mewakili konten yang sesuai. Urutan kunci menentukan prioritas pencocokan mereka.
      • Tipe: QuantityContent<Content>
        • Content dapat berupa tipe apa pun.
    • quantity: number

      • Deskripsi: Nilai numerik yang digunakan untuk mencocokkan dengan kondisi dalam enumerationContent.
      • Tipe: number

    Mengembalikan

    • Tipe: Content
    • Deskripsi: Konten yang sesuai dengan kondisi pertama yang cocok dalam enumerationContent. Jika tidak ditemukan kecocokan, maka akan ditangani sesuai dengan implementasi (misalnya, error atau konten fallback).

    Contoh Penggunaan

    Penggunaan Dasar

    import { getEnumeration } from "intlayer";const content = getEnumeration(  {    "<=-2.3": "Anda memiliki kurang dari -2.3",    "<1": "Anda memiliki kurang dari satu",    "2": "Anda memiliki dua",    ">=3": "Anda memiliki tiga atau lebih",  },  2);console.log(content); // Output: "Anda memiliki dua"

    Prioritas Kondisi

    import { getEnumeration } from "intlayer";const content = getEnumeration(  {    "<4": "Anda memiliki kurang dari empat",    "2": "Anda memiliki dua",  },  2);console.log(content); // Output: "Anda memiliki kurang dari empat"

    Kasus Tepi

    • Tidak Ada Kondisi yang Cocok:

      • Jika tidak ada kondisi yang cocok dengan kuantitas yang diberikan, fungsi akan mengembalikan undefined atau menangani skenario default/fallback secara eksplisit.
    • Kondisi Ambigu:

      • Jika kondisi saling tumpang tindih, kondisi yang pertama cocok (berdasarkan urutan objek) yang akan diutamakan.
    • Kunci Tidak Valid:

      • Fungsi mengasumsikan bahwa semua kunci dalam enumerationContent valid dan dapat diurai sebagai kondisi. Kunci yang tidak valid atau format yang salah dapat menyebabkan perilaku yang tidak terduga.
    • Penegakan TypeScript:

      • Fungsi memastikan bahwa tipe Content konsisten di semua kunci, memungkinkan keamanan tipe pada konten yang diambil.

    Catatan

    • Utilitas findMatchingCondition digunakan untuk menentukan kondisi yang sesuai berdasarkan kuantitas yang diberikan.
    Terima notifikasi tentang rilis Intlayer yang akan datang