Cara menggunakan Kalkulator Semver
- Bandingkan: masukkan dua versi untuk melihat mana yang lebih baru dan alasannya (termasuk prerelease dan build metadata).
- Naikkan: masukkan versi saat ini lalu klik jenis perubahan untuk mendapatkan versi berikutnya — otomatis disalin.
- Cek range: masukkan range npm seperti
^1.2.0,~1.2,1.xatau>=1.2 <2beserta daftar versi. - Baca penjelasan dalam bahasa sederhana dan lihat versi mana yang memenuhi range.
Semantic versioning: MAJOR.MINOR.PATCH
| Bagian | Naik saat… | Contoh |
|---|---|---|
| MAJOR | kamu membuat perubahan yang tidak kompatibel | 1.4.2 → 2.0.0 |
| MINOR | kamu menambah fitur, tetap kompatibel ke belakang | 1.4.2 → 1.5.0 |
| PATCH | kamu memperbaiki bug, tetap kompatibel ke belakang | 1.4.2 → 1.4.3 |
| Prerelease | kamu merilis versi uji coba | 2.0.0-beta.1 |
| Build metadata | kamu memberi tag pada build (diabaikan saat pengurutan) | 1.4.2+sha.5114f85 |
Contekan range npm
| Range | Artinya | Mengizinkan |
|---|---|---|
^1.2.3 | Kompatibel dengan 1.2.3 | >=1.2.3 <2.0.0 |
^0.2.3 | Untuk 0.x, minor dianggap “major” | >=0.2.3 <0.3.0 |
~1.2.3 | Hanya pembaruan patch | >=1.2.3 <1.3.0 |
1.x / 1 | Semua 1.y.z | >=1.0.0 <2.0.0 |
1.2.3 - 2.3 | Range dengan tanda hubung | >=1.2.3 <2.4.0 |
>=1.2 <1.5 || 2.x | Salah satu dari dua set | 1.2.0–1.4.x atau 2.x |
Prerelease hanya cocok dengan range jika ada comparator dalam set yang sama dengan prerelease pada major.minor.patch yang sama — jadi ^1.2.0 tidak cocok dengan 1.3.0-beta.1, tetapi ^1.3.0-beta.0 cocok. Ini mencegah kamu menginstal versi tidak stabil secara tidak sengaja.
Range tersimpan di package.json kamu. Untuk menentukan versi berikutnya dari commit, gunakan Changelog Generator; untuk memberi tag rilis, gunakan Git Command Generator.
Juga dicari sebagai: semver calculator, cek range semver, range versi npm, caret vs tilde, semantic versioning, naikkan versi, bandingkan versi semver, semver prerelease.
Tool yang cocok dipakai bersama Kalkulator Semver
- Generator Workflow GitHub Actions — Pilih stack, pemicu, dan langkahnya, lalu dapatkan .github/workflows/ci.yml yang sudah diberi komentar — install, cache, lint, test, build, matrix versi, dan deploy opsional ke GitHub Pages, Vercel, atau container registry.
- Konverter Basis Angka — Ketik angka dalam basis apa pun dan langsung lihat hasilnya di basis lainnya.
- Pembanding Teks — Tempel versi asli dan versi yang sudah diubah untuk melihat baris yang ditambah, dihapus, dan diubah secara berdampingan, lengkap dengan kata-kata yang berubah yang disorot di dalam setiap baris.
- Validator YAML — Tempel file Docker Compose, manifest Kubernetes, workflow GitHub Actions, atau YAML apa pun untuk menemukan error, menangkap jebakan umum, dan mendapatkan versi yang sudah terformat rapi.
Pertanyaan yang sering diajukan
Bisakah saya memakai ini sebagai semver tester?
Apa perbedaan ^ dan ~ di package.json?
^1.2.3 mengizinkan pembaruan minor dan patch (sampai sebelum 2.0.0). ~1.2.3 hanya mengizinkan pembaruan patch (sampai 1.3.0). Untuk versi 0.x, ^ lebih ketat: ^0.2.3 hanya mengizinkan 0.2.x.