Apa perbedaan antara tilde (~) dan caret (^) di package.json?

Setelah saya upgrade ke stable terbaru nodedan npm, saya mencoba npm install moment --save. Ini menyimpan entri package.jsondengan ^awalan tanda sisipan . Sebelumnya, itu adalah ~awalan tilde .

1. Mengapa perubahan ini dilakukan npm?
2. Apa perbedaan antara tilde ~dan caret ^?
3. Apa kelebihannya dibanding yang lain?

Lihat dokumen NPM dan dokumen semver :

• ~ versi "Kira-kira setara dengan versi", akan memperbarui Anda ke semua versi tambalan di masa depan, tanpa menambah versi minor. ~1.2.3akan menggunakan rilis dari 1.2.3 ke <1.3.0.

• ^ versi "Kompatibel dengan versi", akan memperbarui Anda ke semua versi minor / patch masa depan, tanpa menambah versi utama. ^2.3.4akan menggunakan rilis dari 2.3.4 ke <3.0.0.

Lihat Komentar di bawah.

Saya ingin menambahkan dokumentasi resmi npmjs yang menjelaskan semua metode untuk kekhususan versi termasuk yang disebutkan dalam pertanyaan -

https://docs.npmjs.com/files/package.json

https://docs.npmjs.com/misc/semver#x-ranges-12x-1x-12-

• ~version"Kira-kira setara dengan versi" Lihat npm semver - Tilde Ranges & semver (7)
• ^version"Kompatibel dengan versi" Lihat npm semver - Caret Ranges & semver (7)
• version Harus sama persis dengan versi
• >version Harus lebih besar dari versi
• >=version dll
• <version
• <=version
• 1.2.x 1.2.0, 1.2.1, dll., Tetapi tidak 1.3.0
• http://sometarballurl (ini mungkin URL tarball yang akan diunduh dan diinstal secara lokal
• * Cocok dengan versi apa pun
• latest Dapatkan rilis terbaru

Daftar di atas tidak lengkap. Penentu versi lain termasuk url GitHub dan repo pengguna GitHub, jalur lokal dan paket dengan tag npm tertentu

npm memungkinkan menginstal versi paket yang lebih baru dari yang ditentukan. Menggunakan tilde ( ~) memberi Anda rilis perbaikan bug dan caret ( ^) memberi Anda fungsionalitas baru yang kompatibel juga.

Masalahnya adalah versi lama biasanya tidak menerima perbaikan bug sebanyak itu, jadi npm menggunakan caret ( ^) sebagai default untuk --save.

Menurut: "Semver menjelaskan - mengapa ada tanda sisipan (^) di package.json saya?" .

Perhatikan bahwa aturan berlaku untuk versi di atas 1.0.0 dan tidak setiap proyek mengikuti versi semantik. Untuk versi 0.xx, tanda sisir hanya memperbolehkan pembaruan tambalan , artinya berperilaku sama dengan tilde. Lihat "Rentang Karet"

Inilah penjelasan visual dari konsep-konsep tersebut:

Sumber: "Cheatsheet Semantic Versioning" .

Semver

<major>.<minor>.<patch>-beta.<beta> == 1.2.3-beta.2

• Gunakan kalkulator semver npm untuk pengujian. (Meskipun penjelasan untuk ^ (termasuk segala sesuatu yang lebih besar dari versi tertentu dalam rentang utama yang sama) dan ~ (termasuk semuanya lebih besar dari versi tertentu dalam rentang minor yang sama) tidak 100% benar, kalkulator tampaknya berfungsi dengan baik )
• Atau, gunakan SemVer Check sebagai gantinya, yang tidak mengharuskan Anda untuk memilih paket dan juga menawarkan penjelasan.

Izinkan atau larang perubahan

• Versi pin: 1.2.3.
• Gunakan ^(seperti kepala). Mengizinkan pembaruan pada level bukan nol kedua dari kiri: ^0.2.3berarti 0.2.3 <= v < 0.3.
• Gunakan ~(seperti ekor). Umumnya membeku paling kanan tingkat atau menetapkan nol jika dihilangkan:
  • ~1 cara 1.0.0 <= v < 2.0.0
  • ~1.2berarti 1.2.0 <= v < 1.3.0.
  • ~1.2.4berarti 1.2.4 <= v < 1.3.0.
• Ommit level paling kanan: 0.2berarti 0.2 <= v < 1. Berbeda dari ~karena:
  • Memulai versi level yang dihilangkan selalu 0
  • Anda dapat mengatur mulai versi utama tanpa menentukan sublevel.

Semua kemungkinan (semoga)

Atur mulai tingkat utama dan biarkan pembaruan ke atas

*  or "(empty string)   any version
1                         v >= 1

