Node.js मैनुअल, भाग 4: npm, package.json और package-lock.json फ़ाइलें

आज हम Node.js. के अनुवाद का चौथा भाग प्रकाशित कर रहे हैं इस लेख में, हम package-lock.json बारे में बात करना शुरू करेंगे और package-lock.json और package-lock.json की विशेषताओं पर भी विचार package-lock.json ।

Npm मूल बातें

Npm (नोड पैकेज मैनेजर) Node.js पैकेज मैनेजर है। इस सामग्री के पहले भाग में, हमने पहले ही उल्लेख किया था कि अब npm में आधे मिलियन से अधिक पैकेज हैं, जो इसे एक भाषा में लिखे गए कोड का दुनिया का सबसे बड़ा भंडार बनाता है। यह बताता है कि npm में आप लगभग किसी भी कार्य को हल करने के लिए डिज़ाइन किए गए पैकेज पा सकते हैं।

प्रारंभ में, Npm को Node.js के लिए एक पैकेज प्रबंधन प्रणाली के रूप में बनाया गया था, लेकिन आज इसका उपयोग जावास्क्रिप्ट में फ्रंट-एंड प्रोजेक्ट्स को विकसित करने के लिए भी किया जाता है। एनपीएम रजिस्ट्री के साथ बातचीत करने के लिए, उसी नाम की कमांड का उपयोग किया जाता है, जो डेवलपर को बड़ी मात्रा में अवसर प्रदान करता है।

▍-लोडिंग पैकेज

npm कमांड का उपयोग करके, आप रजिस्ट्री से पैकेज डाउनलोड कर सकते हैं। नीचे हम इसके उपयोग के उदाहरणों पर विचार करेंगे।

Depend सभी परियोजना निर्भरता को बढ़ाते हुए

यदि प्रोजेक्ट में package.json फ़ाइल है, तो आप निम्न कमांड के साथ इस प्रोजेक्ट की सभी निर्भरताएँ स्थापित कर सकते हैं:

 npm install 

यह कमांड सब कुछ डाउनलोड करेगा जिसे प्रोजेक्ट को जरूरत है और इन सामग्रियों को node_modules फ़ोल्डर में रखें, यह बनाते हुए कि यह प्रोजेक्ट डायरेक्टरी में मौजूद नहीं है।

▍ एक अलग पैकेज के तहत

एक अलग से निम्नलिखित कमांड के साथ स्थापित किया जा सकता है:

 npm install <package-name> 

आप अक्सर देख सकते हैं कि इस कमांड का उपयोग इतने सरल रूप में नहीं, बल्कि कुछ झंडों के साथ किया जाता है। उन पर विचार करें:

• --save फ्लैग --save पैकेज को स्थापित करने और पैकेज की dependencies अनुभाग में इसके बारे में एक प्रविष्टि जोड़ने की अनुमति देता है। --save फ़ाइल, जो परियोजना की निर्भरता का वर्णन करती है। ये निर्भरताएं परियोजना द्वारा इसकी मुख्य कार्यक्षमता को लागू करने के लिए उपयोग की जाती हैं, वे सर्वर पर इसकी तैनाती के दौरान स्थापित की जाती हैं (एनपीएम 5 जारी होने के बाद, निर्भरता अनुभाग में स्थापित पैकेजों के बारे में प्रविष्टियों को स्वचालित रूप से बनाया जाता है, और इस ध्वज का उपयोग किए बिना)।
• --save-dev फ्लैग आपको पैकेज को स्थापित करने और विकास निर्भरता की सूची वाले खंड में एक प्रविष्टि जोड़ने की अनुमति देता है (अर्थात, परियोजना के विकास के दौरान आवश्यक पैकेज, जैसे परीक्षण के लिए पुस्तकालय, लेकिन package.json अपने संचालन के लिए आवश्यक नहीं हैं package.json फ़ाइल फ़ाइल जिसे devDependencies कहा जाता है।

▍ पैक अपडेट

पैकेज अपडेट करने के लिए, निम्न कमांड का उपयोग करें:

 npm update 

इस कमांड को प्राप्त करने के बाद, npm अपने नए संस्करणों के लिए सभी पैकेजों की जांच करेगा, और यदि वे अपने नए संस्करण पाते हैं जो package.json में निर्दिष्ट पैकेज संस्करण प्रतिबंधों को पूरा करते हैं, तो उन्हें स्थापित करें।

आप एक अलग पैकेज को भी अपग्रेड कर सकते हैं:

 npm update <package-name> 

कुछ संस्करणों के पैकेज लोड करना

मानक पैकेज डाउनलोड के अलावा, एनपीएम उनके विशिष्ट संस्करणों को डाउनलोड करने का भी समर्थन करता है। विशेष रूप से, यह ध्यान दिया जा सकता है कि कुछ पुस्तकालय केवल अन्य पुस्तकालयों की कुछ बड़ी रिलीज के साथ ही संगत होते हैं, अर्थात्, यदि इस तरह के पुस्तकालयों की निर्भरता संस्करणों पर विचार किए बिना स्थापित की गई थी, तो यह उनके काम को बाधित कर सकता है। पैकेज के एक विशिष्ट संस्करण को स्थापित करने की क्षमता उन स्थितियों में उपयोगी है, उदाहरण के लिए, इस पैकेज की नवीनतम रिलीज़ आपके लिए काफी उपयुक्त है, लेकिन यह पता चला है कि इसमें कोई त्रुटि है। पैकेज के एक निश्चित संस्करण के रिलीज की प्रतीक्षा में, आप इसके पुराने लेकिन स्थिर रिलीज का उपयोग कर सकते हैं।

परियोजना द्वारा आवश्यक पुस्तकालयों के विशिष्ट संस्करणों को निर्दिष्ट करने की क्षमता टीम के विकास में उपयोगी है जब सभी टीम के सदस्य बिल्कुल समान पुस्तकालयों का उपयोग करते हैं। उनके नए संस्करणों के लिए परिवर्तन भी केंद्रीय रूप से किया जाता है, package.json प्रोजेक्ट फ़ाइल में परिवर्तन करके।

इन सभी मामलों में, परियोजना द्वारा आवश्यक पैकेज संस्करणों को निर्दिष्ट करने की क्षमता अत्यंत उपयोगी है। Npm सिमेंटिक वर्जनिंग (सेवर) के मानक का अनुसरण करता है।

▍Run लिपियों

package.json फ़ाइल कमांड (स्क्रिप्ट) का वर्णन करने की क्षमता का समर्थन करती है जिसे इस निर्माण का उपयोग करके लॉन्च किया जा सकता है:

 npm <task-name> 

उदाहरण के लिए, फ़ाइल के संबंधित खंड में लिपियों की सूची इस प्रकार है:

 { "scripts": {   "start-dev": "node lib/server-development",   "start": "node lib/server-production" } } 

वेबपैक शुरू करने के लिए इस सुविधा का उपयोग करना बहुत आम है:

 { "scripts": {   "watch": "webpack --watch --progress --colors --config webpack.conf.js",   "dev": "webpack --progress --colors --config webpack.conf.js",   "prod": "NODE_ENV=production webpack -p --config webpack.conf.js", } } 

यह दृष्टिकोण निम्नलिखित सरल निर्माणों के साथ, लंबे कमांड के इनपुट को बदलना संभव है, त्रुटियों से भरा हुआ है:

 $ npm watch $ npm dev $ npm prod 

▍ Npm संकुल कैसे स्थापित करता है?

एनपीएम (या यार्न ) का उपयोग करके पैकेज स्थापित करते समय, दो इंस्टॉलेशन विकल्प उपलब्ध हैं: स्थानीय और वैश्विक।

डिफ़ॉल्ट रूप से, जब आप npm install lodash तरह कमांड का उपयोग करते हैं, तो पैकेज प्रोजेक्ट फ़ोल्डर में स्थित node_modules फ़ोल्डर में दिखाई देता है। इसके अलावा, यदि उपरोक्त आदेश निष्पादित किया गया था, तो lodash लाइब्रेरी की dependencies अनुभाग में lodash लाइब्रेरी के लिए एक प्रविष्टि भी जोड़ेगा package.json जो कि वर्तमान निर्देशिका में है।

पैकेजों की वैश्विक स्थापना -g ध्वज का उपयोग करके की जाती है:

 npm install -g lodash 

ऐसी कमांड को निष्पादित करने से, npm परियोजना के स्थानीय फ़ोल्डर में पैकेज को स्थापित नहीं करता है। इसके बजाय, यह कुछ वैश्विक स्थान पर पैकेज फ़ाइलों की प्रतिलिपि बनाता है। वास्तव में ये फाइलें कहां जाती हैं?

यह पता लगाने के लिए, निम्नलिखित कमांड का उपयोग करें:

 npm root -g 

MacOS या लिनक्स पर, पैकेज फाइलें /usr/local/lib/node_modules में दिखाई दे सकती हैं। विंडोज पर, यह C:\Users\YOU\AppData\Roaming\npm\node_modules जैसा कुछ हो सकता है।

हालाँकि, यदि आप संस्करण नियंत्रण के लिए Node.js nvm का उपयोग करते हैं, तो वैश्विक पैकेज फ़ोल्डर का मार्ग बदल सकता है।

उदाहरण के लिए, मैं nvm का उपयोग करता हूं, और उपरोक्त आदेश मुझे बताता है कि इस पते पर वैश्विक पैकेज स्थापित हैं: /Users/flavio/.nvm/versions/node/v8.9.0/lib/node_modules ।

▍Use और npm के साथ संस्थापित संकुल को निष्पादित करें

स्थानीय रूप से या विश्व स्तर पर node_modules का उपयोग करके स्थापित मॉड्यूल का उपयोग कैसे करें, node_modules फ़ोल्डर में गिर रहे हैं? मान लीजिए कि आपने लोकप्रिय lodash लाइब्रेरी स्थापित की है, जिसमें जावास्क्रिप्ट विकास में उपयोग किए जाने वाले कई सहायक कार्य शामिल हैं:

 npm install lodash 

इस तरह की कमांड node_modules प्रोजेक्ट के स्थानीय फ़ोल्डर में लाइब्रेरी स्थापित करेगी।

अपने कोड में इसका उपयोग करने के लिए, बस require आदेश का उपयोग करके इसे आयात करें:

 const _ = require('lodash') 

क्या होगा अगर पैकेज एक निष्पादन योग्य फ़ाइल है?

इस स्थिति में, निष्पादन योग्य फ़ाइल node_modules/.bin/ folder में node_modules/.bin/ folder जाएगी।

आप देख सकते हैं कि यह तंत्र गायों के पैकेज को स्थापित करके कैसे काम करता है। यह कमांड लाइन के लिए लिखा गया एक कॉमिक प्रोग्राम है। यदि आप इस पैकेट में कुछ पाठ पास करते हैं, कंसोल में, ASCII कला की शैली में, गाय की एक छवि प्रदर्शित की जाएगी जो संबंधित पाठ को "उच्चारण" करती है। अन्य प्राणी पाठ को "आवाज़" दे सकते हैं।

इसलिए, npm install cowsay का उपयोग करके पैकेज स्थापित करने के बाद, npm install cowsay , यह, अपनी निर्भरता के साथ, node_modules में node_modules जाएगा। और छिपे हुए .bin फ़ोल्डर में गायों की बाइनरी फ़ाइलों के लिए प्रतीकात्मक लिंक लिखे जाएंगे।

कैसे उन्हें बाहर ले जाने के लिए?

बेशक, आप प्रोग्राम में कॉल करने के लिए टर्मिनल में ./node_modules/.bin/cowsay जैसे कुछ भी दर्ज कर सकते हैं, यह एक कामकाजी तरीका है, लेकिन npx का उपयोग करने के लिए बेहतर है, npm पैकेज के निष्पादन के लिए एक उपकरण, संस्करण 5.2 के बाद से npm में शामिल है। अर्थात्, हमारे मामले में, हमें निम्नलिखित कमांड की आवश्यकता है:

 npx cowsay 

Npx पैकेज का रास्ता अपने आप मिल जाएगा।

Package.json फ़ाइल

package.json फ़ाइल Node.js पारिस्थितिकी तंत्र पर आधारित कई परियोजनाओं का एक अनिवार्य तत्व है। यदि आपने जावास्क्रिप्ट में प्रोग्राम किया है, चाहे वह सर्वर या क्लाइंट डेवलपमेंट हो, तो संभवतः आपने यह फाइल पहले ही देख ली है। इसकी आवश्यकता क्यों है? आपको उसके बारे में क्या पता होना चाहिए और वह आपको क्या अवसर देता है?

Package.json एक प्रोजेक्ट के लिए एक तरह की मैनिफ़ेस्ट फ़ाइल है। वह डेवलपर के निपटान में कई विविध संभावनाओं को रखता है। उदाहरण के लिए, यह परियोजना में प्रयुक्त उपकरणों के लिए सेटिंग्स के केंद्रीय भंडार का प्रतिनिधित्व करता है। इसके अलावा, यह वह जगह है जहां npm और यार्न स्थापित पैकेजों के नाम और संस्करणों के बारे में जानकारी लिखते हैं।

▍ फ़ाइल संरचना

यहाँ एक साधारण package.json का उदाहरण दिया गया है package.json फ़ाइल:

 { } 

जैसा कि आप देख सकते हैं, यह खाली है। एक निश्चित आवेदन के लिए ऐसी फ़ाइल में क्या मौजूद होना चाहिए, इसके बारे में कोई सख्त आवश्यकता नहीं है। फ़ाइल संरचना की एकमात्र आवश्यकता यह है कि इसे JSON प्रारूप के नियमों का पालन करना चाहिए। अन्यथा, यह फ़ाइल उन प्रोग्रामों द्वारा नहीं पढ़ी जा सकती है जो इसकी सामग्री तक पहुँचने का प्रयास करते हैं।

यदि आप एक Node.js पैकेज बनाते हैं जिसे आप npm के माध्यम से वितरित करने का इरादा रखते हैं, तो सब कुछ मौलिक रूप से बदल जाता है, और आपके package.json में गुणों का एक सेट होना चाहिए जो अन्य लोगों को पैकेज का उपयोग करने में मदद करेगा। हम इस बारे में बाद में बात करेंगे।

यहाँ एक और उदाहरण package.json :

 { "name": "test-project" } 

यह name संपत्ति सेट करता है, जिसका मूल्य उस एप्लिकेशन या पैकेज का नाम है जिसकी सामग्री उसी फ़ोल्डर में निहित है जहां यह फ़ाइल स्थित है।

यहाँ एक और अधिक जटिल उदाहरण है जो मैंने Vue.js का उपयोग करके लिखे गए एक उदाहरण के आवेदन से लिया है:

 { "name": "test-project", "version": "1.0.0", "description": "A Vue.js project", "main": "src/main.js", "private": true, "scripts": {   "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",   "start": "npm run dev",   "unit": "jest --config test/unit/jest.conf.js --coverage",   "test": "npm run unit",   "lint": "eslint --ext .js,.vue src test/unit",   "build": "node build/build.js" }, "dependencies": {   "vue": "^2.5.2" }, "devDependencies": {   "autoprefixer": "^7.1.2",   "babel-core": "^6.22.1",   "babel-eslint": "^8.2.1",   "babel-helper-vue-jsx-merge-props": "^2.0.3",   "babel-jest": "^21.0.2",   "babel-loader": "^7.1.1",   "babel-plugin-dynamic-import-node": "^1.2.0",   "babel-plugin-syntax-jsx": "^6.18.0",   "babel-plugin-transform-es2015-modules-commonjs": "^6.26.0",   "babel-plugin-transform-runtime": "^6.22.0",   "babel-plugin-transform-vue-jsx": "^3.5.0",   "babel-preset-env": "^1.3.2",   "babel-preset-stage-2": "^6.22.0",   "chalk": "^2.0.1",   "copy-webpack-plugin": "^4.0.1",   "css-loader": "^0.28.0",   "eslint": "^4.15.0",   "eslint-config-airbnb-base": "^11.3.0",   "eslint-friendly-formatter": "^3.0.0",   "eslint-import-resolver-webpack": "^0.8.3",   "eslint-loader": "^1.7.1",   "eslint-plugin-import": "^2.7.0",   "eslint-plugin-vue": "^4.0.0",   "extract-text-webpack-plugin": "^3.0.0",   "file-loader": "^1.1.4",   "friendly-errors-webpack-plugin": "^1.6.1",   "html-webpack-plugin": "^2.30.1",   "jest": "^22.0.4",   "jest-serializer-vue": "^0.3.0",   "node-notifier": "^5.1.2",   "optimize-css-assets-webpack-plugin": "^3.2.0",   "ora": "^1.2.0",   "portfinder": "^1.0.13",   "postcss-import": "^11.0.0",   "postcss-loader": "^2.0.8",   "postcss-url": "^7.2.1",   "rimraf": "^2.6.0",   "semver": "^5.3.0",   "shelljs": "^0.7.6",   "uglifyjs-webpack-plugin": "^1.1.1",   "url-loader": "^0.5.8",   "vue-jest": "^1.0.2",   "vue-loader": "^13.3.0",   "vue-style-loader": "^3.0.1",   "vue-template-compiler": "^2.5.2",   "webpack": "^3.6.0",   "webpack-bundle-analyzer": "^2.9.0",   "webpack-dev-server": "^2.9.1",   "webpack-merge": "^4.1.0" }, "engines": {   "node": ">= 6.0.0",   "npm": ">= 3.0.0" }, "browserslist": [   "> 1%",   "last 2 versions",   "not ie <= 8" ] } 

जैसा कि आप देख सकते हैं, बहुत सारी दिलचस्प चीजें हैं। अर्थात्, निम्नलिखित गुणों को यहां प्रतिष्ठित किया जा सकता है:

• name - एप्लिकेशन (पैकेज) का नाम सेट करता है।
• version - आवेदन के वर्तमान संस्करण के बारे में जानकारी शामिल है।
• description - आवेदन का एक संक्षिप्त विवरण।
• main - आवेदन के लिए प्रवेश बिंदु सेट करता है।
• private - यदि यह संपत्ति सही पर सेट true , तो यह पैकेज को गलती से npm पर प्रकाशित होने से रोकता है।
• scripts - Node.js स्क्रिप्ट का एक सेट परिभाषित करता है जिसे चलाया जा सकता है।
• dependencies - इसमें npm संकुल की एक सूची है, जिस पर आवेदन निर्भर करता है।
• devDependencies - एक प्रोजेक्ट को विकसित करते समय उपयोग किए जाने वाले devDependencies पैकेजों की एक सूची होती है, लेकिन तब नहीं जब यह वास्तव में काम करता है
• engines - Node.js संस्करणों की सूची सेट करता है, जिस पर एप्लिकेशन चलता है।
• ब्राउज़रलिस्ट - ब्राउज़रों की सूची (और उनके संस्करणों) को संग्रहीत करने के लिए उपयोग किया जाता है जो एप्लिकेशन को समर्थन करना चाहिए।

इन सभी गुणों का उपयोग या तो एनपीएम द्वारा किया जाता है या अन्य अनुप्रयोगों द्वारा पूरे जीवन चक्र में उपयोग किया जाता है।

पैकेज में उपयोग की जाने वाली सहायक सामग्री

चलो उन गुणों के बारे में बात करते हैं जो package.json में उपयोग किए जा सकते हैं। package.json । यहां हम "पैकेज" शब्द का उपयोग करेंगे, लेकिन पैकेज के बारे में जो कुछ भी कहा गया है वह स्थानीय अनुप्रयोगों के लिए भी सही है जिन्हें पैकेज के रूप में इस्तेमाल करने की योजना नहीं है।

जिन गुणों का हम वर्णन करते हैं उनमें से अधिकांश का उपयोग केवल npm रिपॉजिटरी की जरूरतों के लिए किया जाता है, कुछ का उपयोग प्रोग्राम द्वारा किया जाता है जो समान npm जैसे कोड के साथ इंटरैक्ट करते हैं।

नाम संपत्ति

name संपत्ति पैकेज का नाम निर्धारित करती है:

 "name": "test-project" 

नाम 214 वर्णों से छोटा होना चाहिए, इसमें रिक्त स्थान शामिल नहीं होने चाहिए, इसमें केवल बड़े अक्षरों, हाइफ़न ( - ) और अंडरस्कोर ( _ ) शामिल होने चाहिए।

इसी तरह के प्रतिबंध मौजूद हैं क्योंकि जब कोई पैकेज npm में प्रकाशित होता है, तो इसका नाम पैकेज पेज के URL को बनाने के लिए उपयोग किया जाता है।

यदि आपने सार्वजनिक डोमेन में GitHub पर पैकेज कोड प्रकाशित किया है, तो पैकेज नाम के लिए एक अच्छा विकल्प संबंधित GitHub रिपॉजिटरी का नाम है।

लेखक संपत्ति

author संपत्ति में पैकेज के लेखक के बारे में जानकारी होती है:

 { "author": "Flavio Copes <flavio@flaviocopes.com> (https://flaviocopes.com)" } 

इसे निम्नलिखित प्रारूप में प्रस्तुत किया जा सकता है:

 { "author": {   "name": "Flavio Copes",   "email": "flavio@flaviocopes.com",   "url": "https://flaviocopes.com" } } 

योगदानकर्ताओं की संपत्ति

contributors संपत्ति में परियोजना में योगदान करने वाले लोगों के बारे में जानकारी के साथ एक सरणी है:

 { "contributors": [   "Flavio Copes <flavio@flaviocopes.com> (https://flaviocopes.com)" ] } 

यह संपत्ति इस तरह दिख सकती है:

 { "contributors": [   {     "name": "Flavio Copes",     "email": "flavio@flaviocopes.com",     "url": "https://flaviocopes.com"   } ] } 

कीड़े की संपत्ति

bugs प्रॉपर्टी में प्रोजेक्ट के बग ट्रैकर का लिंक होता है, यह बहुत संभावना है कि इस तरह के लिंक से गिटहब एरर ट्रैकिंग सिस्टम पेज बन जाएगा:

 { "bugs": "https://github.com/flaviocopes/package/issues" } 

मुखपृष्ठ संपत्ति

homepage संपत्ति आपको पैकेज मुखपृष्ठ सेट करने की अनुमति देती है:

 { "homepage": "https://flaviocopes.com/package" } 

संस्करण संपत्ति

version संपत्ति में पैकेज के वर्तमान संस्करण के बारे में जानकारी शामिल है:

 "version": "1.0.0" 

इस संपत्ति का मूल्य बनाते समय, आपको शब्दार्थ संस्करण के नियमों का पालन करना चाहिए। इसका अर्थ है, विशेष रूप से, कि संस्करण संख्या को हमेशा तीन अंकों द्वारा दर्शाया जाता है: xxx

पहला नंबर पैकेज का प्रमुख संस्करण है, दूसरा छोटा संस्करण है, तीसरा पैच संस्करण है।

इन नंबरों को बदलने का एक निश्चित अर्थ है। इस प्रकार, एक पैकेज की रिहाई जिसमें त्रुटियों को केवल सही किया जाता है, पैच संस्करण के मूल्य में वृद्धि की ओर जाता है। यदि एक पैकेज जारी किया जाता है, तो किए गए परिवर्तन पिछले रिलीज के साथ पिछड़े संगत हैं, फिर मामूली संस्करण बदल जाता है। पैकेज के प्रमुख संस्करणों में वे परिवर्तन हो सकते हैं जो इन पैकेजों को पिछले प्रमुख संस्करणों के पैकेजों के साथ असंगत बनाते हैं।

लाइसेंस की संपत्ति

license संपत्ति में पैकेज license जानकारी होती है:

 "license": "MIT" 

कीवर्ड संपत्ति

keywords प्रॉपर्टी में पैकेज कार्यक्षमता से संबंधित कीवर्ड की एक सरणी होती है:

 "keywords": [ "email", "machine learning", "ai" ] 

कीवर्ड का सही चयन लोगों को यह पता लगाने में मदद करता है कि कुछ समस्याओं को हल करने के लिए पैकेज की खोज करते समय उन्हें क्या चाहिए, आपको समूह पैकेज की अनुमति देता है और एनपीएम साइट को देखते हुए जल्दी से उनकी संभावित कार्यक्षमता का मूल्यांकन करता है।

संपत्ति का वर्णन करें

description संपत्ति में पैकेज का संक्षिप्त विवरण होता है:

 "description": "A package to work with strings" 

यह संपत्ति विशेष रूप से महत्वपूर्ण है यदि आप npm में पैकेज प्रकाशित करने की योजना बनाते हैं, क्योंकि यह npm साइट के उपयोगकर्ताओं को पैकेज के उद्देश्य को समझने की अनुमति देता है।

रिपोजिटरी संपत्ति

repository प्रॉपर्टी इंगित करती है कि पैकेज रिपॉजिटरी कहाँ स्थित है:

 "repository": "github:flaviocopes/testing", 

ध्यान दें कि इस संपत्ति के मूल्य में github उपसर्ग है। Npm इस तरह की कुछ अन्य लोकप्रिय सेवाओं के लिए उपसर्गों का भी समर्थन करता है:

 "repository": "gitlab:flaviocopes/testing", "repository": "bitbucket:flaviocopes/testing", 

पैकेज के विकास में उपयोग किए जाने वाले संस्करण नियंत्रण प्रणाली को भी स्पष्ट रूप से सेट किया जा सकता है:

 "repository": { "type": "git", "url": "https://github.com/flaviocopes/testing.git" } 

एक ही पैकेज विभिन्न संस्करण नियंत्रण प्रणालियों का उपयोग कर सकता है:

 "repository": { "type": "svn", "url": "..." } 

संपत्ति मुख्य

main संपत्ति पैकेज के लिए प्रवेश बिंदु निर्धारित करती है:

 "main": "src/main.js" 

जब पैकेज को अनुप्रयोग में आयात किया जाता है, तो यह वह जगह है जहां खोज इसी मॉड्यूल निर्यात के लिए किया जाएगा।

निजी संपत्ति

true सेट की गई private संपत्ति पैकेज को गलती से npm पर प्रकाशित होने से रोकती है:

 "private": true 

संपत्ति का बंटवारा

scripts प्रॉपर्टी उन स्क्रिप्ट या उपयोगिताओं की सूची सेट करती है, जिन्हें npm टूल का उपयोग करके लॉन्च किया जा सकता है:

 "scripts": { "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js", "start": "npm run dev", "unit": "jest --config test/unit/jest.conf.js --coverage", "test": "npm run unit", "lint": "eslint --ext .js,.vue src test/unit", "build": "node build/build.js" } 

ये स्क्रिप्ट कमांड लाइन एप्लिकेशन हैं। क्रमशः npm run XXXX या yarn XXXX , जहां XXXX स्क्रिप्ट का नाम है, को निष्पादित करके आप उन्हें क्रमशः npm या यार्न का उपयोग करके चला सकते हैं। उदाहरण के लिए, यह इस तरह दिख सकता है:

 npm run dev 

लिपियों को आप चाहते हैं के रूप में बुलाया जा सकता है, वे लगभग सब कुछ कर सकते हैं जो एक डेवलपर को चाहिए।

निर्भरता गुण

dependencies संपत्ति में पैकेज निर्भरता के रूप में स्थापित npm संकुल की एक सूची है:

 "dependencies": { "vue": "^2.5.2" } 

Npm या यार्न का उपयोग करके एक पैकेज स्थापित करते समय, निम्न कमांड का उपयोग किया जाता है:

 npm install <PACKAGENAME> yarn add <PACKAGENAME> 

ये पैकेज विकसित किए जा रहे पैकेज की निर्भरता की सूची में स्वचालित रूप से जुड़ जाते हैं।

निर्भरता गुण

विकास निर्भरता के रूप में स्थापित devDependencies पैकेज की सूची में devDependencies संपत्ति शामिल है:

 "devDependencies": { "autoprefixer": "^7.1.2", "babel-core": "^6.22.1" } 

यह सूची dependencies संपत्ति में संग्रहीत एक से अलग है, क्योंकि इसमें उपलब्ध पैकेज केवल पैकेज डेवलपर की प्रणाली में स्थापित हैं, पैकेज के व्यावहारिक उपयोग में, उनका उपयोग नहीं किया जाता है।

पैकेज इस सूची में आते हैं जब वे निम्नानुसार npm या यार्न का उपयोग कर स्थापित होते हैं:

 npm install --dev <PACKAGENAME> yarn add --dev <PACKAGENAME> 

सम्पत्तियाँ संलग्न करता है

engines गुण इंगित करता है कि पैकेज प्रदान करने के लिए Node.js और अन्य सॉफ़्टवेयर उत्पादों के कौन से संस्करण का उपयोग किया जाता है:

 "engines": { "node": ">= 6.0.0", "npm": ">= 3.0.0", "yarn": "^0.13.0" } 

ब्राउज़र सूची संपत्ति

ब्राउज़रलिस्ट प्रॉपर्टी browserlist रिपोर्ट करने देती है browserlist कौन से ब्राउज़र (और उनके संस्करण) पैकेज डेवलपर द्वारा समर्थित होने जा रहे हैं:

 "browserslist": [ "> 1%", "last 2 versions", "not ie <= 8" ] 

इस संपत्ति का उपयोग बैबेल, ऑटोपरिफ़िशर और अन्य उपकरणों द्वारा किया जाता है। इस सूची का विश्लेषण उन्हें पैकेज में केवल उन्हीं पॉलीफ़िल्स और सहायक तंत्रों को जोड़ने की अनुमति देता है जो सूचीबद्ध ब्राउज़रों के लिए आवश्यक हैं।

उदाहरण के रूप में यहां दिखाई गई ब्राउज़र सूची की संपत्ति का मूल्य का मतलब है कि आप कम से कम 1% उपयोग के साथ सभी ब्राउज़रों के कम से कम 2 प्रमुख संस्करणों का समर्थन करना चाहते हैं (यह डेटा CanIUse.com से लिया गया है), इस ब्राउज़र के IE 8 और पुराने संस्करणों के अपवाद के साथ (अधिक) यह ब्राउज़रलिस्ट पैकेज पेज पर पाया जा सकता है)।

