Решение ошибки ExecJS: отсутствует среда JavaScript в Rails

Быстрый ответ

Если вам попалась ошибка ExecJS::RuntimeUnavailable, Node.js придёт на выручку:

sudo apt-get install nodejs   # на Debian/Ubuntu, следует поставить незамедлительно!
brew install node             # для пользователей MacOS.

Пользователям Windows рекомендовано обратиться к официальному сайту Node.js для загрузки соответствующей версии. Node.js станет надёжным поставщиком JavaScript-среды выполнения для ExecJS.

Если вы работаете на Linux, рассмотрите возможность установки гема 'therubyracer'. Добавьте его в ваш Gemfile:

gem 'therubyracer', platforms: :ruby

И выполните команду bundle install, чтобы обеспечить вашему проекту доступ к необходимой JS-среде выполнения. В качестве альтернатив можно рассмотреть движки MiniRacer или V8. С полным списком можно ознакомиться в файле README библиотеки execjs.

Если вы работаете над проектом на Rails, убедитесь, что гем 'execjs' присутствует в вашем Gemfile:

gem 'execjs'

С каждым новым гемом, которое вы добавляете, необходимо выполнение bundle install для его корректной установки.

Если проблемы не устранены даже после установки Node.js, проверьте, верно ли настроена системная переменная PATH и указывает ли она на node или nodejs.

Внимание на ExecJS и JavaScript-среды выполнения

Обсудим роли JS-сред выполнения и взаимодействие ExecJS с окружением Ruby.

JavaScript-среда выполнения: Дирижёр

ExecJS — это библиотека Ruby, играющая роль дирижёра в исполнении JavaScript-кода. Работа на месте без JavaScript-среды выполнения.

Подробнее об этом расскажет наш спикер на видео

Вероятные проблемы

• Устаревшая версия Node.js может приводить к конфликтам совместимости.
• Просмотр bundle install после изменения Gemfile приведёт к отсутствию необходимых зависимостей.
• Неадекватное использование опции :platforms может вызвать ошибки при установке гемов.

Если возникли дополнительные вопросы, изучите документацию гемов 'ExecJS' и 'therubyracer' на площадках rubygems и GitHub, а также официальную документацию bundler.

Визуализация

Без ExecJS-среды выполнения: 🚀🔴 (Стартовать не получится!)
С ExecJS-средой выполнения:   🚀✅🌌 (Отправляемся в космос!)

ExecJS можно сравнить со станцией технического обслуживания вашего проекта:

| Ваша система    | Станция тех.обслуживания |
| --------------- | ------------------------ |
| Mac/Linux       | Node.js                  |
| Windows         | V8 или Chakra            |

Убедитесь, что ваш проект в полной готовности к работе.

Погружение глубже: Особенности разных платформ

У каждой операционной системы — свои спецификации:

В Linux:

• Зачастую, команда Node.js — это nodejs, а не node.
• Создание символической ссылки sudo ln -s /usr/bin/nodejs /usr/bin/node может решить эту проблему.

В Windows:

• Установка Node.js автоматически добавит в систему npm.
• Добавление пути к Node.js в системную переменную PATH упрощает работу.

На Mac:

• Homebrew помогает в установке и обновлении Node.js.
• При обновлении версии Node.js используйте brew link --overwrite node для корректной настройки ссылок.

Полезные материалы

1. GitHub – rails/execjs: Запуск JavaScript из Ruby — источник информации и документация.
2. Node.js — Ваш справочник по JS-средам выполнения.
3. Настройка Rails-приложений — Ruby on Rails Guides — инструкция по настройке ExecJS.
4. therubyracer | RubyGems.org | сообщество гемов — Альтернативная JS-среда выполнения.
5. ExecJS и ненайденная JavaScript-среда выполнения – Stack Overflow — обсуждение проблем ExecJS и JS-среды выполнения.
6. execjs | RubyGems.org | сообщество гемов — подробная информация о геме ExecJS.
7. Компиляция активов Rails на Heroku | Heroku Dev Center — рекомендации по работе с Heroku.