Bekukan level utama

~0 (0)            0.0 <= v < 1
0.2               0.2 <= v < 1          // Can't do that with ^ or ~ 
~1 (1, ^1)        1 <= v < 2
^1.2              1.2 <= v < 2
^1.2.3            1.2.3 <= v < 2
^1.2.3-beta.4     1.2.3-beta.4 <= v < 2

Bekukan level minor

^0.0 (0.0)        0 <= v < 0.1
~0.2              0.2 <= v < 0.3
~1.2              1.2 <= v < 1.3
~0.2.3 (^0.2.3)   0.2.3 <= v < 0.3
~1.2.3            1.2.3 <= v < 1.3

Bekukan tingkat patch

~1.2.3-beta.4     1.2.3-beta.4 <= v < 1.2.4 (only beta or pr allowed)
^0.0.3-beta       0.0.3-beta.0 <= v < 0.0.4 or 0.0.3-pr.0 <= v < 0.0.4 (only beta or pr allowed)
^0.0.3-beta.4     0.0.3-beta.4 <= v < 0.0.4 or 0.0.3-pr.4 <= v < 0.0.4 (only beta or pr allowed)

Larang pembaruan

1.2.3             1.2.3
^0.0.3 (0.0.3)    0.0.3

Perhatikan : Hilang mayor, minor, tambalan atau menentukan betatanpa nomor, sama dengan anyuntuk level yang hilang.

Perhatian : Ketika Anda menginstal paket yang memiliki 0tingkat utama, pembaruan hanya akan menginstal versi tingkat beta / pr baru! Itu karena npmset ^sebagai default package.jsondan ketika versi yang diinstal seperti 0.1.3, itu membekukan semua tingkat utama / minor / patch.

• https://docs.npmjs.com/misc/semver
• https://docs.npmjs.com/files/package.json#dependencies

~perbaikan nomor besar dan kecil. Ini digunakan ketika Anda siap untuk menerima perbaikan bug dalam ketergantungan Anda, tetapi tidak ingin ada perubahan yang berpotensi tidak kompatibel.

^memperbaiki nomor utama saja. Ini digunakan ketika Anda mengamati dengan cermat dependensi Anda dan siap untuk dengan cepat mengubah kode Anda jika rilis minor tidak kompatibel.

Selain itu, ^yang tidak didukung oleh versi NPM tua, dan harus digunakan dengan hati-hati.

Jadi, ^ini adalah standar yang baik, tetapi tidak sempurna. Saya sarankan untuk hati-hati memilih dan mengkonfigurasi operator semver yang paling berguna bagi Anda.

~: Cukup dekat dengan

   ~1.1.5: 1.1.0 <= accepted < 1.2.0

^: Kompatibel dengan

   ^1.1.5: 1.1.5 <= accepted < 2.0.0

   ^0.1.3: 0.1.3 <= accepted < 0.2.0

   ^0.0.4: 0.0.4 <= accepted < 0.1.0

^adalah 1. [apa saja]. [apa saja] (versi minor terbaru)
~adalah 1.2. [apa saja] (patch terbaru)

Bacaan yang bagus adalah posting blog ini tentang bagaimana semver berlaku untuk npm
dan apa yang mereka lakukan untuk membuatnya cocok dengan standar semver
http://blog.npmjs.org/post/98131109725/npm-2-0-0

Topi yang cocok dapat dianggap "rusak" karena wont memperbarui ^0.1.2ke 0.2.0. Ketika perangkat lunak muncul, gunakan 0.x.yversi dan pencocokan topi hanya akan cocok dengan angka terakhir yang bervariasi ( y). Ini dilakukan dengan sengaja. Alasannya adalah bahwa sementara perangkat lunak berevolusi API berubah dengan cepat: suatu hari Anda memiliki metode ini dan hari lain Anda memiliki metode tersebut dan yang lama hilang. Jika Anda tidak ingin memecahkan kode untuk orang-orang yang sudah menggunakan perpustakaan Anda, Anda pergi dan menambah versi utama: misalnya 1.0.0-> 2.0.0-> 3.0.0. Jadi, pada saat perangkat lunak Anda akhirnya selesai 100% dan fitur lengkap akan seperti versi 11.0.0dan itu tidak terlihat sangat berarti, dan sebenarnya terlihat membingungkan. Sebaliknya, jika Anda menggunakan 0.1.x->0.2.x->0.3.xversi kemudian pada saat perangkat lunak akhirnya 100% selesai dan fitur lengkap dirilis sebagai versi 1.0.0dan itu berarti "Rilis ini adalah layanan jangka panjang, Anda dapat melanjutkan dan menggunakan versi perpustakaan ini dalam kode produksi Anda, dan penulis tidak akan mengubah semuanya besok, atau bulan depan, dan dia tidak akan meninggalkan paket ".

