> 키보드 단축키를 정의합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
Accelerator 는 `+` 문자로 결합된 여러 수식어와 키 코드를 포함할 수 있는
문자열입니다. 그리고 애플리케이션의 키보드 단축키를 정의하는데 사용됩니다.
> 애플리케이션의 이벤트 생명주기를 제어합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
밑의 예시는 마지막 윈도우가 종료되었을 때, 애플리케이션을 종료시키는 예시입니다:
```javascript
> 브라우저 윈도우를 생성하고 제어합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
```javascript
// 메인 프로세스에서
const {BrowserWindow} = require('electron')
> 시스템 클립보드에 복사와 붙여넣기를 수행합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process)
+
다음 예시는 클립보드에 문자열을 쓰는 방법을 보여줍니다:
```javascript
> 원격 서버에 오류 보고를 제출합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process)
+
다음은 윈격 서버에 애플리케이션 오류 보고를 자동으로 제출하는 예시입니다:
```javascript
> 멀티미디어 소스에 대해 접근하고 [`navigator.webkitGetUserMedia`] API를 통해
> 오디오나 비디오를 데스크톱으로부터 캡쳐할 수 있도록 합니다.
+프로세스: [렌더러](../tutorial/quick-start.md#renderer-process)
+
다음 예시는 창 제목이 `Electron`인 데스크톱 창에 대해 비디오 캡쳐하는 방법을
보여줍니다.
> 파일을 열거나 저장하고, 알림을 표시하기 위한 네이티브 시스템 대화 상자를 표시합니다.
-다음 예시는 파일과 디렉터리를 다중으로 선택하는 대화 상자를 표시하는 예시입니다:
+다음 예시는 파일과 디렉터리를 다중으로 선택프로세스: [메인](../tutorial/quick-start.md#main-process)
+
+하는 대화 상자를 표시하는 예시입니다:
```javascript
const {dialog} = require('electron')
> 원격 소스로부터의 파일 다운로드를 제어합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`DownloadItem`은 `EventEmitter`를 상속받았으며 Electron의 다운로드 아이템을
표현합니다. 이 클래스 객체는 `Session` 클래스의 `will-download` 이벤트에 사용되며
사용자가 다운로드 아이템을 다룰 수 있도록 도와줍니다.
> 애플리케이션에 키보드 포커스가 없을 때도 키보드 이벤트를 받을 수 있도록 합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`globalShortcut` 모듈은 운영체제의 전역 키보드 단축키를 등록/해제 하는 방법을
제공합니다. 이 모듈을 사용하여 사용자가 다양한 작업을 편하게 할 수 있도록 단축키를
정의 할 수 있습니다.
> 메인 프로세스에서 렌더러 프로세스로 비동기 통신을 합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`ipcMain` 모듈은 [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
클래스의 인스턴스입니다. 메인 프로세스에서 사용하면, 렌더러
프로세스(웹 페이지)에서 전달된 동기, 비동기 메시지를 주고 받는 방법을
ipcRenderer.send('asynchronous-message', 'ping')
```
-## 메시지 리스닝
+## Methods
`ipcMain`은 다음과 같은 이벤트 리스닝 메서드를 가지고 있습니다:
> 렌더러 프로세스에서 메인 프로세스로 비동기 통신을 합니다.
+프로세스: [렌더러](../tutorial/quick-start.md#renderer-process)
+
`ipcRenderer` 모듈은 [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
클래스의 인스턴스입니다. 렌더러 프로세스에서 메인 프로세스로 동기/비동기
메시지를 주고 받는 방법을 제공합니다. 또한 메인 프로세스로부터 받은 메시지에
[ipcMain](ipc-main.md)에서 코드 예시를 확인할 수 있습니다.
-## 메시지 리스닝
+## Methods
`ipcRenderer`는 다음과 같은 이벤트 리스닝 메서드를 가지고 있습니다:
> 네이티브 애플리케이션 메뉴와 컨텍스트 메뉴에 아이템을 추가합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
[`Menu`](menu.md)에서 예시를 확인할 수 있습니다.
## Class: MenuItem
> 네이티브 애플리케이션 메뉴와 컨텍스트 메뉴를 생성합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
각 메뉴는 여러 개의 [메뉴 아이템](menu-item.md)으로 구성되고 서브 메뉴를 가질 수도 있습니다.
## 예시
> PNG 또는 JPG 파일을 사용하여 트레이, 독, 애플리케이션 아이콘을 생성합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process)
+
Electron은 파일 경로 또는 `NativeImage` 인스턴스를 통해 이미지를 사용할 수 있는 API를
가지고 있습니다. `null`을 전달할 경우 빈 이미지가 생성됩니다.
## Class: NativeImage
-네이티브로 랩핑된 트레이, dock, 애플리케이션 아이콘을 위한 이미지입니다.
+> 네이티브로 랩핑된 트레이, dock, 애플리케이션 아이콘을 위한 이미지입니다.
+
+프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process)
### Instance Methods
> 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
> HTTP/HTTPS 요청을 합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`ClientRequest` 는
[Writable Stream](https://nodejs.org/api/stream.html#stream_writable_streams)
인터페이스를 구현하였고 따라서
예를 들어, 다음과 같이 'github.com' 에 대한 같은 요청을 만들 수 있습니다:
-```JavaScript
+```javascript
const request = net.request({
method: 'GET',
protocol: 'https:',
* `username` String
* `password` String
-```JavaScript
+```javascript
request.on('login', (authInfo, callback) => {
callback('username', 'password')
})
빈 자격증명을 제공하면 요청이 취소되고 응답 객체에서 인증 오류가 보고될 것
입니다:
-```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)}`)
})
> HTTP/HTTPS 요청에 대한 응답을 처리합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`IncomingMessage` 는
[Readable Stream](https://nodejs.org/api/stream.html#stream_readable_streams)
인터페이스를 구현하였고 따라서
> 파워의 상태 변경을 모니터링합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
이 모듈은 메인 프로세스에서만 사용할 수 있습니다. `app` 모듈의 `ready` 이벤트가
발생한 이후에만 사용할 수 없습니다.
> 시스템이 저전력 (슬립) 모드로 진입하는 것을 막습니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
예시:
```javascript
> process 객체에 대한 확장 기능.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`process` 객체는 Electron에서 약간 추가적인 기능이 있으며 API는 다음과 같습니다:
## Events
> 커스텀 프로토콜을 등록하거나 이미 존재하능 프로토콜의 요청의 동작을 변경합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
다음 예시는 `file://` 프로토콜과 비슷한 일을 하는 커스텀 프로토콜을 설정합니다:
```javascript
> 메인 프로세스 모듈을 렌더러 프로세스에서 사용합니다.
+프로세스: [렌더러](../tutorial/quick-start.md#renderer-process)
+
`remote` 모듈은 메인 프로세스와 렌더러 프로세스(웹 페이지) 사이의 inter-process
(IPC) 통신을 간단하게 추상화 한 모듈입니다.
> 화면 크기, 디스플레이, 커서 위치 등의 정보를 가져옵니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process)
+
이 모듈은 `app` 모듈의 `ready` 이벤트가 발생하기 전까지 포함하거나 사용할 수
없습니다.
> 브라우저 세션, 쿠키, 캐시, 프록시 설정 등을 관리합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`session` 모듈은 새로운 `Session` 객체를 만드는데 사용할 수 있습니다.
또한 [`WebContents`](web-contents.md)의 `session` 속성이나 `session` 모듈을 통해
> 세션의 속성을 가져오거나 설정합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`session` 모듈을 사용하여 `Session` 객체를 생성할 수 있습니다:
```javascript
> 세션의 쿠키를 변경하거나 요청합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`Cookies` 클래스의 인스턴스는 `Session`의 `cookies` 속성을 통해 접근합니다.
예를 들어:
> 생명주기 동안의 다양한 단계를 가지는 요청의 콘텐츠를 가로채고 변경합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`WebRequest` 클래스의 인스턴스는 `Session`의 `webRequest` 속성을 통해 접근할 수
있습니다.
> 파일과 URL을 각 기본 애플리케이션을 통해 관리합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process), [렌더러](../tutorial/quick-start.md#renderer-process)
+
`shell` 모듈은 데스크톱 환경 통합에 관련한 유틸리티를 제공하는 모듈입니다.
다음 예시는 설정된 URL을 유저의 기본 브라우저로 엽니다:
> 시스템 설정을 가져옵니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
```javascript
const {systemPreferences} = require('electron')
console.log(systemPreferences.isDarkMode())
> 아이콘과 컨텍스트 메뉴를 시스템 알림 영역에 추가합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
```javascript
const {app, Menu, Tray} = require('electron')
> 웹 페이지를 렌더링하고 제어합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
`webContents`는 [EventEmitter](http://nodejs.org/api/events.html#events_class_eventemitter)를
상속받았습니다. 웹 페이지의 렌더링과 관리를 책임지며
[`BrowserWindow`](browser-window.md)의 속성입니다. 다음은 `webContents` 객체에
> BrowserWindow 인스턴스의 콘텐츠를 표시하고 제어합니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
### Instance Events
#### Event: 'did-finish-load'
* `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)`
> Chrome의 원격 디버깅 프로토콜에 대한 대체 접근자입니다.
+프로세스: [메인](../tutorial/quick-start.md#main-process)
+
```javascript
const {BrowserWindow} = require('electron')
let win = new BrowserWindow()
> 현재 웹 페이지의 렌더링 상태를 커스터마이즈합니다.
+프로세스: [렌더러](../tutorial/quick-start.md#renderer-process)
+
다음 예시는 현재 페이지를 200% 줌 합니다:
```javascript
> 자식 브라우저 윈도우를 조작합니다
+프로세스: [렌더러](../tutorial/quick-start.md#renderer-process)
+
### Instance Methods
`BrowserWindowProxy` 객체는 다음과 같은 인스턴스 메서드를 가지고 있습니다:
### 2. 다음 설정으로 `.vscode/launch.json` 파일 추가하기:
-```javascripton
+```json
{
"version": "0.2.0",
"configurations": [
projects / platform / framework / web / crosswalk-tizen.git / commitdiff