diff --git a/docs-translations/ko-KR/api/accelerator.md b/docs-translations/ko-KR/api/accelerator.md index 51401143cb88..d9889bcee98d 100644 --- a/docs-translations/ko-KR/api/accelerator.md +++ b/docs-translations/ko-KR/api/accelerator.md @@ -2,6 +2,8 @@ > 키보드 단축키를 정의합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + Accelerator 는 `+` 문자로 결합된 여러 수식어와 키 코드를 포함할 수 있는 문자열입니다. 그리고 애플리케이션의 키보드 단축키를 정의하는데 사용됩니다. diff --git a/docs-translations/ko-KR/api/app.md b/docs-translations/ko-KR/api/app.md index df0a8e5d7a89..ec0711e693e3 100644 --- a/docs-translations/ko-KR/api/app.md +++ b/docs-translations/ko-KR/api/app.md @@ -2,6 +2,8 @@ > 애플리케이션의 이벤트 생명주기를 제어합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + 밑의 예시는 마지막 윈도우가 종료되었을 때, 애플리케이션을 종료시키는 예시입니다: ```javascript diff --git a/docs-translations/ko-KR/api/browser-window.md b/docs-translations/ko-KR/api/browser-window.md index e45983d08489..106f8aad3b02 100644 --- a/docs-translations/ko-KR/api/browser-window.md +++ b/docs-translations/ko-KR/api/browser-window.md @@ -2,6 +2,8 @@ > 브라우저 윈도우를 생성하고 제어합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + ```javascript // 메인 프로세스에서 const {BrowserWindow} = require('electron') diff --git a/docs-translations/ko-KR/api/clipboard.md b/docs-translations/ko-KR/api/clipboard.md index a689bca00280..75918c6647d8 100644 --- a/docs-translations/ko-KR/api/clipboard.md +++ b/docs-translations/ko-KR/api/clipboard.md @@ -2,6 +2,8 @@ > 시스템 클립보드에 복사와 붙여넣기를 수행합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process) + 다음 예시는 클립보드에 문자열을 쓰는 방법을 보여줍니다: ```javascript diff --git a/docs-translations/ko-KR/api/crash-reporter.md b/docs-translations/ko-KR/api/crash-reporter.md index aef93680436b..9d039eb9d10b 100644 --- a/docs-translations/ko-KR/api/crash-reporter.md +++ b/docs-translations/ko-KR/api/crash-reporter.md @@ -2,6 +2,8 @@ > 원격 서버에 오류 보고를 제출합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process) + 다음은 윈격 서버에 애플리케이션 오류 보고를 자동으로 제출하는 예시입니다: ```javascript diff --git a/docs-translations/ko-KR/api/desktop-capturer.md b/docs-translations/ko-KR/api/desktop-capturer.md index 68fd9847836b..d3c073de95cb 100644 --- a/docs-translations/ko-KR/api/desktop-capturer.md +++ b/docs-translations/ko-KR/api/desktop-capturer.md @@ -3,6 +3,8 @@ > 멀티미디어 소스에 대해 접근하고 [`navigator.webkitGetUserMedia`] API를 통해 > 오디오나 비디오를 데스크톱으로부터 캡쳐할 수 있도록 합니다. +프로세스: [렌더러](../tutorial/quick-start.md#renderer-process) + 다음 예시는 창 제목이 `Electron`인 데스크톱 창에 대해 비디오 캡쳐하는 방법을 보여줍니다. diff --git a/docs-translations/ko-KR/api/dialog.md b/docs-translations/ko-KR/api/dialog.md index 5be216bf50dd..25600602c4ee 100644 --- a/docs-translations/ko-KR/api/dialog.md +++ b/docs-translations/ko-KR/api/dialog.md @@ -2,7 +2,9 @@ > 파일을 열거나 저장하고, 알림을 표시하기 위한 네이티브 시스템 대화 상자를 표시합니다. -다음 예시는 파일과 디렉터리를 다중으로 선택하는 대화 상자를 표시하는 예시입니다: +다음 예시는 파일과 디렉터리를 다중으로 선택프로세스: [메인](../tutorial/quick-start.md#main-process) + +하는 대화 상자를 표시하는 예시입니다: ```javascript const {dialog} = require('electron') diff --git a/docs-translations/ko-KR/api/download-item.md b/docs-translations/ko-KR/api/download-item.md index f51aee13221d..5256c3fb2b5b 100644 --- a/docs-translations/ko-KR/api/download-item.md +++ b/docs-translations/ko-KR/api/download-item.md @@ -2,6 +2,8 @@ > 원격 소스로부터의 파일 다운로드를 제어합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `DownloadItem`은 `EventEmitter`를 상속받았으며 Electron의 다운로드 아이템을 표현합니다. 이 클래스 객체는 `Session` 클래스의 `will-download` 이벤트에 사용되며 사용자가 다운로드 아이템을 다룰 수 있도록 도와줍니다. diff --git a/docs-translations/ko-KR/api/global-shortcut.md b/docs-translations/ko-KR/api/global-shortcut.md index ffd895d80928..c633ace6e3e6 100644 --- a/docs-translations/ko-KR/api/global-shortcut.md +++ b/docs-translations/ko-KR/api/global-shortcut.md @@ -2,6 +2,8 @@ > 애플리케이션에 키보드 포커스가 없을 때도 키보드 이벤트를 받을 수 있도록 합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `globalShortcut` 모듈은 운영체제의 전역 키보드 단축키를 등록/해제 하는 방법을 제공합니다. 이 모듈을 사용하여 사용자가 다양한 작업을 편하게 할 수 있도록 단축키를 정의 할 수 있습니다. diff --git a/docs-translations/ko-KR/api/ipc-main.md b/docs-translations/ko-KR/api/ipc-main.md index d703360df894..0e7f164874f5 100644 --- a/docs-translations/ko-KR/api/ipc-main.md +++ b/docs-translations/ko-KR/api/ipc-main.md @@ -2,6 +2,8 @@ > 메인 프로세스에서 렌더러 프로세스로 비동기 통신을 합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `ipcMain` 모듈은 [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter) 클래스의 인스턴스입니다. 메인 프로세스에서 사용하면, 렌더러 프로세스(웹 페이지)에서 전달된 동기, 비동기 메시지를 주고 받는 방법을 @@ -44,7 +46,7 @@ ipcRenderer.on('asynchronous-reply', (arg) => { ipcRenderer.send('asynchronous-message', 'ping') ``` -## 메시지 리스닝 +## Methods `ipcMain`은 다음과 같은 이벤트 리스닝 메서드를 가지고 있습니다: diff --git a/docs-translations/ko-KR/api/ipc-renderer.md b/docs-translations/ko-KR/api/ipc-renderer.md index 0f8e3ded1942..2d6ff0136aeb 100644 --- a/docs-translations/ko-KR/api/ipc-renderer.md +++ b/docs-translations/ko-KR/api/ipc-renderer.md @@ -2,6 +2,8 @@ > 렌더러 프로세스에서 메인 프로세스로 비동기 통신을 합니다. +프로세스: [렌더러](../tutorial/quick-start.md#renderer-process) + `ipcRenderer` 모듈은 [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter) 클래스의 인스턴스입니다. 렌더러 프로세스에서 메인 프로세스로 동기/비동기 메시지를 주고 받는 방법을 제공합니다. 또한 메인 프로세스로부터 받은 메시지에 @@ -9,7 +11,7 @@ [ipcMain](ipc-main.md)에서 코드 예시를 확인할 수 있습니다. -## 메시지 리스닝 +## Methods `ipcRenderer`는 다음과 같은 이벤트 리스닝 메서드를 가지고 있습니다: diff --git a/docs-translations/ko-KR/api/menu-item.md b/docs-translations/ko-KR/api/menu-item.md index 824d7c4a9fbc..bef54ba5d23e 100644 --- a/docs-translations/ko-KR/api/menu-item.md +++ b/docs-translations/ko-KR/api/menu-item.md @@ -2,6 +2,8 @@ > 네이티브 애플리케이션 메뉴와 컨텍스트 메뉴에 아이템을 추가합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + [`Menu`](menu.md)에서 예시를 확인할 수 있습니다. ## Class: MenuItem diff --git a/docs-translations/ko-KR/api/menu.md b/docs-translations/ko-KR/api/menu.md index 213975eceba8..87c11eb801a6 100644 --- a/docs-translations/ko-KR/api/menu.md +++ b/docs-translations/ko-KR/api/menu.md @@ -2,6 +2,8 @@ > 네이티브 애플리케이션 메뉴와 컨텍스트 메뉴를 생성합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + 각 메뉴는 여러 개의 [메뉴 아이템](menu-item.md)으로 구성되고 서브 메뉴를 가질 수도 있습니다. ## 예시 diff --git a/docs-translations/ko-KR/api/native-image.md b/docs-translations/ko-KR/api/native-image.md index d840f92e8982..da8bd1fdb8cc 100644 --- a/docs-translations/ko-KR/api/native-image.md +++ b/docs-translations/ko-KR/api/native-image.md @@ -2,6 +2,8 @@ > PNG 또는 JPG 파일을 사용하여 트레이, 독, 애플리케이션 아이콘을 생성합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process) + Electron은 파일 경로 또는 `NativeImage` 인스턴스를 통해 이미지를 사용할 수 있는 API를 가지고 있습니다. `null`을 전달할 경우 빈 이미지가 생성됩니다. @@ -142,7 +144,9 @@ Returns `NativeImage` ## Class: NativeImage -네이티브로 랩핑된 트레이, dock, 애플리케이션 아이콘을 위한 이미지입니다. +> 네이티브로 랩핑된 트레이, dock, 애플리케이션 아이콘을 위한 이미지입니다. + +프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process) ### Instance Methods diff --git a/docs-translations/ko-KR/api/net.md b/docs-translations/ko-KR/api/net.md index fa2cdd664e89..ac6b01e6f613 100644 --- a/docs-translations/ko-KR/api/net.md +++ b/docs-translations/ko-KR/api/net.md @@ -2,6 +2,8 @@ > Chromium 의 네이티브 네트워크 라이브러리를 사용한 HTTP/HTTPS 요청 실행. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `net` 모듈은 HTTP(S) 요청을 실행하기 위한 클라이언트 측 API 입니다. 이것은 Node.js 의 [HTTP](https://nodejs.org/api/http.html) 와 [HTTPS](https://nodejs.org/api/https.html) 모듈과 유사합니다. 하지만 Node.js @@ -69,6 +71,8 @@ Returns `ClientRequest` > HTTP/HTTPS 요청을 합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `ClientRequest` 는 [Writable Stream](https://nodejs.org/api/stream.html#stream_writable_streams) 인터페이스를 구현하였고 따라서 @@ -100,7 +104,7 @@ Returns `ClientRequest` 예를 들어, 다음과 같이 'github.com' 에 대한 같은 요청을 만들 수 있습니다: -```JavaScript +```javascript const request = net.request({ method: 'GET', protocol: 'https:', @@ -137,7 +141,7 @@ Returns: * `username` String * `password` String -```JavaScript +```javascript request.on('login', (authInfo, callback) => { callback('username', 'password') }) @@ -146,9 +150,9 @@ request.on('login', (authInfo, callback) => { 빈 자격증명을 제공하면 요청이 취소되고 응답 객체에서 인증 오류가 보고될 것 입니다: -```JavaScript +```javascript request.on('response', (response) => { - console.log(`STATUS: ${response.statusCode}`); + console.log(`STATUS: ${response.statusCode}`) response.on('error', (error) => { console.log(`ERROR: ${JSON.stringify(error)}`) }) @@ -254,6 +258,8 @@ Returns String - 이전에 설정된 추가 헤더 이름에 대한 값. > HTTP/HTTPS 요청에 대한 응답을 처리합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `IncomingMessage` 는 [Readable Stream](https://nodejs.org/api/stream.html#stream_readable_streams) 인터페이스를 구현하였고 따라서 diff --git a/docs-translations/ko-KR/api/power-monitor.md b/docs-translations/ko-KR/api/power-monitor.md index ad1a7c791793..769e9ca84569 100644 --- a/docs-translations/ko-KR/api/power-monitor.md +++ b/docs-translations/ko-KR/api/power-monitor.md @@ -2,6 +2,8 @@ > 파워의 상태 변경을 모니터링합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + 이 모듈은 메인 프로세스에서만 사용할 수 있습니다. `app` 모듈의 `ready` 이벤트가 발생한 이후에만 사용할 수 없습니다. diff --git a/docs-translations/ko-KR/api/power-save-blocker.md b/docs-translations/ko-KR/api/power-save-blocker.md index 4a414de21381..099fbb873a2c 100644 --- a/docs-translations/ko-KR/api/power-save-blocker.md +++ b/docs-translations/ko-KR/api/power-save-blocker.md @@ -2,6 +2,8 @@ > 시스템이 저전력 (슬립) 모드로 진입하는 것을 막습니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + 예시: ```javascript diff --git a/docs-translations/ko-KR/api/process.md b/docs-translations/ko-KR/api/process.md index e8d1f7cc6f74..c9916788b907 100644 --- a/docs-translations/ko-KR/api/process.md +++ b/docs-translations/ko-KR/api/process.md @@ -2,6 +2,8 @@ > process 객체에 대한 확장 기능. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `process` 객체는 Electron에서 약간 추가적인 기능이 있으며 API는 다음과 같습니다: ## Events diff --git a/docs-translations/ko-KR/api/protocol.md b/docs-translations/ko-KR/api/protocol.md index c4022342cfab..dc3bb51ba2f3 100644 --- a/docs-translations/ko-KR/api/protocol.md +++ b/docs-translations/ko-KR/api/protocol.md @@ -2,6 +2,8 @@ > 커스텀 프로토콜을 등록하거나 이미 존재하능 프로토콜의 요청의 동작을 변경합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + 다음 예시는 `file://` 프로토콜과 비슷한 일을 하는 커스텀 프로토콜을 설정합니다: ```javascript diff --git a/docs-translations/ko-KR/api/remote.md b/docs-translations/ko-KR/api/remote.md index 316e8115b7a0..92e1c74408fa 100644 --- a/docs-translations/ko-KR/api/remote.md +++ b/docs-translations/ko-KR/api/remote.md @@ -2,6 +2,8 @@ > 메인 프로세스 모듈을 렌더러 프로세스에서 사용합니다. +프로세스: [렌더러](../tutorial/quick-start.md#renderer-process) + `remote` 모듈은 메인 프로세스와 렌더러 프로세스(웹 페이지) 사이의 inter-process (IPC) 통신을 간단하게 추상화 한 모듈입니다. diff --git a/docs-translations/ko-KR/api/screen.md b/docs-translations/ko-KR/api/screen.md index 4bf293bb1d67..e62cf5385707 100644 --- a/docs-translations/ko-KR/api/screen.md +++ b/docs-translations/ko-KR/api/screen.md @@ -2,6 +2,8 @@ > 화면 크기, 디스플레이, 커서 위치 등의 정보를 가져옵니다. +프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process) + 이 모듈은 `app` 모듈의 `ready` 이벤트가 발생하기 전까지 포함하거나 사용할 수 없습니다. diff --git a/docs-translations/ko-KR/api/session.md b/docs-translations/ko-KR/api/session.md index 0c49cc5e5001..3bbd63ff226e 100644 --- a/docs-translations/ko-KR/api/session.md +++ b/docs-translations/ko-KR/api/session.md @@ -2,6 +2,8 @@ > 브라우저 세션, 쿠키, 캐시, 프록시 설정 등을 관리합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `session` 모듈은 새로운 `Session` 객체를 만드는데 사용할 수 있습니다. 또한 [`WebContents`](web-contents.md)의 `session` 속성이나 `session` 모듈을 통해 @@ -51,6 +53,8 @@ Returns `Session` - `partition` 문자열로부터 만들어진 `Session` 인스 > 세션의 속성을 가져오거나 설정합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `session` 모듈을 사용하여 `Session` 객체를 생성할 수 있습니다: ```javascript @@ -372,6 +376,8 @@ app.on('ready', function () { > 세션의 쿠키를 변경하거나 요청합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `Cookies` 클래스의 인스턴스는 `Session`의 `cookies` 속성을 통해 접근합니다. 예를 들어: @@ -471,6 +477,8 @@ session.defaultSession.cookies.set(cookie, (error) => { > 생명주기 동안의 다양한 단계를 가지는 요청의 콘텐츠를 가로채고 변경합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `WebRequest` 클래스의 인스턴스는 `Session`의 `webRequest` 속성을 통해 접근할 수 있습니다. diff --git a/docs-translations/ko-KR/api/shell.md b/docs-translations/ko-KR/api/shell.md index f85c745232cd..8819e9f5a66f 100644 --- a/docs-translations/ko-KR/api/shell.md +++ b/docs-translations/ko-KR/api/shell.md @@ -2,6 +2,8 @@ > 파일과 URL을 각 기본 애플리케이션을 통해 관리합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process) + `shell` 모듈은 데스크톱 환경 통합에 관련한 유틸리티를 제공하는 모듈입니다. 다음 예시는 설정된 URL을 유저의 기본 브라우저로 엽니다: diff --git a/docs-translations/ko-KR/api/system-preferences.md b/docs-translations/ko-KR/api/system-preferences.md index 2df4d0f10772..a8407437d264 100644 --- a/docs-translations/ko-KR/api/system-preferences.md +++ b/docs-translations/ko-KR/api/system-preferences.md @@ -2,6 +2,8 @@ > 시스템 설정을 가져옵니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + ```javascript const {systemPreferences} = require('electron') console.log(systemPreferences.isDarkMode()) diff --git a/docs-translations/ko-KR/api/tray.md b/docs-translations/ko-KR/api/tray.md index 379c926b1bb5..68a4ca5ce5bb 100644 --- a/docs-translations/ko-KR/api/tray.md +++ b/docs-translations/ko-KR/api/tray.md @@ -2,6 +2,8 @@ > 아이콘과 컨텍스트 메뉴를 시스템 알림 영역에 추가합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + ```javascript const {app, Menu, Tray} = require('electron') diff --git a/docs-translations/ko-KR/api/web-contents.md b/docs-translations/ko-KR/api/web-contents.md index f95daf9e2c8d..09bd4f58bf84 100644 --- a/docs-translations/ko-KR/api/web-contents.md +++ b/docs-translations/ko-KR/api/web-contents.md @@ -2,6 +2,8 @@ > 웹 페이지를 렌더링하고 제어합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + `webContents`는 [EventEmitter](http://nodejs.org/api/events.html#events_class_eventemitter)를 상속받았습니다. 웹 페이지의 렌더링과 관리를 책임지며 [`BrowserWindow`](browser-window.md)의 속성입니다. 다음은 `webContents` 객체에 @@ -47,6 +49,8 @@ Returns `WebContents` - ID 에 해당하는 WebContens 인스턴스. > BrowserWindow 인스턴스의 콘텐츠를 표시하고 제어합니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + ### Instance Events #### Event: 'did-finish-load' @@ -611,11 +615,25 @@ CSS 코드를 현재 웹 페이지에 삽입합니다. * `callback` Function (optional) - 스크립트의 실행이 완료되면 호출됩니다. * `result` Any -페이지에서 자바스크립트 코드를 실행합니다. +Returns `Promise` - 프로미스는 실행된 코드의 결과와 함께 해결되거나 코드의 +결과가 거절된 프로미스라면 거절된다. -기본적으로 `requestFullScreen`와 같은 몇몇 HTML API들은 사용자의 조작에 의해서만 -호출될 수 있습니다. `userGesture`를 `true`로 설정하면 이러한 제약을 무시할 수 -있습니다. +페이지의 `code` 를 실행합니다. + +브라우저 창에서 `requestFullScreen` 같은 일부 HTML API 들은 사용자 조작에 +의해서만 호출될 수 있습니다. `userGesture` 를 `true` 로 설정하면 이러한 제약을 +없앨 수 있습니다. + +실행된 코드의 결과가 프로미스라면 콜백 결과는 프로미스의 결과 값입니다. +프로미스의 반환된 결과 코드를 처리하기위해 반환된 프로미스를 사용하는 것이 +좋습니다. + +```js +contents.executeJavaScript('fetch("https://jsonplaceholder.typicode.com/users/1").then(resp => resp.json())', true) + .then((result) => { + console.log(result) // fetch 호출의 결과인 JSON 객체가 올 것 입니다 + }) +``` #### `contents.setAudioMuted(muted)` @@ -1159,6 +1177,8 @@ win.webContents.on('did-finish-load', () => { > Chrome의 원격 디버깅 프로토콜에 대한 대체 접근자입니다. +프로세스: [메인](../tutorial/quick-start.md#main-process) + ```javascript const {BrowserWindow} = require('electron') let win = new BrowserWindow() diff --git a/docs-translations/ko-KR/api/web-frame.md b/docs-translations/ko-KR/api/web-frame.md index b3362d962ac9..64b78eb13459 100644 --- a/docs-translations/ko-KR/api/web-frame.md +++ b/docs-translations/ko-KR/api/web-frame.md @@ -2,6 +2,8 @@ > 현재 웹 페이지의 렌더링 상태를 커스터마이즈합니다. +프로세스: [렌더러](../tutorial/quick-start.md#renderer-process) + 다음 예시는 현재 페이지를 200% 줌 합니다: ```javascript diff --git a/docs-translations/ko-KR/api/window-open.md b/docs-translations/ko-KR/api/window-open.md index e6c89af68b9d..6f73059390d8 100644 --- a/docs-translations/ko-KR/api/window-open.md +++ b/docs-translations/ko-KR/api/window-open.md @@ -44,6 +44,8 @@ > 자식 브라우저 윈도우를 조작합니다 +프로세스: [렌더러](../tutorial/quick-start.md#renderer-process) + ### Instance Methods `BrowserWindowProxy` 객체는 다음과 같은 인스턴스 메서드를 가지고 있습니다: diff --git a/docs-translations/ko-KR/tutorial/debugging-main-process-vscode.md b/docs-translations/ko-KR/tutorial/debugging-main-process-vscode.md index adab50234ef8..60e0dd3ed0d3 100644 --- a/docs-translations/ko-KR/tutorial/debugging-main-process-vscode.md +++ b/docs-translations/ko-KR/tutorial/debugging-main-process-vscode.md @@ -9,7 +9,7 @@ $ code electron-quick-start ### 2. 다음 설정으로 `.vscode/launch.json` 파일 추가하기: -```javascripton +```json { "version": "0.2.0", "configurations": [