A JavaScript error occurred in the main process: как исправить

Сообщение A JavaScript error occurred in the main process обычно выглядит пугающе, потому что появляется не на сайте, а в отдельном окне приложения. Часто это Skype, Discord, Slack, Teams, лаунчер, игровой менеджер или другое desktop-приложение, собранное на Electron

Важно понять: это не значит, что "сломался JavaScript в браузере". Это значит, что внутри приложения произошла JavaScript-ошибка в main process — главном процессе приложения

Разберем, что можно безопасно проверить пользователю, а что имеет смысл только разработчику

Что такое main process

Electron позволяет делать desktop-приложения на веб-технологиях: JavaScript, HTML, CSS и Node.js. У Electron есть разные процессы. В официальной документации process.type может показывать browser для main process и renderer для renderer process

Проще:

• main process управляет жизнью приложения, окнами, системными возможностями;
• renderer process отвечает за содержимое окна, похожее на веб-страницу.

Если ошибка произошла в main process, приложение может не открыть окно вообще или упасть сразу на старте

Что сначала прочитать в окне ошибки

Не закрывай окно сразу. Посмотри на строки:

• название приложения;
• путь к файлу;
• Error, TypeError, Cannot find module, Cannot read property;
• строка и номер файла;
• упоминание AppData, node_modules, main.js, asar.

Пример:

Uncaught Exception:
Error: Cannot find module ...

Это может говорить, что приложению не хватает файла или зависимость повреждена

Другой пример:

TypeError: Cannot read properties of undefined

Это уже ошибка логики внутри приложения

Безопасные действия для обычного пользователя

Перезапустить приложение

Закрой приложение полностью. На Windows проверь Task Manager: иногда процесс остается висеть в фоне

Потом запусти снова

Обновить приложение

Если ошибка появилась после старого запуска, поставь актуальную версию приложения с официального сайта или встроенного обновления

Не скачивай "исправители JavaScript error" с непонятных сайтов. Ошибка не лечится отдельным файлом JavaScript

Перезагрузить компьютер

Это скучно, но иногда помогает, если обновление приложения или системы зависло между состояниями

Очистить кэш приложения

Многие Electron-приложения хранят данные в профиле пользователя. На Windows это часто папки:

%AppData%
%LocalAppData%

Но удалять все подряд нельзя. Лучше:

1. Узнать точное имя приложения.
2. Закрыть приложение.
3. Сделать копию папки настроек.
4. Удалить только кэш, если инструкция приложения это рекомендует.

Если там лежат важные данные, настройки или локальные файлы, грубое удаление может навредить

Переустановить приложение

Если обновление и кэш не помогли:

1. Удали приложение обычным способом.
2. Перезагрузи компьютер.
3. Скачай установщик с официального сайта.
4. Установи заново.

Для приложений вроде Skype или Discord это часто быстрее, чем искать один битый файл

Если ошибка появилась после запуска Windows

Иногда окно всплывает сразу после входа в систему. Тогда нужно понять, какое приложение стартует автоматически

На Windows:

1. Открой Task Manager.
2. Перейди на вкладку Startup apps.
3. Посмотри подозрительные или недавно установленные приложения.
4. Отключи автозапуск для приложения, которое вызывает ошибку.
5. Перезагрузи компьютер и проверь.

Если в ошибке путь указывает на временную папку или неизвестную программу, стоит проверить систему антивирусом. Не потому что любая JavaScript-ошибка означает вирус, а потому что неизвестный автозапуск из странной папки — плохой знак

Если ты разработчик Electron-приложения

Тут логика другая: нужно читать stack trace и воспроизводить ошибку в dev-режиме

Проверь:

• совпадает ли версия Electron с кодом;
• правильно ли указан main в package.json;
• попадает ли файл main.js в сборку;
• не потерялся ли preload script;
• не вызываешь ли API не из того процесса;
• есть ли нужные файлы после упаковки в asar;
• не отличается ли путь в dev и production.

Пример проблемы:

const { app, BrowserWindow } = require("electron");

app.whenReady().then(() => {
  const win = new BrowserWindow();
  win.loadFile("index.html");
});

Если версия Electron слишком старая для используемого API, код может падать. Если index.html не попал в packaged build, окно тоже может не загрузиться

Как не делать хуже

Не советую:

• скачивать DLL или JS-файлы с форумов;
• удалять всю папку %AppData%;
• чистить реестр случайной утилитой;
• отключать антивирус ради запуска неизвестного приложения;
• ставить старую версию приложения из случайного архива.

Нормальный порядок: прочитать текст ошибки, понять приложение, обновить или переустановить официально, аккуратно проверить кэш и автозапуск

Мини-чеклист диагностики

Ответы на эти вопросы могут быть для вас полезными

Это ошибка JavaScript в браузере?

Обычно нет. Сообщение про main process чаще относится к Electron-приложению, то есть desktop-программе, внутри которой используется JavaScript

Нужно ли скачивать JavaScript, чтобы исправить ошибку?

Нет. Отдельный JavaScript не скачивают. Нужно обновить или исправить конкретное приложение

Почему ошибка появляется в Skype или Discord?

Многие desktop-приложения используют веб-технологии или похожую архитектуру. Если внутри приложения падает JavaScript-код, пользователь видит такое сообщение

Можно ли просто удалить папку приложения из AppData?

Только если понимаешь последствия или сделал копию. В профиле могут быть настройки, кэш, локальные данные и токены входа

Что делать разработчику?

Читать stack trace, запускать приложение в dev-режиме, проверять main process, версии Electron, пути файлов и упаковку

Что почитать дальше по JavaScript

Чтобы двигаться по теме без рывков, рядом лучше открыть:

• Как включить JavaScript в браузере — отличить ошибку приложения от отключенного JavaScript в браузере.
• Java и JavaScript: в чем разница простыми словами — не связывать Electron-ошибку с Java или JDK.
• javascript:void(0): что это и почему ссылка не открывается — разобрать другой частый случай, когда клик не приводит к переходу.
• Promise и AJAX в JavaScript: первый запрос через fetch — понять, как ошибки проявляются при асинхронной работе.