mager

Mager koleksi kode siap pakai

Maka sesungguhnya bersama kesulitan ada kemudahan

✨ mudah emosi ✨

Table of Contents

• Installation
• API
  • common
    • getChangedFields
    • spellRupiah

Installation

npm

npm i mager

yarn

yarn add mager

API

getChangedFields

Mendapatkan hanya apa yang berubah

getChangedFields(initial, changed, include?) adalah fungsi untuk membandingkan dua objek (initial dan changed) dan mengembalikan hanya properti yang benar-benar berubah — sangat berguna untuk PATCH request atau update minimal data.

getChangedFields( initial: Record, changed: Record, include?: string[] )

parameter

| Parameter | Tipe | Wajib | Deskripsi | | --------- | ----------------------- | ----- | -------------------------------------------------------------------- | | initial | Record<string, any> | ✅ | Objek sebelum perubahan | | changed | Record<string, any> | ✅ | Objek hasil perubahan (input dari user) | | include | string[] (optional) | ❌ | Daftar key yang tetap disertakan meskipun nilainya tidak berubah |

contoh

import { getChangedFields } from 'mager/getChangedFields'

const initialProfile = {
	id: 'user-123', // tetap dikirim
	name: 'Yatno',
	email: '[email protected]',
	age: 25
}

const formInput = {
	id: 'user-123',
	name: 'Yatno Arthur', // berubah
	email: '[email protected]', // tidak berubah
	age: 25 // tidak berubah
}

const payload = getChangedFields(initialProfile, formInput, ['id'])

console.log(payload)
// → { id: 'user-123', name: 'Yatno Arthur' }

/**
 * catatan : id akan selalu disertakan (karena key `id` masuk ke dalam `include`)
 * jika tidak ada perubahan pada value id, value akan diambil dari initial, jika terdapat perubahan value akan diambil dari changed
 **/

spellRupiah

Ubah Angka Jadi Terbilang Bahasa Indonesia

spellRupiah(value) mengubah angka atau string angka menjadi format teks terbilang dalam bahasa Indonesia dan satuan rupiah. Cocok untuk tampilan laporan, kwitansi, nota, atau legalisasi angka. Skala angka hingga Desiliun!

spellRupiah(value: number | string): string

parameter

| Parameter | Tipe | Wajib | Deskripsi | | --- | --- | --- | --- | | value | number \| string | ✅ | Angka yang ingin diubah ke format terbilang. Bisa berupa bilangan desimal atau string. |

contoh

import { spellRupiah } from 'mager/spellRupiah'

const hargaBarang = spellRupiah(14500)
// → "EMPAT BELAS RIBU LIMA RATUS RUPIAH"

const totalHarga = spellRupiah('1000001.05')
// → "SATU JUTA SATU KOMA NOL LIMA RUPIAH"

const profit = spellRupiah(-75)
// → "MINUS TUJUH PULUH LIMA RUPIAH"