메인 프로세스와 렌더러 프로세스 디버깅
Electron에서 메인(Node.js) 프로세스와 렌더러(Chromium DevTools) 프로세스 모두를 위한 디버깅 도구와 기법을 익힙니다.
메인 프로세스와 렌더러 프로세스 디버깅은(는) CoddyKit의 무료 Electron Desktop App Development 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Electron Desktop App Development 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Electron Desktop App Development 강의에는 총 4개의 강의가 포함되어 있습니다.
이 강의의 일부는 아직 번역되지 않았으며 영어로 표시됩니다.
Welcome to Electron Debugging
Ever wondered why your Electron app isn't behaving as expected? Debugging is your superpower! It helps you find and fix issues in your code.
Electron apps have two main types of processes: the Main Process and Renderer Processes. Each needs a different approach to debugging, and we'll cover both!
The Main Process Explained
Think of the Main Process as the brain of your Electron application. It's a Node.js environment that:
- Manages the application's lifecycle (opening, closing).
- Handles native operating system interactions (menus, dialogs).
- Creates and manages renderer processes (your app windows).
Since it's a Node.js environment, we'll debug it like a Node.js application.
Enabling Main Process Debugging
To debug the main process, we need to tell Electron to open a debugging port. You can do this by adding a command line switch when your app starts.
The --inspect flag opens a V8 Inspector Protocol port, which Chrome DevTools can connect to.
const { app, BrowserWindow } = require('electron');
// Add this line BEFORE app.whenReady()
app.commandLine.appendSwitch('inspect', '5858');
app.whenReady().then(() => {
const mainWindow = new BrowserWindow({
width: 800,
height: 600
});
mainWindow.loadFile('index.html');
});
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit();
});Attaching DevTools to Main
Once your Electron app is running with the --inspect flag, you can connect Chrome DevTools to it.
- Open Google Chrome (or Edge).
- Type
chrome://inspectinto the address bar. - Under the 'Devices' section, you should see your Electron app listed with a 'target' and an 'inspect' link. Click 'inspect'.
This opens a dedicated DevTools window for your main process!
Main Process Debug Example
Let's put a breakpoint in our main process code. Run this code, then open chrome://inspect and click 'inspect' on the target. In the DevTools 'Sources' tab, find main.js, click on line 9 to set a breakpoint, and then resume execution. What happens?
const { app, BrowserWindow } = require('electron');
app.commandLine.appendSwitch('inspect', '5858');
app.whenReady().then(() => {
const message = 'Hello from Main Process!';
console.log(message); // Set breakpoint here!
const mainWindow = new BrowserWindow({
width: 400,
height: 300
});
mainWindow.loadFile('index.html');
});
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit();
});The Renderer Process Explained
The Renderer Process is where your user interface lives. Each BrowserWindow in Electron runs in its own renderer process. It's essentially a web browser environment, similar to a tab in Chrome.
- It renders your HTML, CSS, and JavaScript.
- It interacts with the DOM.
- It's isolated from the native OS.
You'll debug renderer processes just like you debug web pages!
Debugging the Renderer Process
Debugging the renderer process is much like debugging a regular web page. Electron provides a simple way to open the Chromium DevTools for any BrowserWindow.
The webContents.openDevTools() method can be called on a BrowserWindow instance to launch the DevTools.
const { app, BrowserWindow } = require('electron');
app.whenReady().then(() => {
const mainWindow = new BrowserWindow({
width: 800,
height: 600,
webPreferences: {
nodeIntegration: false,
contextIsolation: true
}
});
mainWindow.loadFile('index.html');
// Open the DevTools for the renderer process
mainWindow.webContents.openDevTools();
});
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit();
});Renderer Process Debug Example
Let's create a simple renderer process. Run this code. The DevTools for the window will open automatically. In the 'Sources' tab, find index.html or renderer.js (if you link one), set a breakpoint on the alert line, and reload the page. What happens?
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Renderer Debug</title>
</head>
<body>
<h1>Renderer Process Debug</h1>
<button id="myButton">Click Me</button>
<script>
document.getElementById('myButton').addEventListener('click', () => {
const greeting = 'Hello from Renderer!';
alert(greeting); // Set breakpoint here!
console.log(greeting);
});
</script>
</body>
</html>Essential DevTools Features
Both main and renderer process DevTools offer powerful features:
- Console: View logs, run JavaScript commands.
- Sources: Set breakpoints, step through code, inspect variables.
- Network: Monitor network requests (renderer only).
- Elements: Inspect and modify HTML/CSS (renderer only).
- Application: Inspect local storage, session storage (renderer only).
Mastering these will significantly speed up your debugging.
Advanced Debugging Tips
Go beyond basic breakpoints:
- Conditional Breakpoints: Only pause when a condition is true.
- Logpoints: Log variable values without pausing execution.
debugger;keyword: Insert directly into your code to force a pause.console.trace();: See the call stack for a function.
These techniques help pinpoint elusive bugs more efficiently.
Debugging Knowledge Check
You've learned about debugging both Electron processes. Let's see if you can distinguish between them!
Recap: Debugging Electron
Great job! You now understand the core concepts of debugging in Electron:
- The Main Process (Node.js) handles app lifecycle and native interactions, debugged via
chrome://inspectafter enabling the--inspectflag. - Renderer Processes (Chromium) handle the UI, debugged using
mainWindow.webContents.openDevTools(). - Both leverage powerful Chromium DevTools features like breakpoints, console, and source inspection.
Happy bug hunting!
자주 묻는 질문
“메인 프로세스와 렌더러 프로세스 디버깅” 강의는 무료인가요?
네 — “메인 프로세스와 렌더러 프로세스 디버깅” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Electron Desktop App Development 강의 전체를 잠금 해제할 수 있습니다. Electron Desktop App Development 강의에는 총 4개의 강의가 포함되어 있습니다.
“메인 프로세스와 렌더러 프로세스 디버깅”에서 뭘 배우나요?
Electron에서 메인(Node.js) 프로세스와 렌더러(Chromium DevTools) 프로세스 모두를 위한 디버깅 도구와 기법을 익힙니다. 브라우저에서 직접 실행하는 실습 코드로 Electron Desktop App Development을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Electron Desktop App Development을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Electron Desktop App Development은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“메인 프로세스와 렌더러 프로세스 디버깅” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Electron Desktop App Development 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Electron Desktop App Development 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 메인 프로세스와 렌더러 프로세스 디버깅
- Spectron을 사용한 단위 테스트
- 종단 간 테스트 작업 흐름
- Playwright를 활용한 최신 종단 간 테스트