Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-02-26

1 JavaScript, как и любой другой язык, содержит внутри себя много готовых функций и модулей, облегчающих разработку. Все вместе они составляютстандартную библиотеку языка. В Node.js, например, это модули для работы с криптографией (шифрование), HTTP, файловой системой и многим другим. В браузере этот набор значительно меньше, но тоже присутствует.

2 Какой бы хорошей ни была стандартная библиотека, она не может покрыть все задачи, возникающие во время разработки. Конечно, можно все недостающие компоненты реализовывать самостоятельно, но тогда разработка любого проекта превратится в бесконечный марафон. Слишком много типовых задач нужно решить в любом нетривиальном проекте.

3 В коммерческих проектах используются миллионы строк стороннего кода, написанные программистами по всему миру. Подобный код хранится в библиотеках, доступных для установки в проект. В JavaScript-мире их принято называтьпакетами.

4 Какие задачи решают подобные пакеты? Совершенно разные. От небольших полезных функций для работы со строками или<a>датами</a>, до фреймворков, программных систем, формирующих архитектуру кода. Например, в JavaScript невероятно популярна библиотека<a>lodash</a>. Она предоставляет около сотни полезных функций, решающих типовые задачи по работе с массивами, строками и другими типами данных. Пара примеров:

5 Каждая из этих функций по отдельности может выглядеть небольшой. Однако чем больше проект, тем больше требуется подобных функций, и все вместе они превращаются в довольно большую кодовую базу. А ведь еще хотелось бы иметь хорошую документацию.

6 Обратите внимание на то, как происходит импорт кода из внешних библиотек. В этом случае имя пакета указывается без указания пути ./. Так JavaScript понимает, что это именно пакет и не нужно искать файл с именемlodash.js.

7 <h2>Установка</h2>

8 - Если просто импортироватьlodashв коде и затем запустить код на выполнение, то программа упадет с ошибкой: "lodash не найден". Для того чтобы воспользоваться сторонним пакетом, его нужно добавить в проект какзависимость. Так говорят потому, что код проекта теперь зависит от этих библиотек. Для этого вnpmпредусмотрена команда установки:

8 + Если просто импортироватьlodashв коде и затем запустить код на выполнение, то программа упадет с ошибкой: "lodash не найден". Для того чтобы воспользоваться сторонним пакетом, его нужно добавить в проект какзависимость. Так говорят потому, что код проекта теперь зависит от этих библиотек. Для этого вnpmп��едусмотрена команда установки:

9 Эта команда выполняет три действия. Сначала она скачивает пакет из NPM-хранилища в директориюnode_modulesв корне проекта. Если этой директории не было, то она автоматически создается. Затем она добавляет запись вpackage.jsonо том, что пакетlodashстал зависимостью. И наконец, создает или обновляет файлpackage-lock.json.

10 Зависимости вpackage.jsonдобавляются под ключом dependencies. Здесь указаны все пакеты, используемые в проекте и не входящие в стандартную библиотеку.

11 В качестве ключа в зависимостях указывается имя пакета. Именно это имя используется при импорте пакета. Значением является последняя доступная версия на момент скачивания.

12 Теперь, когда Node.js встречает подобный импорт:

13 Происходит попытка импортировать модуль изnode_modules/react/...

14 Осталось разобраться с файломpackage-lock.json. Мы расскажем о его предназначении позже в курсе, а сейчас опишем его общую концепцию.

15 Если кратко, то у зависимостей нашего проекта есть свои зависимости, а у них, в свою очередь, свои зависимости (зависимости зависимостей называются транзитивными зависимостями). Подобная цепочка может быть довольно длинной и на разных ее участках возможно появление одних и тех же пакетов, но разных версий.package-lock.jsonсодержит описаниевсех пакетов, которые будут поставлены, включая все их зависимости с указанием конкретных версий. Это позволяет получать гарантированно одни и те же версии зависимостей для всех разработчиков проекта. Этот файл создается командой npm install и потом используется при установке зависимостей. При наличииpackage-lock.jsonв проекте, установку зависимостей рекомендуется выполнять командой npm ci

16 <h2>Связь с GIT</h2>

17 Программисты не так часто делают проекты "с нуля". Чаще всего они работают с готовыми проектами. Проекты же, в свою очередь, хранятся в git-репозиториях. Что нужно хранить в репозитории, а что нет, когда мы говорим о зависимостях?

18 Код самих зависимостей не является частью исходного кода. Его всегда добавляют в.gitignore. А вот файлыpackage.jsonиpackage-lock.jsonявляются частью исходного кода и именно через них Node.js узнает о том, какие пакеты нужно поставить в систему.

19 Представьте, что вы клонируете готовый проект с гитхаба на свой компьютер и сразу пробуете запустить. Он упадет с ошибкой, так как код самих зависимостей вnode_modules(как и сама директория) отсутствует. Чтобы он там появился, нужно запустить команду установки уже добавленных зависимостей:

20 Эта команда ничего не меняет в проекте. Она только лишь скачивает зависимости в директориюnode_modules, базируясь на содержимомpackage.jsonи версиях изpackage-lock.json.

21 <h2>Предупреждения</h2>

22 Во время установки зависимостейnpmвыводит много разных сообщений. Среди них встречаются такие:

23 Большинство подобных сообщений не влияют на работу приложения. Они лишь говорят о том что какие-то версии устарели или пакет больше не используется.