Aturannya adalah: gunakan 0.x.yversi ketika perangkat lunak Anda belum jatuh tempo dan lepaskan dengan menambah digit tengah ketika API publik Anda berubah (karena itu orang yang ^0.1.0tidak akan mendapatkan 0.2.0pembaruan dan tidak akan merusak kode mereka). Kemudian, ketika perangkat lunak matang, lepaskan di bawah 1.0.0dan tambahkan digit paling kiri setiap kali perubahan API publik Anda (karena itu orang yang ^1.0.0tidak akan mendapatkan 2.0.0pembaruan dan tidak akan merusak kode mereka).

Given a version number MAJOR.MINOR.PATCH, increment the:

MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.

~ Tilde:

• ~membekukan angka besar dan kecil.
• Ini digunakan ketika Anda siap untuk menerima perbaikan bug dalam ketergantungan Anda, tetapi tidak ingin ada perubahan yang berpotensi tidak kompatibel.
• Tilde cocok dengan versi minor terbaru (angka tengah).
• ~ 1.2.3 akan cocok dengan semua versi 1.2.x, tetapi akan kehilangan 1.3.0.
• Tilde (~) memberi Anda rilis perbaikan bug

^ Caret:

• ^ membekukan nomor utama saja.
• Ini digunakan ketika Anda mengamati dengan cermat dependensi Anda dan siap untuk dengan cepat mengubah kode Anda jika rilis minor tidak kompatibel.
• Ini akan memperbarui Anda ke versi utama terbaru (nomor pertama).
• ^ 1.2.3 akan cocok dengan rilis 1.xx apa pun termasuk 1.3.0, tetapi akan bertahan pada 2.0.0.
• Caret (^) juga memberi Anda fungsionalitas baru yang kompatibel dengan mundur.

Tilde ~ cocok dengan versi minor, jika Anda telah menginstal sebuah paket yang memiliki 1.4.2 dan setelah instalasi Anda, versi 1.4.3 dan 1.4.4 juga tersedia jika di package.json itu digunakan sebagai ~ 1.4.2 kemudian npm install di proyek Anda setelah peningkatan akan menginstal 1.4.4 di proyek Anda. Tetapi ada 1.5.0 tersedia untuk paket itu maka itu tidak akan diinstal oleh ~. Ini disebut versi minor.

Caret ^ cocok dengan versi utama, jika paket 1.4.2 diinstal di proyek Anda dan setelah instalasi Anda 1.5.0 dirilis maka ^ akan menginstal versi utama. Itu tidak akan memungkinkan untuk menginstal 2.1.0 jika Anda memilikinya ^ 1.4.2 .

Versi tetap jika Anda tidak ingin mengubah versi paket pada setiap instalasi kemudian menggunakan versi tetap tanpa karakter khusus apa pun misalnya "1.4.2"

Versi Terbaru * Jika Anda ingin menginstal versi terbaru maka hanya gunakan * di depan nama paket.

Penjelasan satu liner

Sistem versi standar adalah major.minor.build (mis. 2.4.1)

npm memeriksa dan memperbaiki versi paket tertentu berdasarkan karakter-karakter ini

~ : versi utama sudah diperbaiki, versi minor sudah diperbaiki, cocok dengan semua nomor build

misal: ~ 2.4.1 berarti ia akan memeriksa 2.4.x di mana x adalah apa saja

^ : versi utama sudah diperbaiki, cocok dengan versi minor apa pun, cocok dengan nomor build apa pun

misalnya: ^ 2.4.1 berarti ia akan memeriksa 2.xx di mana x adalah apa saja

Anda mungkin telah melihat tilde (~) dan caret (^) di package.json. Apa perbedaan di antara mereka?

Ketika Anda melakukan npm install moment --save, ia menyimpan entri di package.json dengan awalan tanda sisipan (^).

The tilde (~)

Dalam istilah yang paling sederhana, tilde (~) cocok dengan versi minor terbaru (angka tengah). ~ 1.2.3 akan cocok dengan semua versi 1.2.x tetapi akan kehilangan 1.3.0.

Tanda sisipan (^)

Karet (^), di sisi lain, lebih santai. Ini akan memperbarui Anda ke versi utama terbaru (nomor pertama). ^ 1.2.3 akan cocok dengan rilis 1.xx apa pun termasuk 1.3.0, tetapi akan ditunda pada 2.0.0.

Referensi: https://medium.com/@Hardy2151/caret-and-tilde-in-package-json-57f1cbbe347b

semver terpisah menjadi 3 bagian utama yang dipecah oleh titik-titik.

