Установка через npm

Библиотека cash — это легковесная альтернатива jQuery, обеспечивающая удобную работу с DOM, событиями, анимациями и AJAX-запросами в современных браузерах. Для использования cash в проекте на JavaScript предпочтительно подключать её через npm, что позволяет интегрировать библиотеку в систему сборки и использовать возможности модульной структуры.

Инициализация проекта

Перед установкой cash необходимо убедиться, что проект инициализирован как npm-пакет. Для этого в корневой папке проекта выполняется команда:

npm init -y

Флаг -y автоматически подтверждает значения по умолчанию, создавая файл package.json. Этот файл будет содержать все зависимости проекта, включая cash, и настройки сборки.

Установка библиотеки

Для установки cash используется стандартная команда npm:

npm install cash-dom

После выполнения этой команды в папке node_modules появится библиотека, а package.json обновится, добавив запись в раздел dependencies:

"dependencies": {
  "cash-dom": "^8.1.0"
}

Версия может отличаться в зависимости от актуального релиза на момент установки.

Импорт в проект

Cash можно использовать в проекте как ES-модуль или через CommonJS.

ES-модуль:

import $ from 'cash-dom';

$('.button').on('click', () => {
    console.log('Кнопка нажата');
});

CommonJS:

const $ = require('cash-dom');

$('.button').on('click', () => {
    console.log('Кнопка нажата');
});

Использование ES-модулей рекомендуется для современных проектов с поддержкой сборщиков вроде Webpack или Vite.

Проверка установки

После импорта cash можно проверить корректность работы с DOM:

console.log($('.container').length); // Выведет количество элементов с классом container

Если в консоли браузера отображается корректное число элементов, библиотека подключена успешно.

Интеграция с инструментами сборки

Cash отлично работает с современными сборщиками, включая:

  • Webpack: поддержка tree-shaking позволяет исключить неиспользуемые методы cash, уменьшая итоговый размер сборки.
  • Vite: быстрый hot-reload и прямой импорт ES-модулей без дополнительной конфигурации.
  • Parcel: автоматическая обработка зависимостей без сложных настроек.

Для оптимальной работы следует убедиться, что в конфигурации сборщика указаны файлы node_modules для транспиляции при необходимости (например, если проект использует старые версии браузеров).

Альтернативные способы подключения

Хотя npm является предпочтительным методом, cash также можно подключить через CDN, добавив скрипт в HTML:

<script src="https://cdn.jsdelivr.net/npm/cash-dom/dist/cash.min.js"></script>

При таком способе объект $ автоматически становится глобальным, но это не рекомендуется для крупных проектов с модульной архитектурой, так как теряется контроль версий и возможность tree-shaking.

Автоматическое обновление

Для поддержания актуальной версии cash используется команда:

npm update cash-dom

Она обновляет библиотеку до последней доступной стабильной версии, сохраняя совместимость с другими зависимостями.

Проверка версии

Чтобы узнать текущую установленную версию:

npm list cash-dom

В консоли будет отображен путь к установленной версии, что помогает отслеживать обновления и совместимость с проектом.

Вывод

Установка cash через npm обеспечивает модульность, контроль версий и совместимость с современными инструментами сборки. Такой подход позволяет интегрировать библиотеку в крупные проекты, использовать преимущества tree-shaking и избегать конфликтов с другими скриптами.

Оглавление