زمانی که از NPM (مخفف Node Package Manager) استفاده میکنید بهتر است نحوی نسخه بندی پکیج هایش و همچنین مفهوم علامتهای ^ (carets) و ~ (tildes) که قبل از ورژن هر پکیج در فایل package.json نوشته میشوند را بدانید.
قبل از اینکه مفهوم این علامت ها را بدانیم باید با نحوی نسخه بندی با معنا (Semantic Versioning) در NPM آشنا باشیم.
هر نسخه از پکیج های NPM حداقل دارای سه قسمت به نام های Major، Minor و Patch به شرح زیر است:

زمانی عدد این قسمت (عدد اول) از نسخه افزایش مییابد که در پکیج تغییرات بزرگی رخ داده باشند. منظور از تغییرات بزرگ این است که کد هایی که با نسخه قبلی نوشته شدهاند دیگر در این نسخه جدید Major سازگار نیستند.
مثلا اگر از نسخه 5.3.4 به 6.0.0 آپدیت کنید، کد هایی که بر اساس ورژن 5.3.4 نوشته شدهاند دیگر در نسخه 6.0.0 سازگار نیستند و اگر آپدیت کنید ممکن است در پروژهی شما اختلالی به وجود آید!
دو نکته را باید در نظر بگیرید: الف) این تعریف برای پکیج هایی درست است که اصولی نسخه بندی شدهاند. ب) ممکن است شما مثلا از 10% پکیج داخل پروژه تون استفاده کرده باشید و با آپدیت major اختلالی در پروژه تون به وجود نیاید و کاملا با پروژه شما سازگار باشد. بنابراین نمیشود قطعی گفت ناسازگار میشود.
زمانی عدد این قسمت (عدد دوم) از نسخه افزایش مییابد که در پکیج تغییرات جزئی رخ داده باشند. منظور از تغییرات جزئی این است که کد پروژههایی که با نسخه قبلی نوشته شدهاند در نسخه جدید Minor نیز سازگاراند. با این تفاوت که بهبودهایی مثل اضافه شدن ویژگیها و متدهای جدید، بهبود عملکرد توابع و... در این نسخه جدید ایجاد شده است.
زمانی عدد این قسمت (عدد سوم) از نسخه افزایش مییابد که به پکیج وصلههایی (Patch) اضافه شده باشند. منظور از وصله یا پچ تغییرات خیلی جزئی مثل برطرف شدن باگهای ورژن Minor در کد پکیج است. کد پروژههایی که با نسخه قبلی نوشته شدهاند در نسخه جدید Patch (همانند Minor) نیز سازگاراند.
این قسمت از نسخه (قبل از اعداد) سه حالت میتواند داشته باشد:
به طور خلاصه:
"^1.2.3" : 1.2.x , x>=3
"~2.4.1" : 2.x.y , x>=4 , if (x == 4) --> y>=1
"5.3.54" : 5.3.54