major.minor.patch
1.0.0

Perbedaan utama, minor dan patch ini digunakan untuk mengidentifikasi rilis yang berbeda. tide (~) dan caret (^) digunakan untuk mengidentifikasi versi minor dan patch mana yang akan digunakan dalam versi paket.

~1.0.1
 Install 1.0.1 or **latest patch versions** such as 1.0.2 ,1.0.5
^1.0.1
 Install 1.0.1 or **latest patch and minor versions** such as 1.0.2 ,1.1.0 ,1.1.1

Tilde (~)

versi utama diperbaiki, versi minor diperbaiki, cocok dengan nomor build apa pun

"express": "~4.13.3" 

~4.13.3 berarti ia akan memeriksa 4.13.x di mana x adalah apa saja dan 4.14.0

Caret (^)

versi mayor diperbaiki, cocok dengan versi minor apa pun, cocok dengan nomor build apa pun

"supertest": "^3.0.0"

^3.0.0 berarti ia akan memeriksa 3.xx di mana x adalah apa pun

Nomor versi dalam sintaksis yang menunjuk setiap bagian dengan makna yang berbeda. sintaksis dipecah menjadi tiga bagian yang dipisahkan oleh titik.

major.minor.patch 1.0.2

Major, minor dan patch mewakili rilis yang berbeda dari suatu paket.

npm menggunakan tilde (~) dan caret (^) untuk menentukan versi patch dan minor yang digunakan masing-masing.

Jadi jika Anda melihat ~ 1.0.2 artinya menginstal versi 1.0.2 atau versi patch terbaru seperti 1.0.4. Jika Anda melihat ^ 1.0.2 itu berarti menginstal versi 1.0.2 atau versi minor atau patch terbaru seperti 1.1.0.

karat ^ mencakup segala sesuatu yang lebih besar dari versi tertentu dalam rentang utama yang sama.

tilde ~ menyertakan semua yang lebih besar dari versi tertentu dalam rentang minor yang sama.

Misalnya, untuk menentukan rentang versi yang dapat diterima hingga 1.0.4, gunakan sintaks berikut:

• Rilis tambalan: 1.0 atau 1.0.x atau ~ 1.0.4
• Rilis minor: 1 atau 1.x atau ^ 1.0.4
• Rilis besar: * atau x

Untuk informasi lebih lanjut tentang sintaks versi semantik, lihat kalkulator semver npm .

Lebih banyak dari dokumentasi npm Tentang versi semantik

Bukan jawaban, per se, tapi pengamatan yang tampaknya telah diabaikan.

Deskripsi untuk rentang karat:

lihat: https://github.com/npm/node-semver#caret-ranges-123-025-004

Mengizinkan perubahan yang tidak mengubah digit paling kiri yang bukan nol di tupel [utama, kecil, tambalan].

Berarti ^10.2.3cocok10.2.3 <= v < 20.0.0

Saya tidak berpikir itu yang mereka maksudkan. Menarik versi 11.xx hingga 19.xx akan merusak kode Anda.

Saya pikir mereka maksudkan left most non-zero number field. Tidak ada dalam SemVer yang mengharuskan bidang angka menjadi satu digit.

~ spesifikasi untuk rilis versi minor ^ menentukan rilis versi utama

Sebagai contoh jika versi paket 4.5.2, pada Pembaruan ~ 4.5.2 akan menginstal versi 4.5.x terbaru (MINOR VERSION) ^ 4.5.2 akan menginstal versi 4.xx terbaru (VERSION UTAMA)

Terkait dengan pertanyaan ini, Anda dapat meninjau dokumentasi Komposer pada versi , tetapi singkatnya di sini:

• Rentang Versi Tilde ( ~ ) - ~ 1.2.3 setara dengan> = 1.2.3 < 1.3.0
• Rentang Versi Karet ( ^ ) - ~ 1.2.3 setara dengan> = 1.2.3 < 2.0.0

Jadi, dengan Tilde Anda akan mendapatkan pembaruan tambalan secara otomatis tetapi versi minor dan utama tidak akan diperbarui. Namun, jika Anda menggunakan Caret, Anda akan mendapatkan tambalan dan versi minor, tetapi Anda tidak akan mendapatkan versi utama (melanggar perubahan).

Versi Tilde dianggap pendekatan yang "lebih aman", tetapi jika Anda menggunakan dependensi yang dapat diandalkan (pustaka yang dikelola dengan baik) Anda seharusnya tidak memiliki masalah dengan Versi Caret (karena perubahan kecil seharusnya tidak melanggar perubahan.

Anda mungkin harus meninjau posting stackoverflow ini tentang perbedaan antara pemasangan komposer dan pembaruan komposer .