Skip to content
/ util Public

Kumpulan kelas dan fungsi utilitas untuk pengelolaan fungsi asinkron di JavaScript, termasuk mekanisme penguncian, kontrol akses, dan format string.

License

Notifications You must be signed in to change notification settings

ndiing/util

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Modules

string
file
resilience

string

string.toPascalCase(string) ⇒ string

Mengubah string menjadi format PascalCase.

Kind: static method of string
Returns: string - - String dalam format PascalCase.

Param Type Description
string string String input yang akan diubah.

string.toCamelCase(string) ⇒ string

Mengubah string menjadi format camelCase.

Kind: static method of string
Returns: string - - String dalam format camelCase.

Param Type Description
string string String input yang akan diubah.

string.toSnakeCase(string) ⇒ string

Mengubah string menjadi format snake_case.

Kind: static method of string
Returns: string - - String dalam format snake_case.

Param Type Description
string string String input yang akan diubah.

string.toKebabCase(string) ⇒ string

Mengubah string menjadi format kebab-case.

Kind: static method of string
Returns: string - - String dalam format kebab-case.

Param Type Description
string string String input yang akan diubah.

string.toTitleCase(string) ⇒ string

Mengubah string menjadi format Title Case.

Kind: static method of string
Returns: string - - String dalam format Title Case.

Param Type Description
string string String input yang akan diubah.

file

file.read(filename) ⇒ string | null

Membaca konten dari file dengan nama yang diberikan.

Kind: static method of file
Returns: string | null - - Mengembalikan konten file dalam bentuk string atau null jika terjadi kesalahan.

Param Type Description
filename string Nama file yang akan dibaca.

file.write(filename, data)

Menulis data ke file dengan nama yang diberikan. Jika direktori tidak ada, direktori akan dibuat.

Kind: static method of file

Param Type Description
filename string Nama file di mana data akan ditulis.
data string Konten yang akan ditulis ke file.

resilience

resilience.retry(fn, [retries], [delay]) ⇒ Promise.<any>

Mencoba menjalankan fungsi secara berulang hingga berhasil atau mencapai batas retry.

Kind: static method of resilience
Returns: Promise.<any> - - Mengembalikan hasil dari fungsi yang berhasil.
Throws:

  • Error - Melemparkan kesalahan jika semua percobaan gagal.
Param Type Default Description
fn function Fungsi yang akan dicoba. Harus mengembalikan sebuah promise.
[retries] number 3 Jumlah maksimum percobaan sebelum melemparkan kesalahan.
[delay] number 1000 Waktu dalam milidetik untuk menunggu sebelum mencoba lagi setelah gagal.

resilience.timeout(fn, ms) ⇒ Promise.<any>

Menjalankan fungsi dan mengatur batas waktu. Jika fungsi tidak selesai dalam waktu yang ditentukan, akan melemparkan kesalahan "Timeout".

Kind: static method of resilience
Returns: Promise.<any> - - Mengembalikan hasil dari fungsi jika selesai dalam batas waktu.
Throws:

  • Error - Melemparkan kesalahan jika fungsi tidak selesai dalam waktu yang ditentukan.
Param Type Description
fn function Fungsi yang akan dijalankan. Harus mengembalikan sebuah promise.
ms number Waktu maksimum dalam milidetik sebelum timeout.

resilience~CircuitBreaker

Kelas CircuitBreaker untuk mengelola dan melindungi fungsi dari kesalahan yang berulang. Circuit Breaker mencegah fungsi dari pemanggilan berulang ketika kesalahan telah mencapai ambang batas.

Kind: inner class of resilience

new CircuitBreaker([failureThreshold], [resetTimeout])

Param Type Default Description
[failureThreshold] number 3 Ambang batas jumlah kesalahan sebelum sirkuit terbuka.
[resetTimeout] number 5000 Waktu dalam milidetik sebelum sirkuit setengah terbuka setelah terbuka.

circuitBreaker.execute(fn) ⇒ Promise.<any>

Menjalankan fungsi dan menerapkan circuit breaker. Jika sirkuit terbuka, fungsi tidak akan dieksekusi hingga waktu reset berlalu.

