new-js-clock á Thabhairt isteach

open-sourcejavascripttypescriptrelease

Breis agus 15 bliana ó shin, d’fhoilsigh mé breiseán beag jQuery ar a tugadh JS-Clock. Ba ghaireas simplí é a dhéanadh clog ag ticéail a sholáthar laistigh de ghnéithe DOM — úsáideach, simplí, agus go hiomlán de chuid a ama. Bhí sé ag brath ar jQuery, bhí fadhbanna áirithe aige le tacaíocht do chomharthaí iolracha, agus níor nuashonraíodh go brí é riamh tar éis an chéad eisiúna sin.

Inniu, athraíonn sé sin. Tá mé ag eisiúint new-js-clock 1.0.0 — athscríobh TypeScript ón mbun aníos a choinníonn spiorad an bhunleagain agus a fhágann gach teorainn ina dhiaidh. Is féidir leat é a fheiceáil i ngníomh ar an leathanach taispeána.

Cad atá Nua i 1.0.0

Gach rud a tháinig leis an eisiúint seo:

  • 🔒 TypeScript — Sábháilteacht chineáil iomlán le comhéadain chuimsitheacha ar fud an chóid.
  • 🌐 Sraith Tástála E2E + Aonaid — Clúdach Jest cinntitheach móide tástálacha brabhsálaí Selenium E2E, lena n-áirítear bailíochtú iompar na gcluaisíní cúlra.
  • 📦 Nialas Spleáchas — JavaScript vanilla glan. Níl jQuery ag teastáil.
  • 🐛 Deisiúcháin Fabhtanna — Oibríonn tacaíocht do chomharthaí iolracha i gceart anois — ba é sin an príomhfhadhb i leagan 0.8.
  • ⚡ API Nua-Aimseartha — API glan, intuigthe le modhanna sampla cuí ar gach clog a chruthaítear.
  • 🧪 Tástáilte go hIomlán — 162 tástáil Jest chinntithreach le clúdach línte 99.74%, clúdach ráitis 99.02%, clúdach feidhmeanna 100%, agus clúdach brainsí 98.32%.
  • 🐳 Eangach E2E Dockeraithe — Eangach Selenium ag rith Chrome, Firefox agus Edge gan ceann go háitiúil agus in CI trí pnpm run e2e:docker.
  • 📱 Modúil ES — Iompórtálacha Modúil ES le tacaíocht tree-shaking, in éineacht le beart CommonJS agus IIFE.
  • 🌍 Criosanna Ama Feasach DST — Tacaíocht crios ama IANA le láimhseáil uathoibríoch am samhraidh.
  • ⏱️ Mód Uaireoir Cosc — Uaireoir cosc nua a chomhairíonn aníos ó 00:00:00.
  • 🏁 Amanna Lapa agus Scoilte — Taifead amanna lapa (delta) agus amanna carntha (split) i mód uaireoir cosc.
  • 📊 An Lapa is Fearr/is Measa — Feidhmeanna cúnta ionsuite chun an lapa is tapúla agus is moille a aimsiú i seisiún.
  • 🎯 Tomhas Ama Ardtaifeach — Deltas lapa arna dtomhas trí performance.now() le beachtacht faoi bhun millisoicind.

Suiteáil

npm install new-js-clock
# nó
pnpm add new-js-clock

Ar fáil freisin trí CDN le haghaidh úsáide díreach sa bhrabhsálaí — féach an README do naisc unpkg agus jsDelivr.

Cén Fáth ar Thóg Sé Chomh Fada Sin?

Go hionraic? An saol. Scríobhadh an JS-Clock bunaidh de bharr iarrata ó mo chara marbh Gustavo Beltrão (máistir PHP ina lá, ar bhain mé an phribhléid as obair leis ar níos mó ná ócáid amháin) le húsáid i gcláir chumarsáide inmheánacha corparáideacha agus ar láithreáin ghréasáin aon leathanaigh d’imeachtaí a raibh cuairteoirí ó chrios ama éagsúil orthu. Rinne sé a jab go leor nach mothaíodh gá deifir léirmheas a dhéanamh air. Ach tá jQuery imithe i bhfad ó thionscadail nua-aimseartha, tá TypeScript ina chaighdeán do fhorbairt leabharlainne, agus chuir an fabht le tacaíocht chomharthaí iolracha isteach orm i gcónaí. Nuair a shuigh mé síos ar deireadh le é a dheisiú i gceart, bhí ciall lena dhéanamh i gceart — le cineálacha, tástálacha, córas modúl nua-aimseartha agus go leor gnéithe le bheith fíorúsáideach in 2026. Tá mé ag pleanáil é a úsáid i mo chéad tionscadal tráchtála eile freisin.

Is fearr déanach ná riamh.

Go mbeidh glóir ag Íosa Críost amháin!