विभिन्न सॉफ्टवेयर टूल्स के लिए पैकेज.जॉन सेटिंग्स में softwareस्टोरेज

Package.json में package.json आप बैबल या ESLint जैसे विभिन्न सहायक उपकरणों के लिए सेटिंग्स स्टोर कर सकते हैं।

इनमें से प्रत्येक उपकरण में एक विशेष संपत्ति है, जैसे कि eslintConfig या eslintConfig । ऐसी संपत्तियों के उपयोग पर विवरण संबंधित परियोजनाओं के प्रलेखन में पाया जा सकता है।

.अबाउट पैकेज संस्करण और शब्दार्थ संस्करण

, , , . , ~3.0.0 ^0.13.0 . , , .

, , , , :

• ~ : ~0.13.0 , - . , 0.13.1 , 0.14.0 — .
• ^ : ^0.13.0 , , - . , 0.13.1 , 0.14.0 , .
• * : , , , — .
• > : , .
• >= : , .
• <= : , .
• < : , .
• = : .
• - : , — 2.1.0 - 2.6.2 .
• || : , . < 2.1 || > 2.6 .

:

• : , , - .
• latest : , .

, , -. , 1.0.0 || >=1.1.0 <1.2.0 , 1.0.0 , , 1.1.0 , 1.2.0 .