Kind: instance method of CircuitBreaker
Returns: Promise.<any> - - Mengembalikan hasil dari fungsi jika berhasil.
Throws:

  • Error - Melemparkan kesalahan jika fungsi gagal atau jika sirkuit terbuka.
Param Type Description
fn function Fungsi yang akan dijalankan. Harus mengembalikan sebuah promise.

circuitBreaker.reset()

Mereset status circuit breaker ke keadaan tertutup dan mengatur ulang hitungan kesalahan.

Kind: instance method of CircuitBreaker

resilience~Bulkhead

Kelas Bulkhead untuk mengelola batas maksimum permintaan yang dapat dieksekusi secara bersamaan. Bulkhead membantu mencegah satu bagian dari aplikasi mempengaruhi bagian lainnya dengan membatasi jumlah permintaan yang dapat diproses dalam waktu bersamaan.

Kind: inner class of resilience

new Bulkhead(maxRequests)

Param Type Description
maxRequests number Jumlah maksimum permintaan yang dapat diproses secara bersamaan.

bulkhead.execute(fn) ⇒ Promise.<any>

Menjalankan fungsi dan mengatur antrian permintaan jika batas maksimum tercapai.

Kind: instance method of Bulkhead
Returns: Promise.<any> - - Mengembalikan hasil dari fungsi jika berhasil.

Param Type Description
fn function Fungsi yang akan dijalankan. Harus mengembalikan sebuah promise.

bulkhead.processQueue()

Memproses antrian permintaan yang menunggu jika ada kapasitas yang tersedia.

Kind: instance method of Bulkhead

resilience~RateLimiter

Kelas RateLimiter untuk membatasi jumlah permintaan yang dapat dilakukan dalam jangka waktu tertentu. Berguna untuk menghindari kelebihan beban pada server atau API.

Kind: inner class of resilience

new RateLimiter(maxRequests, interval)

Param Type Description
maxRequests number Jumlah maksimum permintaan yang diizinkan dalam interval waktu.
interval number Interval waktu dalam milidetik untuk membatasi permintaan.

rateLimiter.execute(fn) ⇒ Promise.<any>

Menjalankan fungsi jika batas permintaan belum terlampaui.

Kind: instance method of RateLimiter
Returns: Promise.<any> - - Mengembalikan hasil dari fungsi jika batas permintaan belum terlampaui.
Throws:

  • Error - Melempar error jika batas permintaan telah terlampaui.
Param Type Description
fn function Fungsi yang akan dijalankan. Harus mengembalikan sebuah promise.

resilience~Mutex

Kelas yang mengimplementasikan mekanisme mutex untuk penguncian sumber daya.

Kind: inner class of resilience

mutex.lock() ⇒ Promise.<void>

Mengunci mutex. Jika sudah terkunci, menunggu sampai dapat mengunci.

Kind: instance method of Mutex
Returns: Promise.<void> - - Sebuah promise yang diselesaikan saat mutex terkunci.

mutex.unlock()

Membuka kunci mutex dan memberi kesempatan kepada antrean untuk mengunci.

Kind: instance method of Mutex

resilience~Semaphore

Kelas yang mengimplementasikan mekanisme semaphore untuk pengelolaan akses ke sumber daya.

Kind: inner class of resilience

new Semaphore(max)

Param Type Description
max number Jumlah maksimum akses yang diizinkan pada satu waktu.

semaphore.acquire() ⇒ Promise.<void>

Mengakuisisi akses semaphore. Jika sudah mencapai maksimum, menunggu sampai ada akses yang dilepaskan.

Kind: instance method of Semaphore
Returns: Promise.<void> - - Sebuah promise yang diselesaikan saat akses diperoleh.

semaphore.release()

Membebaskan akses semaphore, memberi kesempatan kepada antrean untuk mengakuisisi akses.

Kind: instance method of Semaphore

About

Kumpulan kelas dan fungsi utilitas untuk pengelolaan fungsi asinkron di JavaScript, termasuk mekanisme penguncian, kontrol akses, dan format string.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published