Instalasi

Pustaka Kalender Jawa bisa dipakai dilingkungan Node maupun Browser

Node

npm install --save @kalenderjawa/pustaka

Browser

Jika anda memakai browser pustaka ini bisa di ambil melalui CDN (Content Delivery Network) di unpkg.com.

Kode berikut akan mengambil pustaka dengan versi terbaru dari CDN

<script src="https://unpkg.com/@kalenderjawa/pustaka"/>

Memakai pustaka dengan import ES6

import * as KalenderJawa from '@kalenderjawa/pustaka'

KalenderJawa.cariKurupTahunJawa(1881).then(/**...*/)

Online Editor

Kalau anda tidak ingin ribet-ribet dengan instalasi anda bisa juga jika anda memakai editor online seperti Codesandbox.

Modul ES6

Pustaka Kalender Jawa juga mendukung penggunaan sistem modul ES6, meskipun saat ini tidak semua browser mendukung fitur ini (cek di caniuse.com).

Manfaat utama dari Modul ES6 adalah kode yang di eksekusi oleh browser bukanlah kode hasil transpilasi dari babel ataupun hasil bundling dari webpack dan biasanya ukuran berkas JavaScript akan menjadi jauh lebih kecil karena tidak adanya polyfill, dsb.

Ada beberapa cara untuk memakai modul ES6 di pustaka ini:

Stabil

Belum release saat ini.

Beta

Mulai versi v1.0.0-beta.8 keatas, paket npm akan disertakan versi pustaka dengan dukungan Modul ES6 tetapi perlu diingat bahwa Modul ES6 pada pustaka saat ini hanya berlaku untuk browser saja!.

Anda bisa mereferensikan paket npm dengan dukungan Modul ES6 ini melalui unpkg.com maupun melalui jsDelivr.

        
<script type="module">
  import { sasi } from 'https://unpkg.com/@kalenderjawa/pustaka@1.0.0-beta.8.esm.0/lib/kalenderjawa.min.mjs'
  
  sasi('mukarom',1999).then( { k, s } => {
    console.log(s.get(k)))
  }
</script>
      

yang perlu menjadi catatan yaitu kode diatas mereferensikan pustaka dengan ekstensi .mjs bukan .js

Eksperimental

Versi ini adalah versi pengembangan dan hanya diperuntukkan bagi pengguna yang memakai browser yang PASTI mendukung modul ES6.

Perbedaan mendasar dengan versi beta maupun stabil adalah pada versi eksperimental tidak terdapat dependensi apapun sehingga ukuran berkas yang akan di download oleh browser jauh lebih kecil dibandingkan dengan versi beta atau stabil.

jsdelivr

 
https://cdn.jsdelivr.net/npm/@kalenderjawa/pustaka@1.0.0-beta.7-native-module-eksperimen
    

Untuk memakai modul di browser pastikan type="module" ditulis pada tag script.

        
<script type="module">
  import { cariKurupTahunJawa } from 'https://cdn.jsdelivr.net/npm/@kalenderjawa/pustaka@1.0.0-beta.7-native-module-eksperimen' 
  
  cariKurupTahunJawa(1999).then( x => {
      console.log(x)
  })
</script>
        
      

Jika ada yang ditanyakan atau kurang jelas silahkan ask atau isi issue di Github.