Kas yra package.json failas Node.js'e ir kokią vaidmenį jis atlieka projekte?

package.json yra Node.js projekto manifestas, kuris apima metaduomenis, reikalingus priklausomybių valdymui, statybai ir programos paleidimui.

Pagrindiniai laukai ir jų vaidmuo:

1. name: Projekto pavadinimas.
2. version: Dabartinė versija.
3. description: Trumpas aprašymas.
4. keywords: Raktinių žodžių masyvas projekto aprašymui.
5. homepage: Projekto pagrindinio puslapio URL.
6. bugs: Objekas su informacija apie klaidų sekiklį.
7. license: Licencijos tipas.
8. author: Autoriaus informacija.
9. contributors: Prisidėjusiųjų sąrašas.
10. files: Failų masyvas, įtrauktas į paketo publikavimą.
11. main: Įėjimo taškas į programą (pagrindinis failas).
12. browser: Įėjimo taškas kliento daliai (jei taikoma).
13. bin: Komandos, kurios turėtų būti prieinamos globaliai paketo įdiegimo metu.
14. man: Man puslapių kelių.
15. directories: Projekto katalogų keliai.
16. repository: Informacija apie šaltinio kodo saugyklą.
17. scripts: Objekas su skriptais, kuriuos galima vykdyti naudojant npm.
18. config: Objekas su nustatymais, specifiniais skriptams.
19. dependencies: Objekas su priklausomybėmis, reikalingomis projekto veikimui.
20. devDependencies: Objekas su priklausomybėmis, reikalingomis tik vystymuisi ir testavimui.
21. peerDependencies: Priklausomybės, nuo kurių turi priklausyti ir paketo naudotojas.
22. bundledDependencies: Masivas priklausomybių pavadinimų, kurie turi būti įtraukti į paketą.
23. optionalDependencies: Pasirinktinės priklausomybės, kurios gali būti įdiegtos, bet jų nebuvimas nesukels klaidos.
24. engines: Objekas, nurodantis Node.js ir npm versijas, kurias palaiko projektas.
25. os: Operacinių sistemų masyvas, kuriose veikia projektas.
26. cpu: CPU architektūrų masyvas.
27. preferGlobal: Boolean reikšmė, nurodanti, ar paketas turi būti įdiegtas globaliai.
28. private: Boolean reikšmė, nurodanti, ar paketas yra privatus ir neturi būti publikuojamas npm.
29. publishConfig: Nustatymai paketui publikuoti npm.

{
  "name": "my-node-app", // Projekto pavadinimas
  "version": "1.0.0", // Versija
  "description": "Paprasta Node.js programa",
  "main": "index.js", // Įėjimo taškas
  "scripts": {
    "start": "node index.js", // Paleidimo skriptas
    "test": "echo \"Klaida: nėra nurodyto testo\" && exit 1" // Testavimo skriptas
  },
  "keywords": [
    "node",
    "pavyzdys"
  ],
  "author": "Jūsų vardas",
  "license": "ISC",
  "dependencies": { // Produkcinės priklausomybės
    "express": "^4.18.2"
  },
  "devDependencies": { // Vystymo priklausomybės
    "nodemon": "^2.0.20"
  }
}

package.json atlieka svarbų vaidmenį priklausomybių valdyme (įdiegimas, atnaujinimas, pašalinimas), automatinių užduočių skriptų apibrėžime (paleidimas, testavimas, statyba), projekto metaduomenų teikime npm ir kitų įrankių naudai, taip pat užtikrinant projekto statybos atkuriamumą.