Skip to main content

Class: Dock

Class: Dock​

macOS 독에서 앱을 제어한다.

프로세스: Main
이 클래스는 'electron' 모듈에서 직접 내보내지 않는다. Electron API의 다른 메서드의 반환값으로만 사용할 수 있다.

다음 예제는 독에서 아이콘을 바운스하는 방법을 보여준다.

const { app } = require('electron')
app.dock.bounce()

인스턴스 메서드​

dock.bounce([type]) macOS​

  • type string (선택 사항) - critical 또는 informational 값을 가질 수 있다. 기본값은 informational이다.

반환값은 Integer - 요청을 나타내는 ID를 반환한다.

critical을 전달하면, 애플리케이션이 활성화되거나 요청이 취소될 때까지 독 아이콘이 반복적으로 튕긴다.

informational을 전달하면, 독 아이콘이 1초 동안 튕긴다. 그러나 요청은 애플리케이션이 활성화되거나 요청이 취소될 때까지 계속 유효하다.

참고: 이 메서드는 애플리케이션이 포커스 상태가 아닐 때만 사용할 수 있다. 애플리케이션이 포커스 상태일 때는 -1을 반환한다.

dock.cancelBounce(id) macOS​

  • id Integer

id에 해당하는 바운스를 취소한다.

dock.downloadFinished(filePath) macOS​

  • filePath string

파일 경로가 다운로드 폴더 안에 있으면 다운로드 스택을 바운스한다.

dock.setBadge(text) macOS​

  • text string

도크의 배지 영역에 표시할 문자열을 설정한다.

dock.getBadge() macOS​

string 타입의 값을 반환한다. 이 값은 도크(Dock)의 배지 문자열을 나타낸다.

dock.hide() macOS​

도크 아이콘을 숨긴다.

dock.show() macOS​

Promise<void>를 반환한다. 도크 아이콘이 표시되면 이 Promise가 이행된다.

dock.isVisible() macOS​

boolean 값을 반환한다. 도크 아이콘이 보이는지 여부를 나타낸다.

dock.setMenu(menu) macOS​

애플리케이션의 dock 메뉴를 설정한다.

dock.getMenu() macOS​

Menu | null을 반환한다. 애플리케이션의 dock 메뉴를 나타낸다.

dock.setIcon(image) macOS​

이 도크 아이콘과 연결된 image를 설정한다.