Урок 022 минуты чтения
Что такое package.json?
На этой странице
Кратко
package.json - главный манифест Node.js-проекта. В нем описывают имя пакета, версию, scripts, зависимости, тип модулей, entry points и настройки инструментов.
Вопрос
Что такое package.json и какие поля в нем самые важные?
Главное
{
"name": "api-server",
"version": "1.0.0",
"type": "module",
"scripts": {
"dev": "node --watch src/index.js",
"test": "node --test"
},
"dependencies": {
"express": "^5.0.0"
},
"devDependencies": {
"eslint": "^9.0.0"
}
}Важные поля
| Поле | Зачем нужно |
|---|---|
name | Имя проекта или пакета |
version | Версия |
type | CommonJS или ESM для .js |
scripts | Команды проекта |
dependencies | Production-зависимости |
devDependencies | Инструменты разработки |
main | Главная точка входа |
exports | Современное описание публичных entry points |
engines | Требуемые версии Node/npm |
scripts
npm run dev
npm testscripts позволяют стандартизировать команды команды и CI.
type
{
"type": "module"
}Это поле влияет на то, как Node.js интерпретирует .js файлы: как ESM или CommonJS.
Что важно помнить
- Ключевые поля:
name,version,type,scripts,dependencies,devDependencies,exports,engines. "private": trueзащищает приложение от случайной публикации в npm.- Версии зависимостей задают по semver:
^1.2.3разрешает minor и patch,~1.2.3— только patch. - Точные установленные версии фиксирует lockfile, а не
package.json.
Мини-шпаргалка
package.json- манифест проекта.scriptsзадают команды.dependenciesнужны в runtime.devDependenciesнужны для разработки."type": "module"включает ESM для.js.enginesпомогает фиксировать версию Node.js.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.