package-lock.json

package-lock.json npm 5. Node.js-. ? , package.json , .

, , , , .

, package.json . package.json , (- ) .

Git node_modules , . , npm install , , , ~ , -, , , -.

^ . , , , .

, - , npm install . , . , , - , , , ( ) .

package-lock.json npm npm install .

, , ( Composer PHP) .

package-lock.json Git-, , , , , Git .

package-lock.json npm update .

▍ package-lock.json

package-lock.json , cowsay, npm install cowsay :

 { "requires": true, "lockfileVersion": 1, "dependencies": {   "ansi-regex": {     "version": "3.0.0",     "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3. 0.0.tgz",     "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg="   },   "cowsay": {     "version": "1.3.1",     "resolved": "https://registry.npmjs.org/cowsay/-/cowsay-1.3.1.tgz" ,     "integrity": "sha512-3PVFe6FePVtPj1HTeLin9v8WyLl+VmM1l1H/5P+BTTDkM Ajufp+0F9eLjzRnOHzVAYeIYFF5po5NjRrgefnRMQ==",     "requires": {       "get-stdin": "^5.0.1",       "optimist": "~0.6.1",       "string-width": "~2.1.1",       "strip-eof": "^1.0.0"     }   },   "get-stdin": {     "version": "5.0.1",     "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-5.0. 1.tgz",     "integrity": "sha1-Ei4WFZHiH/TFJTAwVpPyDmOTo5g="   },   "is-fullwidth-code-point": {     "version": "2.0.0",     "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/ is-fullwidth-code-point-2.0.0.tgz",     "integrity": "sha1-o7MKXE8ZkYMWeqq5O+764937ZU8="   },   "minimist": {     "version": "0.0.10",     "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.10 .tgz",     "integrity": "sha1-3j+YVD2/lggr5IrRoMfNqDYwHc8="   },   "optimist": {     "version": "0.6.1",     "resolved": "https://registry.npmjs.org/optimist/-/optimist-0.6.1.tgz",     "integrity": "sha1-2j6nRob6IaGaERwybpDrFaAZZoY=",     "requires": {       "minimist": "~0.0.1",       "wordwrap": "~0.0.2"     }   },   "string-width": {     "version": "2.1.1",     "resolved": "https://registry.npmjs.org/string-width/-/string-width-2.1.1.tgz",     "integrity": "sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==",     "requires": {       "is-fullwidth-code-point": "^2.0.0",       "strip-ansi": "^4.0.0"     }   },   "strip-ansi": {     "version": "4.0.0",     "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",     "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=",     "requires": {       "ansi-regex": "^3.0.0"     }   },   "strip-eof": {     "version": "1.0.0",     "resolved": "https://registry.npmjs.org/strip-eof/-/strip-eof-1.0.0.tgz",     "integrity": "sha1-u0P/VZim6wXYm1n80SnJgzE2Br8="   },   "wordwrap": {     "version": "0.0.3",     "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.3.tgz",     "integrity": "sha1-o9XabNXAvAAI03I0u68b7WMFkQc="   } } } 

. cowsay, :

• get-stdin
• optimist
• string-width
• strip-eof

, , , requires , :

• ansi-regex
• is-fullwidth-code-point
• minimist
• wordwrap
• strip-eof

, version , resolved , , integrity , .

npm package.json package-lock.json . npm npx.

प्रिय पाठकों! — npm yarn?