File, URL, dan Browser (fileUrlBrowser.ts)

checkFileExtension

Memeriksa apakah nama file memiliki ekstensi yang sesuai dengan ekstensi yang diperbolehkan.

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
filename	string	Required	Nama file yang akan diperiksa.
allowedExtension	string[]	Required	Daftar ekstensi yang diperbolehkan. Ekstensi harus mencakup titik, misalnya '.jpg'.

Return Value

boolean → true jika nama file mengandung ekstensi yang diperbolehkan, false jika tidak.

getFilenameFromPath

Mengambil nama file dari path yang lengkap (biasanya digunakan untuk path file yang disimpan di database).

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
path	string	Required	String path yang mengarah ke file.

Return Value

string → Nama file yang diambil dari path.

Contoh

• getFilenameFromPath('/uploads/images/sample.jpg') → 'sample.jpg'

convertPathToLink

Mengubah path file yang disimpan dalam database menjadi format URL yang dapat diakses.

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
path	string	Required	Path file yang disimpan di database.

Return Value

string → Path yang dikonversi menjadi URL yang dapat diakses, mengganti bagian 'public' dengan 'storage'.

Contoh

• convertPathToLink('public/uploads/images/sample.jpg') → '/storage/uploads/images/sample.jpg'

convertURLParam

Mengubah objek JavaScript menjadi query parameter URL.

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
obj	Record<string, any>	Required	Objek yang akan dikonversi menjadi query parameter.
mainKey	string	Required	Kunci utama yang akan digunakan dalam parameter URL.

Return Value

string → String query parameter yang dapat digunakan dalam URL.

Contoh

• convertURLParam({ page: 1, filter: ['active', 'pending'] }, 'data') → 'data[page]=1&data[filter][]=active&data[filter][]=pending'

defaultDarkModeCheck

Memeriksa apakah browser sudah memiliki pengaturan untuk dark mode. Jika belum, fungsi ini akan menetapkan pengaturan default berdasarkan preferensi sistem dan menyimpannya dalam localStorage.

Parameter

Tidak ada parameter yang diterima.

Return Value

void → Tidak mengembalikan nilai apa pun. Mengubah class pada elemen root (document.documentElement) untuk menambahkan atau menghapus class dark sesuai dengan mode yang ditetapkan.

getCookie

Mendapatkan nilai cookie berdasarkan nama yang diberikan.

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
name	string	Required	Nama dari cookie yang ingin diambil nilainya.

Return Value

string | null → Nilai cookie jika ditemukan, atau null jika cookie tidak ada.

Contoh

• getCookie('sessionId') → 'abc123'
• getCookie('nonExistent') → null

getUrlParameter

Mendapatkan nilai parameter dari URL berdasarkan nama yang diberikan. Jika nama parameter tidak diberikan, semua parameter URL akan dikembalikan.

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
paramName	string	''	Nama parameter yang ingin diambil. Jika kosong, mengembalikan semua parameter.

Return Value

string | IterableIterator<[string, string]> → Nilai dari parameter yang diminta, atau iterator dari semua parameter dalam URL.

Contoh

• getUrlParameter('id') → '123'
• getUrlParameter() → [ ['id', '123'], ['name', 'John'] ]

setUrlParameter

Menambahkan atau memperbarui parameter di URL saat ini.

Parameter

Nama Parameter	Tipe Data	Default	Deskripsi
paramName	string	Required	Nama parameter yang akan ditambahkan atau diperbarui di URL.
paramValue	string	Required	Nilai parameter yang akan diset.

Return Value

void → Tidak mengembalikan nilai apa pun. Mengubah URL saat ini dengan parameter yang baru ditambahkan atau diperbarui.

Contoh

• setUrlParameter('page', '2') → URL akan diperbarui dengan ?page=2 atau parameter page akan diganti nilainya jika sudah ada.