You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
19519 lines
790 KiB
19519 lines
790 KiB
// Type definitions for Electron 27.0.2
|
|
// Project: http://electronjs.org/
|
|
// Definitions by: The Electron Team <https://github.com/electron/electron>
|
|
// Definitions: https://github.com/electron/typescript-definitions
|
|
|
|
/// <reference types="node" />
|
|
|
|
type DOMEvent = Event;
|
|
type GlobalResponse = Response;
|
|
type GlobalRequest = Request;
|
|
|
|
declare namespace Electron {
|
|
const NodeEventEmitter: typeof import('events').EventEmitter;
|
|
|
|
type Accelerator = string;
|
|
type Event<Params extends object = {}> = {
|
|
preventDefault: () => void;
|
|
readonly defaultPrevented: boolean;
|
|
} & Params;
|
|
|
|
interface App extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/app
|
|
|
|
/**
|
|
* Emitted when Chrome's accessibility support changes. This event fires when
|
|
* assistive technologies, such as screen readers, are enabled or disabled. See
|
|
* https://www.chromium.org/developers/design-documents/accessibility for more
|
|
* details.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'accessibility-support-changed', listener: (event: Event,
|
|
/**
|
|
* `true` when Chrome's accessibility support is enabled, `false` otherwise.
|
|
*/
|
|
accessibilitySupportEnabled: boolean) => void): this;
|
|
once(event: 'accessibility-support-changed', listener: (event: Event,
|
|
/**
|
|
* `true` when Chrome's accessibility support is enabled, `false` otherwise.
|
|
*/
|
|
accessibilitySupportEnabled: boolean) => void): this;
|
|
addListener(event: 'accessibility-support-changed', listener: (event: Event,
|
|
/**
|
|
* `true` when Chrome's accessibility support is enabled, `false` otherwise.
|
|
*/
|
|
accessibilitySupportEnabled: boolean) => void): this;
|
|
removeListener(event: 'accessibility-support-changed', listener: (event: Event,
|
|
/**
|
|
* `true` when Chrome's accessibility support is enabled, `false` otherwise.
|
|
*/
|
|
accessibilitySupportEnabled: boolean) => void): this;
|
|
/**
|
|
* Emitted when the application is activated. Various actions can trigger this
|
|
* event, such as launching the application for the first time, attempting to
|
|
* re-launch the application when it's already running, or clicking on the
|
|
* application's dock or taskbar icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'activate', listener: (event: Event,
|
|
hasVisibleWindows: boolean) => void): this;
|
|
once(event: 'activate', listener: (event: Event,
|
|
hasVisibleWindows: boolean) => void): this;
|
|
addListener(event: 'activate', listener: (event: Event,
|
|
hasVisibleWindows: boolean) => void): this;
|
|
removeListener(event: 'activate', listener: (event: Event,
|
|
hasVisibleWindows: boolean) => void): this;
|
|
/**
|
|
* Emitted during Handoff after an activity from this device was successfully
|
|
* resumed on another one.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'activity-was-continued', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
once(event: 'activity-was-continued', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
addListener(event: 'activity-was-continued', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
removeListener(event: 'activity-was-continued', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
/**
|
|
* Emitted before the application starts closing its windows. Calling
|
|
* `event.preventDefault()` will prevent the default behavior, which is terminating
|
|
* the application.
|
|
*
|
|
* **Note:** If application quit was initiated by `autoUpdater.quitAndInstall()`,
|
|
* then `before-quit` is emitted _after_ emitting `close` event on all windows and
|
|
* closing them.
|
|
*
|
|
* **Note:** On Windows, this event will not be emitted if the app is closed due to
|
|
* a shutdown/restart of the system or a user logout.
|
|
*/
|
|
on(event: 'before-quit', listener: (event: Event) => void): this;
|
|
once(event: 'before-quit', listener: (event: Event) => void): this;
|
|
addListener(event: 'before-quit', listener: (event: Event) => void): this;
|
|
removeListener(event: 'before-quit', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when a browserWindow gets blurred.
|
|
*/
|
|
on(event: 'browser-window-blur', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
once(event: 'browser-window-blur', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
addListener(event: 'browser-window-blur', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
removeListener(event: 'browser-window-blur', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
/**
|
|
* Emitted when a new browserWindow is created.
|
|
*/
|
|
on(event: 'browser-window-created', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
once(event: 'browser-window-created', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
addListener(event: 'browser-window-created', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
removeListener(event: 'browser-window-created', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
/**
|
|
* Emitted when a browserWindow gets focused.
|
|
*/
|
|
on(event: 'browser-window-focus', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
once(event: 'browser-window-focus', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
addListener(event: 'browser-window-focus', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
removeListener(event: 'browser-window-focus', listener: (event: Event,
|
|
window: BrowserWindow) => void): this;
|
|
/**
|
|
* Emitted when failed to verify the `certificate` for `url`, to trust the
|
|
* certificate you should prevent the default behavior with
|
|
* `event.preventDefault()` and call `callback(true)`.
|
|
*/
|
|
on(event: 'certificate-error', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
/**
|
|
* The error code
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
once(event: 'certificate-error', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
/**
|
|
* The error code
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
addListener(event: 'certificate-error', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
/**
|
|
* The error code
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
removeListener(event: 'certificate-error', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
/**
|
|
* The error code
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
/**
|
|
* Emitted when the child process unexpectedly disappears. This is normally because
|
|
* it was crashed or killed. It does not include renderer processes.
|
|
*/
|
|
on(event: 'child-process-gone', listener: (event: Event,
|
|
details: Details) => void): this;
|
|
once(event: 'child-process-gone', listener: (event: Event,
|
|
details: Details) => void): this;
|
|
addListener(event: 'child-process-gone', listener: (event: Event,
|
|
details: Details) => void): this;
|
|
removeListener(event: 'child-process-gone', listener: (event: Event,
|
|
details: Details) => void): this;
|
|
/**
|
|
* Emitted during Handoff when an activity from a different device wants to be
|
|
* resumed. You should call `event.preventDefault()` if you want to handle this
|
|
* event.
|
|
*
|
|
* A user activity can be continued only in an app that has the same developer Team
|
|
* ID as the activity's source app and that supports the activity's type. Supported
|
|
* activity types are specified in the app's `Info.plist` under the
|
|
* `NSUserActivityTypes` key.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity on another device.
|
|
*/
|
|
userInfo: unknown,
|
|
details: ContinueActivityDetails) => void): this;
|
|
once(event: 'continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity on another device.
|
|
*/
|
|
userInfo: unknown,
|
|
details: ContinueActivityDetails) => void): this;
|
|
addListener(event: 'continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity on another device.
|
|
*/
|
|
userInfo: unknown,
|
|
details: ContinueActivityDetails) => void): this;
|
|
removeListener(event: 'continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity on another device.
|
|
*/
|
|
userInfo: unknown,
|
|
details: ContinueActivityDetails) => void): this;
|
|
/**
|
|
* Emitted during Handoff when an activity from a different device fails to be
|
|
* resumed.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'continue-activity-error', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* A string with the error's localized description.
|
|
*/
|
|
error: string) => void): this;
|
|
once(event: 'continue-activity-error', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* A string with the error's localized description.
|
|
*/
|
|
error: string) => void): this;
|
|
addListener(event: 'continue-activity-error', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* A string with the error's localized description.
|
|
*/
|
|
error: string) => void): this;
|
|
removeListener(event: 'continue-activity-error', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* A string with the error's localized description.
|
|
*/
|
|
error: string) => void): this;
|
|
/**
|
|
* Emitted when the application becomes active. This differs from the `activate`
|
|
* event in that `did-become-active` is emitted every time the app becomes active,
|
|
* not only when Dock icon is clicked or application is re-launched. It is also
|
|
* emitted when a user switches to the app via the macOS App Switcher.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'did-become-active', listener: (event: Event) => void): this;
|
|
once(event: 'did-become-active', listener: (event: Event) => void): this;
|
|
addListener(event: 'did-become-active', listener: (event: Event) => void): this;
|
|
removeListener(event: 'did-become-active', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when the app is no longer active and doesn’t have focus. This can be
|
|
* triggered, for example, by clicking on another application or by using the macOS
|
|
* App Switcher to switch to another application.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'did-resign-active', listener: (event: Event) => void): this;
|
|
once(event: 'did-resign-active', listener: (event: Event) => void): this;
|
|
addListener(event: 'did-resign-active', listener: (event: Event) => void): this;
|
|
removeListener(event: 'did-resign-active', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted whenever there is a GPU info update.
|
|
*/
|
|
on(event: 'gpu-info-update', listener: Function): this;
|
|
once(event: 'gpu-info-update', listener: Function): this;
|
|
addListener(event: 'gpu-info-update', listener: Function): this;
|
|
removeListener(event: 'gpu-info-update', listener: Function): this;
|
|
/**
|
|
* Emitted when the GPU process crashes or is killed.
|
|
*
|
|
* **Deprecated:** This event is superceded by the `child-process-gone` event which
|
|
* contains more information about why the child process disappeared. It isn't
|
|
* always because it crashed. The `killed` boolean can be replaced by checking
|
|
* `reason === 'killed'` when you switch to that event.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
on(event: 'gpu-process-crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
once(event: 'gpu-process-crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
addListener(event: 'gpu-process-crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
removeListener(event: 'gpu-process-crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
/**
|
|
* Emitted when `webContents` wants to do basic auth.
|
|
*
|
|
* The default behavior is to cancel all authentications. To override this you
|
|
* should prevent the default behavior with `event.preventDefault()` and call
|
|
* `callback(username, password)` with the credentials.
|
|
*
|
|
* If `callback` is called without a username or password, the authentication
|
|
* request will be cancelled and the authentication error will be returned to the
|
|
* page.
|
|
*/
|
|
on(event: 'login', listener: (event: Event,
|
|
webContents: WebContents,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
once(event: 'login', listener: (event: Event,
|
|
webContents: WebContents,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
addListener(event: 'login', listener: (event: Event,
|
|
webContents: WebContents,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
removeListener(event: 'login', listener: (event: Event,
|
|
webContents: WebContents,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
/**
|
|
* Emitted when the user clicks the native macOS new tab button. The new tab button
|
|
* is only visible if the current `BrowserWindow` has a `tabbingIdentifier`
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'new-window-for-tab', listener: (event: Event) => void): this;
|
|
once(event: 'new-window-for-tab', listener: (event: Event) => void): this;
|
|
addListener(event: 'new-window-for-tab', listener: (event: Event) => void): this;
|
|
removeListener(event: 'new-window-for-tab', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when the user wants to open a file with the application. The `open-file`
|
|
* event is usually emitted when the application is already open and the OS wants
|
|
* to reuse the application to open the file. `open-file` is also emitted when a
|
|
* file is dropped onto the dock and the application is not yet running. Make sure
|
|
* to listen for the `open-file` event very early in your application startup to
|
|
* handle this case (even before the `ready` event is emitted).
|
|
*
|
|
* You should call `event.preventDefault()` if you want to handle this event.
|
|
*
|
|
* On Windows, you have to parse `process.argv` (in the main process) to get the
|
|
* filepath.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'open-file', listener: (event: Event,
|
|
path: string) => void): this;
|
|
once(event: 'open-file', listener: (event: Event,
|
|
path: string) => void): this;
|
|
addListener(event: 'open-file', listener: (event: Event,
|
|
path: string) => void): this;
|
|
removeListener(event: 'open-file', listener: (event: Event,
|
|
path: string) => void): this;
|
|
/**
|
|
* Emitted when the user wants to open a URL with the application. Your
|
|
* application's `Info.plist` file must define the URL scheme within the
|
|
* `CFBundleURLTypes` key, and set `NSPrincipalClass` to `AtomApplication`.
|
|
*
|
|
* As with the `open-file` event, be sure to register a listener for the `open-url`
|
|
* event early in your application startup to detect if the application is being
|
|
* opened to handle a URL. If you register the listener in response to a `ready`
|
|
* event, you'll miss URLs that trigger the launch of your application.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'open-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
once(event: 'open-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
addListener(event: 'open-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
removeListener(event: 'open-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
/**
|
|
* Emitted when the application is quitting.
|
|
*
|
|
* **Note:** On Windows, this event will not be emitted if the app is closed due to
|
|
* a shutdown/restart of the system or a user logout.
|
|
*/
|
|
on(event: 'quit', listener: (event: Event,
|
|
exitCode: number) => void): this;
|
|
once(event: 'quit', listener: (event: Event,
|
|
exitCode: number) => void): this;
|
|
addListener(event: 'quit', listener: (event: Event,
|
|
exitCode: number) => void): this;
|
|
removeListener(event: 'quit', listener: (event: Event,
|
|
exitCode: number) => void): this;
|
|
/**
|
|
* Emitted once, when Electron has finished initializing. On macOS, `launchInfo`
|
|
* holds the `userInfo` of the `NSUserNotification` or information from
|
|
* `UNNotificationResponse` that was used to open the application, if it was
|
|
* launched from Notification Center. You can also call `app.isReady()` to check if
|
|
* this event has already fired and `app.whenReady()` to get a Promise that is
|
|
* fulfilled when Electron is initialized.
|
|
*/
|
|
on(event: 'ready', listener: (event: Event,
|
|
/**
|
|
* @platform darwin
|
|
*/
|
|
launchInfo: (Record<string, any>) | (NotificationResponse)) => void): this;
|
|
once(event: 'ready', listener: (event: Event,
|
|
/**
|
|
* @platform darwin
|
|
*/
|
|
launchInfo: (Record<string, any>) | (NotificationResponse)) => void): this;
|
|
addListener(event: 'ready', listener: (event: Event,
|
|
/**
|
|
* @platform darwin
|
|
*/
|
|
launchInfo: (Record<string, any>) | (NotificationResponse)) => void): this;
|
|
removeListener(event: 'ready', listener: (event: Event,
|
|
/**
|
|
* @platform darwin
|
|
*/
|
|
launchInfo: (Record<string, any>) | (NotificationResponse)) => void): this;
|
|
/**
|
|
* Emitted when the renderer process unexpectedly disappears. This is normally
|
|
* because it was crashed or killed.
|
|
*/
|
|
on(event: 'render-process-gone', listener: (event: Event,
|
|
webContents: WebContents,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
once(event: 'render-process-gone', listener: (event: Event,
|
|
webContents: WebContents,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
addListener(event: 'render-process-gone', listener: (event: Event,
|
|
webContents: WebContents,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
removeListener(event: 'render-process-gone', listener: (event: Event,
|
|
webContents: WebContents,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
/**
|
|
* Emitted when the renderer process of `webContents` crashes or is killed.
|
|
*
|
|
* **Deprecated:** This event is superceded by the `render-process-gone` event
|
|
* which contains more information about why the render process disappeared. It
|
|
* isn't always because it crashed. The `killed` boolean can be replaced by
|
|
* checking `reason === 'killed'` when you switch to that event.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
on(event: 'renderer-process-crashed', listener: (event: Event,
|
|
webContents: WebContents,
|
|
killed: boolean) => void): this;
|
|
once(event: 'renderer-process-crashed', listener: (event: Event,
|
|
webContents: WebContents,
|
|
killed: boolean) => void): this;
|
|
addListener(event: 'renderer-process-crashed', listener: (event: Event,
|
|
webContents: WebContents,
|
|
killed: boolean) => void): this;
|
|
removeListener(event: 'renderer-process-crashed', listener: (event: Event,
|
|
webContents: WebContents,
|
|
killed: boolean) => void): this;
|
|
/**
|
|
* This event will be emitted inside the primary instance of your application when
|
|
* a second instance has been executed and calls `app.requestSingleInstanceLock()`.
|
|
*
|
|
* `argv` is an Array of the second instance's command line arguments, and
|
|
* `workingDirectory` is its current working directory. Usually applications
|
|
* respond to this by making their primary window focused and non-minimized.
|
|
*
|
|
* **Note:** `argv` will not be exactly the same list of arguments as those passed
|
|
* to the second instance. The order might change and additional arguments might be
|
|
* appended. If you need to maintain the exact same arguments, it's advised to use
|
|
* `additionalData` instead.
|
|
*
|
|
* **Note:** If the second instance is started by a different user than the first,
|
|
* the `argv` array will not include the arguments.
|
|
*
|
|
* This event is guaranteed to be emitted after the `ready` event of `app` gets
|
|
* emitted.
|
|
*
|
|
* **Note:** Extra command line arguments might be added by Chromium, such as
|
|
* `--original-process-start-time`.
|
|
*/
|
|
on(event: 'second-instance', listener: (event: Event,
|
|
/**
|
|
* An array of the second instance's command line arguments
|
|
*/
|
|
argv: string[],
|
|
/**
|
|
* The second instance's working directory
|
|
*/
|
|
workingDirectory: string,
|
|
/**
|
|
* A JSON object of additional data passed from the second instance
|
|
*/
|
|
additionalData: unknown) => void): this;
|
|
once(event: 'second-instance', listener: (event: Event,
|
|
/**
|
|
* An array of the second instance's command line arguments
|
|
*/
|
|
argv: string[],
|
|
/**
|
|
* The second instance's working directory
|
|
*/
|
|
workingDirectory: string,
|
|
/**
|
|
* A JSON object of additional data passed from the second instance
|
|
*/
|
|
additionalData: unknown) => void): this;
|
|
addListener(event: 'second-instance', listener: (event: Event,
|
|
/**
|
|
* An array of the second instance's command line arguments
|
|
*/
|
|
argv: string[],
|
|
/**
|
|
* The second instance's working directory
|
|
*/
|
|
workingDirectory: string,
|
|
/**
|
|
* A JSON object of additional data passed from the second instance
|
|
*/
|
|
additionalData: unknown) => void): this;
|
|
removeListener(event: 'second-instance', listener: (event: Event,
|
|
/**
|
|
* An array of the second instance's command line arguments
|
|
*/
|
|
argv: string[],
|
|
/**
|
|
* The second instance's working directory
|
|
*/
|
|
workingDirectory: string,
|
|
/**
|
|
* A JSON object of additional data passed from the second instance
|
|
*/
|
|
additionalData: unknown) => void): this;
|
|
/**
|
|
* Emitted when a client certificate is requested.
|
|
*
|
|
* The `url` corresponds to the navigation entry requesting the client certificate
|
|
* and `callback` can be called with an entry filtered from the list. Using
|
|
* `event.preventDefault()` prevents the application from using the first
|
|
* certificate from the store.
|
|
*/
|
|
on(event: 'select-client-certificate', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate?: Certificate) => void) => void): this;
|
|
once(event: 'select-client-certificate', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate?: Certificate) => void) => void): this;
|
|
addListener(event: 'select-client-certificate', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate?: Certificate) => void) => void): this;
|
|
removeListener(event: 'select-client-certificate', listener: (event: Event,
|
|
webContents: WebContents,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate?: Certificate) => void) => void): this;
|
|
/**
|
|
* Emitted when Electron has created a new `session`.
|
|
*/
|
|
on(event: 'session-created', listener: (session: Session) => void): this;
|
|
once(event: 'session-created', listener: (session: Session) => void): this;
|
|
addListener(event: 'session-created', listener: (session: Session) => void): this;
|
|
removeListener(event: 'session-created', listener: (session: Session) => void): this;
|
|
/**
|
|
* Emitted when Handoff is about to be resumed on another device. If you need to
|
|
* update the state to be transferred, you should call `event.preventDefault()`
|
|
* immediately, construct a new `userInfo` dictionary and call
|
|
* `app.updateCurrentActivity()` in a timely manner. Otherwise, the operation will
|
|
* fail and `continue-activity-error` will be called.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'update-activity-state', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
once(event: 'update-activity-state', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
addListener(event: 'update-activity-state', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
removeListener(event: 'update-activity-state', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string,
|
|
/**
|
|
* Contains app-specific state stored by the activity.
|
|
*/
|
|
userInfo: unknown) => void): this;
|
|
/**
|
|
* Emitted when a new webContents is created.
|
|
*/
|
|
on(event: 'web-contents-created', listener: (event: Event,
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'web-contents-created', listener: (event: Event,
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'web-contents-created', listener: (event: Event,
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'web-contents-created', listener: (event: Event,
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Emitted during Handoff before an activity from a different device wants to be
|
|
* resumed. You should call `event.preventDefault()` if you want to handle this
|
|
* event.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'will-continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string) => void): this;
|
|
once(event: 'will-continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string) => void): this;
|
|
addListener(event: 'will-continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string) => void): this;
|
|
removeListener(event: 'will-continue-activity', listener: (event: Event,
|
|
/**
|
|
* A string identifying the activity. Maps to `NSUserActivity.activityType`.
|
|
*/
|
|
type: string) => void): this;
|
|
/**
|
|
* Emitted when the application has finished basic startup. On Windows and Linux,
|
|
* the `will-finish-launching` event is the same as the `ready` event; on macOS,
|
|
* this event represents the `applicationWillFinishLaunching` notification of
|
|
* `NSApplication`.
|
|
*
|
|
* In most cases, you should do everything in the `ready` event handler.
|
|
*/
|
|
on(event: 'will-finish-launching', listener: Function): this;
|
|
once(event: 'will-finish-launching', listener: Function): this;
|
|
addListener(event: 'will-finish-launching', listener: Function): this;
|
|
removeListener(event: 'will-finish-launching', listener: Function): this;
|
|
/**
|
|
* Emitted when all windows have been closed and the application will quit. Calling
|
|
* `event.preventDefault()` will prevent the default behavior, which is terminating
|
|
* the application.
|
|
*
|
|
* See the description of the `window-all-closed` event for the differences between
|
|
* the `will-quit` and `window-all-closed` events.
|
|
*
|
|
* **Note:** On Windows, this event will not be emitted if the app is closed due to
|
|
* a shutdown/restart of the system or a user logout.
|
|
*/
|
|
on(event: 'will-quit', listener: (event: Event) => void): this;
|
|
once(event: 'will-quit', listener: (event: Event) => void): this;
|
|
addListener(event: 'will-quit', listener: (event: Event) => void): this;
|
|
removeListener(event: 'will-quit', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when all windows have been closed.
|
|
*
|
|
* If you do not subscribe to this event and all windows are closed, the default
|
|
* behavior is to quit the app; however, if you subscribe, you control whether the
|
|
* app quits or not. If the user pressed `Cmd + Q`, or the developer called
|
|
* `app.quit()`, Electron will first try to close all the windows and then emit the
|
|
* `will-quit` event, and in this case the `window-all-closed` event would not be
|
|
* emitted.
|
|
*/
|
|
on(event: 'window-all-closed', listener: Function): this;
|
|
once(event: 'window-all-closed', listener: Function): this;
|
|
addListener(event: 'window-all-closed', listener: Function): this;
|
|
removeListener(event: 'window-all-closed', listener: Function): this;
|
|
/**
|
|
* Adds `path` to the recent documents list.
|
|
*
|
|
* This list is managed by the OS. On Windows, you can visit the list from the task
|
|
* bar, and on macOS, you can visit it from dock menu.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
addRecentDocument(path: string): void;
|
|
/**
|
|
* Clears the recent documents list.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
clearRecentDocuments(): void;
|
|
/**
|
|
* Configures host resolution (DNS and DNS-over-HTTPS). By default, the following
|
|
* resolvers will be used, in order:
|
|
*
|
|
* * DNS-over-HTTPS, if the DNS provider supports it, then
|
|
* * the built-in resolver (enabled on macOS only by default), then
|
|
* * the system's resolver (e.g. `getaddrinfo`).
|
|
*
|
|
* This can be configured to either restrict usage of non-encrypted DNS
|
|
* (`secureDnsMode: "secure"`), or disable DNS-over-HTTPS (`secureDnsMode: "off"`).
|
|
* It is also possible to enable or disable the built-in resolver.
|
|
*
|
|
* To disable insecure DNS, you can specify a `secureDnsMode` of `"secure"`. If you
|
|
* do so, you should make sure to provide a list of DNS-over-HTTPS servers to use,
|
|
* in case the user's DNS configuration does not include a provider that supports
|
|
* DoH.
|
|
*
|
|
* This API must be called after the `ready` event is emitted.
|
|
*/
|
|
configureHostResolver(options: ConfigureHostResolverOptions): void;
|
|
/**
|
|
* By default, Chromium disables 3D APIs (e.g. WebGL) until restart on a per domain
|
|
* basis if the GPU processes crashes too frequently. This function disables that
|
|
* behavior.
|
|
*
|
|
* This method can only be called before app is ready.
|
|
*/
|
|
disableDomainBlockingFor3DAPIs(): void;
|
|
/**
|
|
* Disables hardware acceleration for current app.
|
|
*
|
|
* This method can only be called before app is ready.
|
|
*/
|
|
disableHardwareAcceleration(): void;
|
|
/**
|
|
* Enables full sandbox mode on the app. This means that all renderers will be
|
|
* launched sandboxed, regardless of the value of the `sandbox` flag in
|
|
* `WebPreferences`.
|
|
*
|
|
* This method can only be called before app is ready.
|
|
*/
|
|
enableSandbox(): void;
|
|
/**
|
|
* Exits immediately with `exitCode`. `exitCode` defaults to 0.
|
|
*
|
|
* All windows will be closed immediately without asking the user, and the
|
|
* `before-quit` and `will-quit` events will not be emitted.
|
|
*/
|
|
exit(exitCode?: number): void;
|
|
/**
|
|
* On Linux, focuses on the first visible window. On macOS, makes the application
|
|
* the active app. On Windows, focuses on the application's first window.
|
|
*
|
|
* You should seek to use the `steal` option as sparingly as possible.
|
|
*/
|
|
focus(options?: FocusOptions): void;
|
|
/**
|
|
* Resolve with an object containing the following:
|
|
*
|
|
* * `icon` NativeImage - the display icon of the app handling the protocol.
|
|
* * `path` string - installation path of the app handling the protocol.
|
|
* * `name` string - display name of the app handling the protocol.
|
|
*
|
|
* This method returns a promise that contains the application name, icon and path
|
|
* of the default handler for the protocol (aka URI scheme) of a URL.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
getApplicationInfoForProtocol(url: string): Promise<Electron.ApplicationInfoForProtocolReturnValue>;
|
|
/**
|
|
* Name of the application handling the protocol, or an empty string if there is no
|
|
* handler. For instance, if Electron is the default handler of the URL, this could
|
|
* be `Electron` on Windows and Mac. However, don't rely on the precise format
|
|
* which is not guaranteed to remain unchanged. Expect a different format on Linux,
|
|
* possibly with a `.desktop` suffix.
|
|
*
|
|
* This method returns the application name of the default handler for the protocol
|
|
* (aka URI scheme) of a URL.
|
|
*/
|
|
getApplicationNameForProtocol(url: string): string;
|
|
/**
|
|
* Array of `ProcessMetric` objects that correspond to memory and CPU usage
|
|
* statistics of all the processes associated with the app.
|
|
*/
|
|
getAppMetrics(): ProcessMetric[];
|
|
/**
|
|
* The current application directory.
|
|
*/
|
|
getAppPath(): string;
|
|
/**
|
|
* The current value displayed in the counter badge.
|
|
*
|
|
* @platform linux,darwin
|
|
*/
|
|
getBadgeCount(): number;
|
|
/**
|
|
* The type of the currently running activity.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getCurrentActivityType(): string;
|
|
/**
|
|
* fulfilled with the app's icon, which is a NativeImage.
|
|
*
|
|
* Fetches a path's associated icon.
|
|
*
|
|
* On _Windows_, there a 2 kinds of icons:
|
|
*
|
|
* * Icons associated with certain file extensions, like `.mp3`, `.png`, etc.
|
|
* * Icons inside the file itself, like `.exe`, `.dll`, `.ico`.
|
|
*
|
|
* On _Linux_ and _macOS_, icons depend on the application associated with file
|
|
* mime type.
|
|
*/
|
|
getFileIcon(path: string, options?: FileIconOptions): Promise<Electron.NativeImage>;
|
|
/**
|
|
* The Graphics Feature Status from `chrome://gpu/`.
|
|
*
|
|
* **Note:** This information is only usable after the `gpu-info-update` event is
|
|
* emitted.
|
|
*/
|
|
getGPUFeatureStatus(): GPUFeatureStatus;
|
|
/**
|
|
* For `infoType` equal to `complete`: Promise is fulfilled with `Object`
|
|
* containing all the GPU Information as in chromium's GPUInfo object. This
|
|
* includes the version and driver information that's shown on `chrome://gpu` page.
|
|
*
|
|
* For `infoType` equal to `basic`: Promise is fulfilled with `Object` containing
|
|
* fewer attributes than when requested with `complete`. Here's an example of basic
|
|
* response:
|
|
*
|
|
* Using `basic` should be preferred if only basic information like `vendorId` or
|
|
* `deviceId` is needed.
|
|
*/
|
|
getGPUInfo(infoType: 'basic' | 'complete'): Promise<unknown>;
|
|
/**
|
|
* * `minItems` Integer - The minimum number of items that will be shown in the
|
|
* Jump List (for a more detailed description of this value see the MSDN docs).
|
|
* * `removedItems` JumpListItem[] - Array of `JumpListItem` objects that
|
|
* correspond to items that the user has explicitly removed from custom categories
|
|
* in the Jump List. These items must not be re-added to the Jump List in the
|
|
* **next** call to `app.setJumpList()`, Windows will not display any custom
|
|
* category that contains any of the removed items.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
getJumpListSettings(): JumpListSettings;
|
|
/**
|
|
* The current application locale, fetched using Chromium's `l10n_util` library.
|
|
* Possible return values are documented here.
|
|
*
|
|
* To set the locale, you'll want to use a command line switch at app startup,
|
|
* which may be found here.
|
|
*
|
|
* **Note:** When distributing your packaged app, you have to also ship the
|
|
* `locales` folder.
|
|
*
|
|
* **Note:** This API must be called after the `ready` event is emitted.
|
|
*
|
|
* **Note:** To see example return values of this API compared to other locale and
|
|
* language APIs, see `app.getPreferredSystemLanguages()`.
|
|
*/
|
|
getLocale(): string;
|
|
/**
|
|
* User operating system's locale two-letter ISO 3166 country code. The value is
|
|
* taken from native OS APIs.
|
|
*
|
|
* **Note:** When unable to detect locale country code, it returns empty string.
|
|
*/
|
|
getLocaleCountryCode(): string;
|
|
/**
|
|
* If you provided `path` and `args` options to `app.setLoginItemSettings`, then
|
|
* you need to pass the same arguments here for `openAtLogin` to be set correctly.
|
|
*
|
|
*
|
|
* * `openAtLogin` boolean - `true` if the app is set to open at login.
|
|
* * `openAsHidden` boolean _macOS_ - `true` if the app is set to open as hidden at
|
|
* login. This setting is not available on MAS builds.
|
|
* * `wasOpenedAtLogin` boolean _macOS_ - `true` if the app was opened at login
|
|
* automatically. This setting is not available on MAS builds.
|
|
* * `wasOpenedAsHidden` boolean _macOS_ - `true` if the app was opened as a hidden
|
|
* login item. This indicates that the app should not open any windows at startup.
|
|
* This setting is not available on MAS builds.
|
|
* * `restoreState` boolean _macOS_ - `true` if the app was opened as a login item
|
|
* that should restore the state from the previous session. This indicates that the
|
|
* app should restore the windows that were open the last time the app was closed.
|
|
* This setting is not available on MAS builds.
|
|
* * `executableWillLaunchAtLogin` boolean _Windows_ - `true` if app is set to open
|
|
* at login and its run key is not deactivated. This differs from `openAtLogin` as
|
|
* it ignores the `args` option, this property will be true if the given executable
|
|
* would be launched at login with **any** arguments.
|
|
* * `launchItems` Object[] _Windows_
|
|
* * `name` string _Windows_ - name value of a registry entry.
|
|
* * `path` string _Windows_ - The executable to an app that corresponds to a
|
|
* registry entry.
|
|
* * `args` string[] _Windows_ - the command-line arguments to pass to the
|
|
* executable.
|
|
* * `scope` string _Windows_ - one of `user` or `machine`. Indicates whether the
|
|
* registry entry is under `HKEY_CURRENT USER` or `HKEY_LOCAL_MACHINE`.
|
|
* * `enabled` boolean _Windows_ - `true` if the app registry key is startup
|
|
* approved and therefore shows as `enabled` in Task Manager and Windows settings.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
getLoginItemSettings(options?: LoginItemSettingsOptions): LoginItemSettings;
|
|
/**
|
|
* The current application's name, which is the name in the application's
|
|
* `package.json` file.
|
|
*
|
|
* Usually the `name` field of `package.json` is a short lowercase name, according
|
|
* to the npm modules spec. You should usually also specify a `productName` field,
|
|
* which is your application's full capitalized name, and which will be preferred
|
|
* over `name` by Electron.
|
|
*/
|
|
getName(): string;
|
|
/**
|
|
* A path to a special directory or file associated with `name`. On failure, an
|
|
* `Error` is thrown.
|
|
*
|
|
* If `app.getPath('logs')` is called without called `app.setAppLogsPath()` being
|
|
* called first, a default log directory will be created equivalent to calling
|
|
* `app.setAppLogsPath()` without a `path` parameter.
|
|
*/
|
|
getPath(name: 'home' | 'appData' | 'userData' | 'sessionData' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'recent' | 'logs' | 'crashDumps'): string;
|
|
/**
|
|
* The user's preferred system languages from most preferred to least preferred,
|
|
* including the country codes if applicable. A user can modify and add to this
|
|
* list on Windows or macOS through the Language and Region settings.
|
|
*
|
|
* The API uses `GlobalizationPreferences` (with a fallback to
|
|
* `GetSystemPreferredUILanguages`) on Windows, `\[NSLocale preferredLanguages\]`
|
|
* on macOS, and `g_get_language_names` on Linux.
|
|
*
|
|
* This API can be used for purposes such as deciding what language to present the
|
|
* application in.
|
|
*
|
|
* Here are some examples of return values of the various language and locale APIs
|
|
* with different configurations:
|
|
*
|
|
* On Windows, given application locale is German, the regional format is Finnish
|
|
* (Finland), and the preferred system languages from most to least preferred are
|
|
* French (Canada), English (US), Simplified Chinese (China), Finnish, and Spanish
|
|
* (Latin America):
|
|
*
|
|
* On macOS, given the application locale is German, the region is Finland, and the
|
|
* preferred system languages from most to least preferred are French (Canada),
|
|
* English (US), Simplified Chinese, and Spanish (Latin America):
|
|
*
|
|
* Both the available languages and regions and the possible return values differ
|
|
* between the two operating systems.
|
|
*
|
|
* As can be seen with the example above, on Windows, it is possible that a
|
|
* preferred system language has no country code, and that one of the preferred
|
|
* system languages corresponds with the language used for the regional format. On
|
|
* macOS, the region serves more as a default country code: the user doesn't need
|
|
* to have Finnish as a preferred language to use Finland as the region,and the
|
|
* country code `FI` is used as the country code for preferred system languages
|
|
* that do not have associated countries in the language name.
|
|
*/
|
|
getPreferredSystemLanguages(): string[];
|
|
/**
|
|
* The current system locale. On Windows and Linux, it is fetched using Chromium's
|
|
* `i18n` library. On macOS, `[NSLocale currentLocale]` is used instead. To get the
|
|
* user's current system language, which is not always the same as the locale, it
|
|
* is better to use `app.getPreferredSystemLanguages()`.
|
|
*
|
|
* Different operating systems also use the regional data differently:
|
|
*
|
|
* * Windows 11 uses the regional format for numbers, dates, and times.
|
|
* * macOS Monterey uses the region for formatting numbers, dates, times, and for
|
|
* selecting the currency symbol to use.
|
|
*
|
|
* Therefore, this API can be used for purposes such as choosing a format for
|
|
* rendering dates and times in a calendar app, especially when the developer wants
|
|
* the format to be consistent with the OS.
|
|
*
|
|
* **Note:** This API must be called after the `ready` event is emitted.
|
|
*
|
|
* **Note:** To see example return values of this API compared to other locale and
|
|
* language APIs, see `app.getPreferredSystemLanguages()`.
|
|
*/
|
|
getSystemLocale(): string;
|
|
/**
|
|
* The version of the loaded application. If no version is found in the
|
|
* application's `package.json` file, the version of the current bundle or
|
|
* executable is returned.
|
|
*/
|
|
getVersion(): string;
|
|
/**
|
|
* This method returns whether or not this instance of your app is currently
|
|
* holding the single instance lock. You can request the lock with
|
|
* `app.requestSingleInstanceLock()` and release with
|
|
* `app.releaseSingleInstanceLock()`
|
|
*/
|
|
hasSingleInstanceLock(): boolean;
|
|
/**
|
|
* Hides all application windows without minimizing them.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
hide(): void;
|
|
/**
|
|
* Imports the certificate in pkcs12 format into the platform certificate store.
|
|
* `callback` is called with the `result` of import operation, a value of `0`
|
|
* indicates success while any other value indicates failure according to Chromium
|
|
* net_error_list.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
importCertificate(options: ImportCertificateOptions, callback: (result: number) => void): void;
|
|
/**
|
|
* Invalidates the current Handoff user activity.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
invalidateCurrentActivity(): void;
|
|
/**
|
|
* `true` if Chrome's accessibility support is enabled, `false` otherwise. This API
|
|
* will return `true` if the use of assistive technologies, such as screen readers,
|
|
* has been detected. See
|
|
* https://www.chromium.org/developers/design-documents/accessibility for more
|
|
* details.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
isAccessibilitySupportEnabled(): boolean;
|
|
/**
|
|
* Whether the current executable is the default handler for a protocol (aka URI
|
|
* scheme).
|
|
*
|
|
* **Note:** On macOS, you can use this method to check if the app has been
|
|
* registered as the default protocol handler for a protocol. You can also verify
|
|
* this by checking `~/Library/Preferences/com.apple.LaunchServices.plist` on the
|
|
* macOS machine. Please refer to Apple's documentation for details.
|
|
*
|
|
* The API uses the Windows Registry and `LSCopyDefaultHandlerForURLScheme`
|
|
* internally.
|
|
*/
|
|
isDefaultProtocolClient(protocol: string, path?: string, args?: string[]): boolean;
|
|
/**
|
|
* whether or not the current OS version allows for native emoji pickers.
|
|
*/
|
|
isEmojiPanelSupported(): boolean;
|
|
/**
|
|
* `true` if the application—including all of its windows—is hidden (e.g. with
|
|
* `Command-H`), `false` otherwise.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isHidden(): boolean;
|
|
/**
|
|
* Whether the application is currently running from the systems Application
|
|
* folder. Use in combination with `app.moveToApplicationsFolder()`
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isInApplicationsFolder(): boolean;
|
|
/**
|
|
* `true` if Electron has finished initializing, `false` otherwise. See also
|
|
* `app.whenReady()`.
|
|
*/
|
|
isReady(): boolean;
|
|
/**
|
|
* whether `Secure Keyboard Entry` is enabled.
|
|
*
|
|
* By default this API will return `false`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isSecureKeyboardEntryEnabled(): boolean;
|
|
/**
|
|
* Whether the current desktop environment is Unity launcher.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
isUnityRunning(): boolean;
|
|
/**
|
|
* Whether the move was successful. Please note that if the move is successful,
|
|
* your application will quit and relaunch.
|
|
*
|
|
* No confirmation dialog will be presented by default. If you wish to allow the
|
|
* user to confirm the operation, you may do so using the `dialog` API.
|
|
*
|
|
* **NOTE:** This method throws errors if anything other than the user causes the
|
|
* move to fail. For instance if the user cancels the authorization dialog, this
|
|
* method returns false. If we fail to perform the copy, then this method will
|
|
* throw an error. The message in the error should be informative and tell you
|
|
* exactly what went wrong.
|
|
*
|
|
* By default, if an app of the same name as the one being moved exists in the
|
|
* Applications directory and is _not_ running, the existing app will be trashed
|
|
* and the active app moved into its place. If it _is_ running, the preexisting
|
|
* running app will assume focus and the previously active app will quit itself.
|
|
* This behavior can be changed by providing the optional conflict handler, where
|
|
* the boolean returned by the handler determines whether or not the move conflict
|
|
* is resolved with default behavior. i.e. returning `false` will ensure no
|
|
* further action is taken, returning `true` will result in the default behavior
|
|
* and the method continuing.
|
|
*
|
|
* For example:
|
|
*
|
|
* Would mean that if an app already exists in the user directory, if the user
|
|
* chooses to 'Continue Move' then the function would continue with its default
|
|
* behavior and the existing app will be trashed and the active app moved into its
|
|
* place.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
moveToApplicationsFolder(options?: MoveToApplicationsFolderOptions): boolean;
|
|
/**
|
|
* Try to close all windows. The `before-quit` event will be emitted first. If all
|
|
* windows are successfully closed, the `will-quit` event will be emitted and by
|
|
* default the application will terminate.
|
|
*
|
|
* This method guarantees that all `beforeunload` and `unload` event handlers are
|
|
* correctly executed. It is possible that a window cancels the quitting by
|
|
* returning `false` in the `beforeunload` event handler.
|
|
*/
|
|
quit(): void;
|
|
/**
|
|
* Relaunches the app when current instance exits.
|
|
*
|
|
* By default, the new instance will use the same working directory and command
|
|
* line arguments with current instance. When `args` is specified, the `args` will
|
|
* be passed as command line arguments instead. When `execPath` is specified, the
|
|
* `execPath` will be executed for relaunch instead of current app.
|
|
*
|
|
* Note that this method does not quit the app when executed, you have to call
|
|
* `app.quit` or `app.exit` after calling `app.relaunch` to make the app restart.
|
|
*
|
|
* When `app.relaunch` is called for multiple times, multiple instances will be
|
|
* started after current instance exited.
|
|
*
|
|
* An example of restarting current instance immediately and adding a new command
|
|
* line argument to the new instance:
|
|
*/
|
|
relaunch(options?: RelaunchOptions): void;
|
|
/**
|
|
* Releases all locks that were created by `requestSingleInstanceLock`. This will
|
|
* allow multiple instances of the application to once again run side by side.
|
|
*/
|
|
releaseSingleInstanceLock(): void;
|
|
/**
|
|
* Whether the call succeeded.
|
|
*
|
|
* This method checks if the current executable as the default handler for a
|
|
* protocol (aka URI scheme). If so, it will remove the app as the default handler.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
removeAsDefaultProtocolClient(protocol: string, path?: string, args?: string[]): boolean;
|
|
/**
|
|
* The return value of this method indicates whether or not this instance of your
|
|
* application successfully obtained the lock. If it failed to obtain the lock,
|
|
* you can assume that another instance of your application is already running with
|
|
* the lock and exit immediately.
|
|
*
|
|
* I.e. This method returns `true` if your process is the primary instance of your
|
|
* application and your app should continue loading. It returns `false` if your
|
|
* process should immediately quit as it has sent its parameters to another
|
|
* instance that has already acquired the lock.
|
|
*
|
|
* On macOS, the system enforces single instance automatically when users try to
|
|
* open a second instance of your app in Finder, and the `open-file` and `open-url`
|
|
* events will be emitted for that. However when users start your app in command
|
|
* line, the system's single instance mechanism will be bypassed, and you have to
|
|
* use this method to ensure single instance.
|
|
*
|
|
* An example of activating the window of primary instance when a second instance
|
|
* starts:
|
|
*/
|
|
requestSingleInstanceLock(additionalData?: Record<any, any>): boolean;
|
|
/**
|
|
* Marks the current Handoff user activity as inactive without invalidating it.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
resignCurrentActivity(): void;
|
|
/**
|
|
* Set the about panel options. This will override the values defined in the app's
|
|
* `.plist` file on macOS. See the Apple docs for more details. On Linux, values
|
|
* must be set in order to be shown; there are no defaults.
|
|
*
|
|
* If you do not set `credits` but still wish to surface them in your app, AppKit
|
|
* will look for a file named "Credits.html", "Credits.rtf", and "Credits.rtfd", in
|
|
* that order, in the bundle returned by the NSBundle class method main. The first
|
|
* file found is used, and if none is found, the info area is left blank. See Apple
|
|
* documentation for more information.
|
|
*/
|
|
setAboutPanelOptions(options: AboutPanelOptionsOptions): void;
|
|
/**
|
|
* Manually enables Chrome's accessibility support, allowing to expose
|
|
* accessibility switch to users in application settings. See Chromium's
|
|
* accessibility docs for more details. Disabled by default.
|
|
*
|
|
* This API must be called after the `ready` event is emitted.
|
|
*
|
|
* **Note:** Rendering accessibility tree can significantly affect the performance
|
|
* of your app. It should not be enabled by default.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setAccessibilitySupportEnabled(enabled: boolean): void;
|
|
/**
|
|
* Sets the activation policy for a given app.
|
|
*
|
|
* Activation policy types:
|
|
*
|
|
* * 'regular' - The application is an ordinary app that appears in the Dock and
|
|
* may have a user interface.
|
|
* * 'accessory' - The application doesn’t appear in the Dock and doesn’t have a
|
|
* menu bar, but it may be activated programmatically or by clicking on one of its
|
|
* windows.
|
|
* * 'prohibited' - The application doesn’t appear in the Dock and may not create
|
|
* windows or be activated.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setActivationPolicy(policy: 'regular' | 'accessory' | 'prohibited'): void;
|
|
/**
|
|
* Sets or creates a directory your app's logs which can then be manipulated with
|
|
* `app.getPath()` or `app.setPath(pathName, newPath)`.
|
|
*
|
|
* Calling `app.setAppLogsPath()` without a `path` parameter will result in this
|
|
* directory being set to `~/Library/Logs/YourAppName` on _macOS_, and inside the
|
|
* `userData` directory on _Linux_ and _Windows_.
|
|
*/
|
|
setAppLogsPath(path?: string): void;
|
|
/**
|
|
* Changes the Application User Model ID to `id`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setAppUserModelId(id: string): void;
|
|
/**
|
|
* Whether the call succeeded.
|
|
*
|
|
* Sets the current executable as the default handler for a protocol (aka URI
|
|
* scheme). It allows you to integrate your app deeper into the operating system.
|
|
* Once registered, all links with `your-protocol://` will be opened with the
|
|
* current executable. The whole link, including protocol, will be passed to your
|
|
* application as a parameter.
|
|
*
|
|
* **Note:** On macOS, you can only register protocols that have been added to your
|
|
* app's `info.plist`, which cannot be modified at runtime. However, you can change
|
|
* the file during build time via Electron Forge, Electron Packager, or by editing
|
|
* `info.plist` with a text editor. Please refer to Apple's documentation for
|
|
* details.
|
|
*
|
|
* **Note:** In a Windows Store environment (when packaged as an `appx`) this API
|
|
* will return `true` for all calls but the registry key it sets won't be
|
|
* accessible by other applications. In order to register your Windows Store
|
|
* application as a default protocol handler you must declare the protocol in your
|
|
* manifest.
|
|
*
|
|
* The API uses the Windows Registry and `LSSetDefaultHandlerForURLScheme`
|
|
* internally.
|
|
*/
|
|
setAsDefaultProtocolClient(protocol: string, path?: string, args?: string[]): boolean;
|
|
/**
|
|
* Whether the call succeeded.
|
|
*
|
|
* Sets the counter badge for current app. Setting the count to `0` will hide the
|
|
* badge.
|
|
*
|
|
* On macOS, it shows on the dock icon. On Linux, it only works for Unity launcher.
|
|
*
|
|
* **Note:** Unity launcher requires a `.desktop` file to work. For more
|
|
* information, please read the Unity integration documentation.
|
|
*
|
|
* **Note:** On macOS, you need to ensure that your application has the permission
|
|
* to display notifications for this method to work.
|
|
*
|
|
* @platform linux,darwin
|
|
*/
|
|
setBadgeCount(count?: number): boolean;
|
|
/**
|
|
* Sets or removes a custom Jump List for the application, and returns one of the
|
|
* following strings:
|
|
*
|
|
* * `ok` - Nothing went wrong.
|
|
* * `error` - One or more errors occurred, enable runtime logging to figure out
|
|
* the likely cause.
|
|
* * `invalidSeparatorError` - An attempt was made to add a separator to a custom
|
|
* category in the Jump List. Separators are only allowed in the standard `Tasks`
|
|
* category.
|
|
* * `fileTypeRegistrationError` - An attempt was made to add a file link to the
|
|
* Jump List for a file type the app isn't registered to handle.
|
|
* * `customCategoryAccessDeniedError` - Custom categories can't be added to the
|
|
* Jump List due to user privacy or group policy settings.
|
|
*
|
|
* If `categories` is `null` the previously set custom Jump List (if any) will be
|
|
* replaced by the standard Jump List for the app (managed by Windows).
|
|
*
|
|
* **Note:** If a `JumpListCategory` object has neither the `type` nor the `name`
|
|
* property set then its `type` is assumed to be `tasks`. If the `name` property is
|
|
* set but the `type` property is omitted then the `type` is assumed to be
|
|
* `custom`.
|
|
*
|
|
* **Note:** Users can remove items from custom categories, and Windows will not
|
|
* allow a removed item to be added back into a custom category until **after** the
|
|
* next successful call to `app.setJumpList(categories)`. Any attempt to re-add a
|
|
* removed item to a custom category earlier than that will result in the entire
|
|
* custom category being omitted from the Jump List. The list of removed items can
|
|
* be obtained using `app.getJumpListSettings()`.
|
|
*
|
|
* **Note:** The maximum length of a Jump List item's `description` property is 260
|
|
* characters. Beyond this limit, the item will not be added to the Jump List, nor
|
|
* will it be displayed.
|
|
*
|
|
* Here's a very simple example of creating a custom Jump List:
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setJumpList(categories: (JumpListCategory[]) | (null)): ('ok' | 'error' | 'invalidSeparatorError' | 'fileTypeRegistrationError' | 'customCategoryAccessDeniedError');
|
|
/**
|
|
* To work with Electron's `autoUpdater` on Windows, which uses Squirrel, you'll
|
|
* want to set the launch path to Update.exe, and pass arguments that specify your
|
|
* application name. For example:
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setLoginItemSettings(settings: Settings): void;
|
|
/**
|
|
* Overrides the current application's name.
|
|
*
|
|
* **Note:** This function overrides the name used internally by Electron; it does
|
|
* not affect the name that the OS uses.
|
|
*/
|
|
setName(name: string): void;
|
|
/**
|
|
* Overrides the `path` to a special directory or file associated with `name`. If
|
|
* the path specifies a directory that does not exist, an `Error` is thrown. In
|
|
* that case, the directory should be created with `fs.mkdirSync` or similar.
|
|
*
|
|
* You can only override paths of a `name` defined in `app.getPath`.
|
|
*
|
|
* By default, web pages' cookies and caches will be stored under the `sessionData`
|
|
* directory. If you want to change this location, you have to override the
|
|
* `sessionData` path before the `ready` event of the `app` module is emitted.
|
|
*/
|
|
setPath(name: string, path: string): void;
|
|
/**
|
|
* Set the `Secure Keyboard Entry` is enabled in your application.
|
|
*
|
|
* By using this API, important information such as password and other sensitive
|
|
* information can be prevented from being intercepted by other processes.
|
|
*
|
|
* See Apple's documentation for more details.
|
|
*
|
|
* **Note:** Enable `Secure Keyboard Entry` only when it is needed and disable it
|
|
* when it is no longer needed.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setSecureKeyboardEntryEnabled(enabled: boolean): void;
|
|
/**
|
|
* Creates an `NSUserActivity` and sets it as the current activity. The activity is
|
|
* eligible for Handoff to another device afterward.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setUserActivity(type: string, userInfo: any, webpageURL?: string): void;
|
|
/**
|
|
* Adds `tasks` to the Tasks category of the Jump List on Windows.
|
|
*
|
|
* `tasks` is an array of `Task` objects.
|
|
*
|
|
* Whether the call succeeded.
|
|
*
|
|
* **Note:** If you'd like to customize the Jump List even more use
|
|
* `app.setJumpList(categories)` instead.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setUserTasks(tasks: Task[]): boolean;
|
|
/**
|
|
* Shows application windows after they were hidden. Does not automatically focus
|
|
* them.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
show(): void;
|
|
/**
|
|
* Show the app's about panel options. These options can be overridden with
|
|
* `app.setAboutPanelOptions(options)`. This function runs asynchronously.
|
|
*/
|
|
showAboutPanel(): void;
|
|
/**
|
|
* Show the platform's native emoji picker.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
showEmojiPanel(): void;
|
|
/**
|
|
* This function **must** be called once you have finished accessing the security
|
|
* scoped file. If you do not remember to stop accessing the bookmark, kernel
|
|
* resources will be leaked and your app will lose its ability to reach outside the
|
|
* sandbox completely, until your app is restarted.
|
|
*
|
|
* Start accessing a security scoped resource. With this method Electron
|
|
* applications that are packaged for the Mac App Store may reach outside their
|
|
* sandbox to access files chosen by the user. See Apple's documentation for a
|
|
* description of how this system works.
|
|
*
|
|
* @platform mas
|
|
*/
|
|
startAccessingSecurityScopedResource(bookmarkData: string): Function;
|
|
/**
|
|
* Updates the current activity if its type matches `type`, merging the entries
|
|
* from `userInfo` into its current `userInfo` dictionary.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
updateCurrentActivity(type: string, userInfo: any): void;
|
|
/**
|
|
* fulfilled when Electron is initialized. May be used as a convenient alternative
|
|
* to checking `app.isReady()` and subscribing to the `ready` event if the app is
|
|
* not ready yet.
|
|
*/
|
|
whenReady(): Promise<void>;
|
|
/**
|
|
* A `boolean` property that's `true` if Chrome's accessibility support is enabled,
|
|
* `false` otherwise. This property will be `true` if the use of assistive
|
|
* technologies, such as screen readers, has been detected. Setting this property
|
|
* to `true` manually enables Chrome's accessibility support, allowing developers
|
|
* to expose accessibility switch to users in application settings.
|
|
*
|
|
* See Chromium's accessibility docs for more details. Disabled by default.
|
|
*
|
|
* This API must be called after the `ready` event is emitted.
|
|
*
|
|
* **Note:** Rendering accessibility tree can significantly affect the performance
|
|
* of your app. It should not be enabled by default.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
accessibilitySupportEnabled: boolean;
|
|
/**
|
|
* A `Menu | null` property that returns `Menu` if one has been set and `null`
|
|
* otherwise. Users can pass a Menu to set this property.
|
|
*/
|
|
applicationMenu: (Menu) | (null);
|
|
/**
|
|
* An `Integer` property that returns the badge count for current app. Setting the
|
|
* count to `0` will hide the badge.
|
|
*
|
|
* On macOS, setting this with any nonzero integer shows on the dock icon. On
|
|
* Linux, this property only works for Unity launcher.
|
|
*
|
|
* **Note:** Unity launcher requires a `.desktop` file to work. For more
|
|
* information, please read the Unity integration documentation.
|
|
*
|
|
* **Note:** On macOS, you need to ensure that your application has the permission
|
|
* to display notifications for this property to take effect.
|
|
*
|
|
* @platform linux,darwin
|
|
*/
|
|
badgeCount: number;
|
|
/**
|
|
* A `CommandLine` object that allows you to read and manipulate the command line
|
|
* arguments that Chromium uses.
|
|
*
|
|
*/
|
|
readonly commandLine: CommandLine;
|
|
/**
|
|
* A `Dock` `| undefined` object that allows you to perform actions on your app
|
|
* icon in the user's dock on macOS.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
readonly dock: Dock;
|
|
/**
|
|
* A `boolean` property that returns `true` if the app is packaged, `false`
|
|
* otherwise. For many apps, this property can be used to distinguish development
|
|
* and production environments.
|
|
*
|
|
*/
|
|
readonly isPackaged: boolean;
|
|
/**
|
|
* A `string` property that indicates the current application's name, which is the
|
|
* name in the application's `package.json` file.
|
|
*
|
|
* Usually the `name` field of `package.json` is a short lowercase name, according
|
|
* to the npm modules spec. You should usually also specify a `productName` field,
|
|
* which is your application's full capitalized name, and which will be preferred
|
|
* over `name` by Electron.
|
|
*/
|
|
name: string;
|
|
/**
|
|
* A `boolean` which when `true` indicates that the app is currently running under
|
|
* an ARM64 translator (like the macOS Rosetta Translator Environment or Windows
|
|
* WOW).
|
|
*
|
|
* You can use this property to prompt users to download the arm64 version of your
|
|
* application when they are mistakenly running the x64 version under Rosetta or
|
|
* WOW.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
readonly runningUnderARM64Translation: boolean;
|
|
/**
|
|
* A `boolean` which when `true` indicates that the app is currently running under
|
|
* the Rosetta Translator Environment.
|
|
*
|
|
* You can use this property to prompt users to download the arm64 version of your
|
|
* application when they are running the x64 version under Rosetta incorrectly.
|
|
*
|
|
* **Deprecated:** This property is superceded by the
|
|
* `runningUnderARM64Translation` property which detects when the app is being
|
|
* translated to ARM64 in both macOS and Windows.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
readonly runningUnderRosettaTranslation: boolean;
|
|
/**
|
|
* A `string` which is the user agent string Electron will use as a global
|
|
* fallback.
|
|
*
|
|
* This is the user agent that will be used when no user agent is set at the
|
|
* `webContents` or `session` level. It is useful for ensuring that your entire
|
|
* app has the same user agent. Set to a custom value as early as possible in your
|
|
* app's initialization to ensure that your overridden value is used.
|
|
*/
|
|
userAgentFallback: string;
|
|
}
|
|
|
|
interface AutoUpdater extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/auto-updater
|
|
|
|
/**
|
|
* This event is emitted after a user calls `quitAndInstall()`.
|
|
*
|
|
* When this API is called, the `before-quit` event is not emitted before all
|
|
* windows are closed. As a result you should listen to this event if you wish to
|
|
* perform actions before the windows are closed while a process is quitting, as
|
|
* well as listening to `before-quit`.
|
|
*/
|
|
on(event: 'before-quit-for-update', listener: Function): this;
|
|
once(event: 'before-quit-for-update', listener: Function): this;
|
|
addListener(event: 'before-quit-for-update', listener: Function): this;
|
|
removeListener(event: 'before-quit-for-update', listener: Function): this;
|
|
/**
|
|
* Emitted when checking if an update has started.
|
|
*/
|
|
on(event: 'checking-for-update', listener: Function): this;
|
|
once(event: 'checking-for-update', listener: Function): this;
|
|
addListener(event: 'checking-for-update', listener: Function): this;
|
|
removeListener(event: 'checking-for-update', listener: Function): this;
|
|
/**
|
|
* Emitted when there is an error while updating.
|
|
*/
|
|
on(event: 'error', listener: (error: Error) => void): this;
|
|
once(event: 'error', listener: (error: Error) => void): this;
|
|
addListener(event: 'error', listener: (error: Error) => void): this;
|
|
removeListener(event: 'error', listener: (error: Error) => void): this;
|
|
/**
|
|
* Emitted when there is an available update. The update is downloaded
|
|
* automatically.
|
|
*/
|
|
on(event: 'update-available', listener: Function): this;
|
|
once(event: 'update-available', listener: Function): this;
|
|
addListener(event: 'update-available', listener: Function): this;
|
|
removeListener(event: 'update-available', listener: Function): this;
|
|
/**
|
|
* Emitted when an update has been downloaded.
|
|
*
|
|
* On Windows only `releaseName` is available.
|
|
*
|
|
* **Note:** It is not strictly necessary to handle this event. A successfully
|
|
* downloaded update will still be applied the next time the application starts.
|
|
*/
|
|
on(event: 'update-downloaded', listener: (event: Event,
|
|
releaseNotes: string,
|
|
releaseName: string,
|
|
releaseDate: Date,
|
|
updateURL: string) => void): this;
|
|
once(event: 'update-downloaded', listener: (event: Event,
|
|
releaseNotes: string,
|
|
releaseName: string,
|
|
releaseDate: Date,
|
|
updateURL: string) => void): this;
|
|
addListener(event: 'update-downloaded', listener: (event: Event,
|
|
releaseNotes: string,
|
|
releaseName: string,
|
|
releaseDate: Date,
|
|
updateURL: string) => void): this;
|
|
removeListener(event: 'update-downloaded', listener: (event: Event,
|
|
releaseNotes: string,
|
|
releaseName: string,
|
|
releaseDate: Date,
|
|
updateURL: string) => void): this;
|
|
/**
|
|
* Emitted when there is no available update.
|
|
*/
|
|
on(event: 'update-not-available', listener: Function): this;
|
|
once(event: 'update-not-available', listener: Function): this;
|
|
addListener(event: 'update-not-available', listener: Function): this;
|
|
removeListener(event: 'update-not-available', listener: Function): this;
|
|
/**
|
|
* Asks the server whether there is an update. You must call `setFeedURL` before
|
|
* using this API.
|
|
*
|
|
* **Note:** If an update is available it will be downloaded automatically. Calling
|
|
* `autoUpdater.checkForUpdates()` twice will download the update two times.
|
|
*/
|
|
checkForUpdates(): void;
|
|
/**
|
|
* The current update feed URL.
|
|
*/
|
|
getFeedURL(): string;
|
|
/**
|
|
* Restarts the app and installs the update after it has been downloaded. It should
|
|
* only be called after `update-downloaded` has been emitted.
|
|
*
|
|
* Under the hood calling `autoUpdater.quitAndInstall()` will close all application
|
|
* windows first, and automatically call `app.quit()` after all windows have been
|
|
* closed.
|
|
*
|
|
* **Note:** It is not strictly necessary to call this function to apply an update,
|
|
* as a successfully downloaded update will always be applied the next time the
|
|
* application starts.
|
|
*/
|
|
quitAndInstall(): void;
|
|
/**
|
|
* Sets the `url` and initialize the auto updater.
|
|
*/
|
|
setFeedURL(options: FeedURLOptions): void;
|
|
}
|
|
|
|
interface BluetoothDevice {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/bluetooth-device
|
|
|
|
deviceId: string;
|
|
deviceName: string;
|
|
}
|
|
|
|
class BrowserView {
|
|
|
|
// Docs: https://electronjs.org/docs/api/browser-view
|
|
|
|
/**
|
|
* BrowserView
|
|
*/
|
|
constructor(options?: BrowserViewConstructorOptions);
|
|
/**
|
|
* The `bounds` of this BrowserView instance as `Object`.
|
|
*
|
|
* @experimental
|
|
*/
|
|
getBounds(): Rectangle;
|
|
/**
|
|
* @experimental
|
|
*/
|
|
setAutoResize(options: AutoResizeOptions): void;
|
|
/**
|
|
* Examples of valid `color` values:
|
|
*
|
|
* * Hex
|
|
* * #fff (RGB)
|
|
* * #ffff (ARGB)
|
|
* * #ffffff (RRGGBB)
|
|
* * #ffffffff (AARRGGBB)
|
|
* * RGB
|
|
* * rgb(([\d]+),\s*([\d]+),\s*([\d]+))
|
|
* * e.g. rgb(255, 255, 255)
|
|
* * RGBA
|
|
* * rgba(([\d]+),\s*([\d]+),\s*([\d]+),\s*([\d.]+))
|
|
* * e.g. rgba(255, 255, 255, 1.0)
|
|
* * HSL
|
|
* * hsl((-?[\d.]+),\s*([\d.]+)%,\s*([\d.]+)%)
|
|
* * e.g. hsl(200, 20%, 50%)
|
|
* * HSLA
|
|
* * hsla((-?[\d.]+),\s*([\d.]+)%,\s*([\d.]+)%,\s*([\d.]+))
|
|
* * e.g. hsla(200, 20%, 50%, 0.5)
|
|
* * Color name
|
|
* * Options are listed in SkParseColor.cpp
|
|
* * Similar to CSS Color Module Level 3 keywords, but case-sensitive.
|
|
* * e.g. `blueviolet` or `red`
|
|
*
|
|
* **Note:** Hex format with alpha takes `AARRGGBB` or `ARGB`, _not_ `RRGGBBA` or
|
|
* `RGA`.
|
|
*
|
|
* @experimental
|
|
*/
|
|
setBackgroundColor(color: string): void;
|
|
/**
|
|
* Resizes and moves the view to the supplied bounds relative to the window.
|
|
*
|
|
* @experimental
|
|
*/
|
|
setBounds(bounds: Rectangle): void;
|
|
/**
|
|
* A `WebContents` object owned by this view.
|
|
*
|
|
* @experimental
|
|
*/
|
|
webContents: WebContents;
|
|
}
|
|
|
|
class BrowserWindow extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/browser-window
|
|
|
|
/**
|
|
* Emitted when the window is set or unset to show always on top of other windows.
|
|
*/
|
|
on(event: 'always-on-top-changed', listener: (event: Event,
|
|
isAlwaysOnTop: boolean) => void): this;
|
|
once(event: 'always-on-top-changed', listener: (event: Event,
|
|
isAlwaysOnTop: boolean) => void): this;
|
|
addListener(event: 'always-on-top-changed', listener: (event: Event,
|
|
isAlwaysOnTop: boolean) => void): this;
|
|
removeListener(event: 'always-on-top-changed', listener: (event: Event,
|
|
isAlwaysOnTop: boolean) => void): this;
|
|
/**
|
|
* Emitted when an App Command is invoked. These are typically related to keyboard
|
|
* media keys or browser commands, as well as the "Back" button built into some
|
|
* mice on Windows.
|
|
*
|
|
* Commands are lowercased, underscores are replaced with hyphens, and the
|
|
* `APPCOMMAND_` prefix is stripped off. e.g. `APPCOMMAND_BROWSER_BACKWARD` is
|
|
* emitted as `browser-backward`.
|
|
*
|
|
* The following app commands are explicitly supported on Linux:
|
|
*
|
|
* * `browser-backward`
|
|
* * `browser-forward`
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
on(event: 'app-command', listener: (event: Event,
|
|
command: string) => void): this;
|
|
once(event: 'app-command', listener: (event: Event,
|
|
command: string) => void): this;
|
|
addListener(event: 'app-command', listener: (event: Event,
|
|
command: string) => void): this;
|
|
removeListener(event: 'app-command', listener: (event: Event,
|
|
command: string) => void): this;
|
|
/**
|
|
* Emitted when the window loses focus.
|
|
*/
|
|
on(event: 'blur', listener: Function): this;
|
|
once(event: 'blur', listener: Function): this;
|
|
addListener(event: 'blur', listener: Function): this;
|
|
removeListener(event: 'blur', listener: Function): this;
|
|
/**
|
|
* Emitted when the window is going to be closed. It's emitted before the
|
|
* `beforeunload` and `unload` event of the DOM. Calling `event.preventDefault()`
|
|
* will cancel the close.
|
|
*
|
|
* Usually you would want to use the `beforeunload` handler to decide whether the
|
|
* window should be closed, which will also be called when the window is reloaded.
|
|
* In Electron, returning any value other than `undefined` would cancel the close.
|
|
* For example:
|
|
*
|
|
* _**Note**: There is a subtle difference between the behaviors of
|
|
* `window.onbeforeunload = handler` and `window.addEventListener('beforeunload',
|
|
* handler)`. It is recommended to always set the `event.returnValue` explicitly,
|
|
* instead of only returning a value, as the former works more consistently within
|
|
* Electron._
|
|
*/
|
|
on(event: 'close', listener: (event: Event) => void): this;
|
|
once(event: 'close', listener: (event: Event) => void): this;
|
|
addListener(event: 'close', listener: (event: Event) => void): this;
|
|
removeListener(event: 'close', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when the window is closed. After you have received this event you should
|
|
* remove the reference to the window and avoid using it any more.
|
|
*/
|
|
on(event: 'closed', listener: Function): this;
|
|
once(event: 'closed', listener: Function): this;
|
|
addListener(event: 'closed', listener: Function): this;
|
|
removeListener(event: 'closed', listener: Function): this;
|
|
/**
|
|
* Emitted when the window enters a full-screen state.
|
|
*/
|
|
on(event: 'enter-full-screen', listener: Function): this;
|
|
once(event: 'enter-full-screen', listener: Function): this;
|
|
addListener(event: 'enter-full-screen', listener: Function): this;
|
|
removeListener(event: 'enter-full-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when the window enters a full-screen state triggered by HTML API.
|
|
*/
|
|
on(event: 'enter-html-full-screen', listener: Function): this;
|
|
once(event: 'enter-html-full-screen', listener: Function): this;
|
|
addListener(event: 'enter-html-full-screen', listener: Function): this;
|
|
removeListener(event: 'enter-html-full-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when the window gains focus.
|
|
*/
|
|
on(event: 'focus', listener: Function): this;
|
|
once(event: 'focus', listener: Function): this;
|
|
addListener(event: 'focus', listener: Function): this;
|
|
removeListener(event: 'focus', listener: Function): this;
|
|
/**
|
|
* Emitted when the window is hidden.
|
|
*/
|
|
on(event: 'hide', listener: Function): this;
|
|
once(event: 'hide', listener: Function): this;
|
|
addListener(event: 'hide', listener: Function): this;
|
|
removeListener(event: 'hide', listener: Function): this;
|
|
/**
|
|
* Emitted when the window leaves a full-screen state.
|
|
*/
|
|
on(event: 'leave-full-screen', listener: Function): this;
|
|
once(event: 'leave-full-screen', listener: Function): this;
|
|
addListener(event: 'leave-full-screen', listener: Function): this;
|
|
removeListener(event: 'leave-full-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when the window leaves a full-screen state triggered by HTML API.
|
|
*/
|
|
on(event: 'leave-html-full-screen', listener: Function): this;
|
|
once(event: 'leave-html-full-screen', listener: Function): this;
|
|
addListener(event: 'leave-html-full-screen', listener: Function): this;
|
|
removeListener(event: 'leave-html-full-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when window is maximized.
|
|
*/
|
|
on(event: 'maximize', listener: Function): this;
|
|
once(event: 'maximize', listener: Function): this;
|
|
addListener(event: 'maximize', listener: Function): this;
|
|
removeListener(event: 'maximize', listener: Function): this;
|
|
/**
|
|
* Emitted when the window is minimized.
|
|
*/
|
|
on(event: 'minimize', listener: Function): this;
|
|
once(event: 'minimize', listener: Function): this;
|
|
addListener(event: 'minimize', listener: Function): this;
|
|
removeListener(event: 'minimize', listener: Function): this;
|
|
/**
|
|
* Emitted when the window is being moved to a new position.
|
|
*/
|
|
on(event: 'move', listener: Function): this;
|
|
once(event: 'move', listener: Function): this;
|
|
addListener(event: 'move', listener: Function): this;
|
|
removeListener(event: 'move', listener: Function): this;
|
|
/**
|
|
* Emitted once when the window is moved to a new position.
|
|
*
|
|
* **Note**: On macOS this event is an alias of `move`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'moved', listener: Function): this;
|
|
once(event: 'moved', listener: Function): this;
|
|
addListener(event: 'moved', listener: Function): this;
|
|
removeListener(event: 'moved', listener: Function): this;
|
|
/**
|
|
* Emitted when the native new tab button is clicked.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'new-window-for-tab', listener: Function): this;
|
|
once(event: 'new-window-for-tab', listener: Function): this;
|
|
addListener(event: 'new-window-for-tab', listener: Function): this;
|
|
removeListener(event: 'new-window-for-tab', listener: Function): this;
|
|
/**
|
|
* Emitted when the document changed its title, calling `event.preventDefault()`
|
|
* will prevent the native window's title from changing. `explicitSet` is false
|
|
* when title is synthesized from file URL.
|
|
*/
|
|
on(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
once(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
addListener(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
removeListener(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
/**
|
|
* Emitted when the web page has been rendered (while not being shown) and window
|
|
* can be displayed without a visual flash.
|
|
*
|
|
* Please note that using this event implies that the renderer will be considered
|
|
* "visible" and paint even though `show` is false. This event will never fire if
|
|
* you use `paintWhenInitiallyHidden: false`
|
|
*/
|
|
on(event: 'ready-to-show', listener: Function): this;
|
|
once(event: 'ready-to-show', listener: Function): this;
|
|
addListener(event: 'ready-to-show', listener: Function): this;
|
|
removeListener(event: 'ready-to-show', listener: Function): this;
|
|
/**
|
|
* Emitted after the window has been resized.
|
|
*/
|
|
on(event: 'resize', listener: Function): this;
|
|
once(event: 'resize', listener: Function): this;
|
|
addListener(event: 'resize', listener: Function): this;
|
|
removeListener(event: 'resize', listener: Function): this;
|
|
/**
|
|
* Emitted once when the window has finished being resized.
|
|
*
|
|
* This is usually emitted when the window has been resized manually. On macOS,
|
|
* resizing the window with `setBounds`/`setSize` and setting the `animate`
|
|
* parameter to `true` will also emit this event once resizing has finished.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'resized', listener: Function): this;
|
|
once(event: 'resized', listener: Function): this;
|
|
addListener(event: 'resized', listener: Function): this;
|
|
removeListener(event: 'resized', listener: Function): this;
|
|
/**
|
|
* Emitted when the unresponsive web page becomes responsive again.
|
|
*/
|
|
on(event: 'responsive', listener: Function): this;
|
|
once(event: 'responsive', listener: Function): this;
|
|
addListener(event: 'responsive', listener: Function): this;
|
|
removeListener(event: 'responsive', listener: Function): this;
|
|
/**
|
|
* Emitted when the window is restored from a minimized state.
|
|
*/
|
|
on(event: 'restore', listener: Function): this;
|
|
once(event: 'restore', listener: Function): this;
|
|
addListener(event: 'restore', listener: Function): this;
|
|
removeListener(event: 'restore', listener: Function): this;
|
|
/**
|
|
* Emitted on trackpad rotation gesture. Continually emitted until rotation gesture
|
|
* is ended. The `rotation` value on each emission is the angle in degrees rotated
|
|
* since the last emission. The last emitted event upon a rotation gesture will
|
|
* always be of value `0`. Counter-clockwise rotation values are positive, while
|
|
* clockwise ones are negative.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'rotate-gesture', listener: (event: Event,
|
|
rotation: number) => void): this;
|
|
once(event: 'rotate-gesture', listener: (event: Event,
|
|
rotation: number) => void): this;
|
|
addListener(event: 'rotate-gesture', listener: (event: Event,
|
|
rotation: number) => void): this;
|
|
removeListener(event: 'rotate-gesture', listener: (event: Event,
|
|
rotation: number) => void): this;
|
|
/**
|
|
* Emitted when scroll wheel event phase has begun.
|
|
*
|
|
* > **Note** This event is deprecated beginning in Electron 22.0.0. See Breaking
|
|
* Changes for details of how to migrate to using the WebContents `input-event`
|
|
* event.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'scroll-touch-begin', listener: Function): this;
|
|
once(event: 'scroll-touch-begin', listener: Function): this;
|
|
addListener(event: 'scroll-touch-begin', listener: Function): this;
|
|
removeListener(event: 'scroll-touch-begin', listener: Function): this;
|
|
/**
|
|
* Emitted when scroll wheel event phase filed upon reaching the edge of element.
|
|
*
|
|
* > **Note** This event is deprecated beginning in Electron 22.0.0. See Breaking
|
|
* Changes for details of how to migrate to using the WebContents `input-event`
|
|
* event.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'scroll-touch-edge', listener: Function): this;
|
|
once(event: 'scroll-touch-edge', listener: Function): this;
|
|
addListener(event: 'scroll-touch-edge', listener: Function): this;
|
|
removeListener(event: 'scroll-touch-edge', listener: Function): this;
|
|
/**
|
|
* Emitted when scroll wheel event phase has ended.
|
|
*
|
|
* > **Note** This event is deprecated beginning in Electron 22.0.0. See Breaking
|
|
* Changes for details of how to migrate to using the WebContents `input-event`
|
|
* event.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'scroll-touch-end', listener: Function): this;
|
|
once(event: 'scroll-touch-end', listener: Function): this;
|
|
addListener(event: 'scroll-touch-end', listener: Function): this;
|
|
removeListener(event: 'scroll-touch-end', listener: Function): this;
|
|
/**
|
|
* Emitted when window session is going to end due to force shutdown or machine
|
|
* restart or session log off.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
on(event: 'session-end', listener: Function): this;
|
|
once(event: 'session-end', listener: Function): this;
|
|
addListener(event: 'session-end', listener: Function): this;
|
|
removeListener(event: 'session-end', listener: Function): this;
|
|
/**
|
|
* Emitted when the window opens a sheet.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'sheet-begin', listener: Function): this;
|
|
once(event: 'sheet-begin', listener: Function): this;
|
|
addListener(event: 'sheet-begin', listener: Function): this;
|
|
removeListener(event: 'sheet-begin', listener: Function): this;
|
|
/**
|
|
* Emitted when the window has closed a sheet.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'sheet-end', listener: Function): this;
|
|
once(event: 'sheet-end', listener: Function): this;
|
|
addListener(event: 'sheet-end', listener: Function): this;
|
|
removeListener(event: 'sheet-end', listener: Function): this;
|
|
/**
|
|
* Emitted when the window is shown.
|
|
*/
|
|
on(event: 'show', listener: Function): this;
|
|
once(event: 'show', listener: Function): this;
|
|
addListener(event: 'show', listener: Function): this;
|
|
removeListener(event: 'show', listener: Function): this;
|
|
/**
|
|
* Emitted on 3-finger swipe. Possible directions are `up`, `right`, `down`,
|
|
* `left`.
|
|
*
|
|
* The method underlying this event is built to handle older macOS-style trackpad
|
|
* swiping, where the content on the screen doesn't move with the swipe. Most macOS
|
|
* trackpads are not configured to allow this kind of swiping anymore, so in order
|
|
* for it to emit properly the 'Swipe between pages' preference in `System
|
|
* Preferences > Trackpad > More Gestures` must be set to 'Swipe with two or three
|
|
* fingers'.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'swipe', listener: (event: Event,
|
|
direction: string) => void): this;
|
|
once(event: 'swipe', listener: (event: Event,
|
|
direction: string) => void): this;
|
|
addListener(event: 'swipe', listener: (event: Event,
|
|
direction: string) => void): this;
|
|
removeListener(event: 'swipe', listener: (event: Event,
|
|
direction: string) => void): this;
|
|
/**
|
|
* Emitted when the system context menu is triggered on the window, this is
|
|
* normally only triggered when the user right clicks on the non-client area of
|
|
* your window. This is the window titlebar or any area you have declared as
|
|
* `-webkit-app-region: drag` in a frameless window.
|
|
*
|
|
* Calling `event.preventDefault()` will prevent the menu from being displayed.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
on(event: 'system-context-menu', listener: (event: Event,
|
|
/**
|
|
* The screen coordinates the context menu was triggered at
|
|
*/
|
|
point: Point) => void): this;
|
|
once(event: 'system-context-menu', listener: (event: Event,
|
|
/**
|
|
* The screen coordinates the context menu was triggered at
|
|
*/
|
|
point: Point) => void): this;
|
|
addListener(event: 'system-context-menu', listener: (event: Event,
|
|
/**
|
|
* The screen coordinates the context menu was triggered at
|
|
*/
|
|
point: Point) => void): this;
|
|
removeListener(event: 'system-context-menu', listener: (event: Event,
|
|
/**
|
|
* The screen coordinates the context menu was triggered at
|
|
*/
|
|
point: Point) => void): this;
|
|
/**
|
|
* Emitted when the window exits from a maximized state.
|
|
*/
|
|
on(event: 'unmaximize', listener: Function): this;
|
|
once(event: 'unmaximize', listener: Function): this;
|
|
addListener(event: 'unmaximize', listener: Function): this;
|
|
removeListener(event: 'unmaximize', listener: Function): this;
|
|
/**
|
|
* Emitted when the web page becomes unresponsive.
|
|
*/
|
|
on(event: 'unresponsive', listener: Function): this;
|
|
once(event: 'unresponsive', listener: Function): this;
|
|
addListener(event: 'unresponsive', listener: Function): this;
|
|
removeListener(event: 'unresponsive', listener: Function): this;
|
|
/**
|
|
* Emitted before the window is moved. On Windows, calling `event.preventDefault()`
|
|
* will prevent the window from being moved.
|
|
*
|
|
* Note that this is only emitted when the window is being moved manually. Moving
|
|
* the window with `setPosition`/`setBounds`/`center` will not emit this event.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'will-move', listener: (event: Event,
|
|
/**
|
|
* Location the window is being moved to.
|
|
*/
|
|
newBounds: Rectangle) => void): this;
|
|
once(event: 'will-move', listener: (event: Event,
|
|
/**
|
|
* Location the window is being moved to.
|
|
*/
|
|
newBounds: Rectangle) => void): this;
|
|
addListener(event: 'will-move', listener: (event: Event,
|
|
/**
|
|
* Location the window is being moved to.
|
|
*/
|
|
newBounds: Rectangle) => void): this;
|
|
removeListener(event: 'will-move', listener: (event: Event,
|
|
/**
|
|
* Location the window is being moved to.
|
|
*/
|
|
newBounds: Rectangle) => void): this;
|
|
/**
|
|
* Emitted before the window is resized. Calling `event.preventDefault()` will
|
|
* prevent the window from being resized.
|
|
*
|
|
* Note that this is only emitted when the window is being resized manually.
|
|
* Resizing the window with `setBounds`/`setSize` will not emit this event.
|
|
*
|
|
* The possible values and behaviors of the `edge` option are platform dependent.
|
|
* Possible values are:
|
|
*
|
|
* * On Windows, possible values are `bottom`, `top`, `left`, `right`, `top-left`,
|
|
* `top-right`, `bottom-left`, `bottom-right`.
|
|
* * On macOS, possible values are `bottom` and `right`.
|
|
* * The value `bottom` is used to denote vertical resizing.
|
|
* * The value `right` is used to denote horizontal resizing.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'will-resize', listener: (event: Event,
|
|
/**
|
|
* Size the window is being resized to.
|
|
*/
|
|
newBounds: Rectangle,
|
|
details: WillResizeDetails) => void): this;
|
|
once(event: 'will-resize', listener: (event: Event,
|
|
/**
|
|
* Size the window is being resized to.
|
|
*/
|
|
newBounds: Rectangle,
|
|
details: WillResizeDetails) => void): this;
|
|
addListener(event: 'will-resize', listener: (event: Event,
|
|
/**
|
|
* Size the window is being resized to.
|
|
*/
|
|
newBounds: Rectangle,
|
|
details: WillResizeDetails) => void): this;
|
|
removeListener(event: 'will-resize', listener: (event: Event,
|
|
/**
|
|
* Size the window is being resized to.
|
|
*/
|
|
newBounds: Rectangle,
|
|
details: WillResizeDetails) => void): this;
|
|
/**
|
|
* BrowserWindow
|
|
*/
|
|
constructor(options?: BrowserWindowConstructorOptions);
|
|
/**
|
|
* The window that owns the given `browserView`. If the given view is not attached
|
|
* to any window, returns `null`.
|
|
*/
|
|
static fromBrowserView(browserView: BrowserView): (BrowserWindow) | (null);
|
|
/**
|
|
* The window with the given `id`.
|
|
*/
|
|
static fromId(id: number): (BrowserWindow) | (null);
|
|
/**
|
|
* The window that owns the given `webContents` or `null` if the contents are not
|
|
* owned by a window.
|
|
*/
|
|
static fromWebContents(webContents: WebContents): (BrowserWindow) | (null);
|
|
/**
|
|
* An array of all opened browser windows.
|
|
*/
|
|
static getAllWindows(): BrowserWindow[];
|
|
/**
|
|
* The window that is focused in this application, otherwise returns `null`.
|
|
*/
|
|
static getFocusedWindow(): (BrowserWindow) | (null);
|
|
/**
|
|
* Replacement API for setBrowserView supporting work with multi browser views.
|
|
*
|
|
* @experimental
|
|
*/
|
|
addBrowserView(browserView: BrowserView): void;
|
|
/**
|
|
* Adds a window as a tab on this window, after the tab for the window instance.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
addTabbedWindow(browserWindow: BrowserWindow): void;
|
|
/**
|
|
* Removes focus from the window.
|
|
*/
|
|
blur(): void;
|
|
blurWebView(): void;
|
|
/**
|
|
* Resolves with a NativeImage
|
|
*
|
|
* Captures a snapshot of the page within `rect`. Omitting `rect` will capture the
|
|
* whole visible page. If the page is not visible, `rect` may be empty. The page is
|
|
* considered visible when its browser window is hidden and the capturer count is
|
|
* non-zero. If you would like the page to stay hidden, you should ensure that
|
|
* `stayHidden` is set to true.
|
|
*/
|
|
capturePage(rect?: Rectangle, opts?: Opts): Promise<Electron.NativeImage>;
|
|
/**
|
|
* Moves window to the center of the screen.
|
|
*/
|
|
center(): void;
|
|
/**
|
|
* Try to close the window. This has the same effect as a user manually clicking
|
|
* the close button of the window. The web page may cancel the close though. See
|
|
* the close event.
|
|
*/
|
|
close(): void;
|
|
/**
|
|
* Closes the currently open Quick Look panel.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
closeFilePreview(): void;
|
|
/**
|
|
* Force closing the window, the `unload` and `beforeunload` event won't be emitted
|
|
* for the web page, and `close` event will also not be emitted for this window,
|
|
* but it guarantees the `closed` event will be emitted.
|
|
*/
|
|
destroy(): void;
|
|
/**
|
|
* Starts or stops flashing the window to attract user's attention.
|
|
*/
|
|
flashFrame(flag: boolean): void;
|
|
/**
|
|
* Focuses on the window.
|
|
*/
|
|
focus(): void;
|
|
focusOnWebView(): void;
|
|
/**
|
|
* Gets the background color of the window in Hex (`#RRGGBB`) format.
|
|
*
|
|
* See Setting `backgroundColor`.
|
|
*
|
|
* **Note:** The alpha value is _not_ returned alongside the red, green, and blue
|
|
* values.
|
|
*/
|
|
getBackgroundColor(): string;
|
|
/**
|
|
* The `bounds` of the window as `Object`.
|
|
*
|
|
* **Note:** On macOS, the y-coordinate value returned will be at minimum the Tray
|
|
* height. For example, calling `win.setBounds({ x: 25, y: 20, width: 800, height:
|
|
* 600 })` with a tray height of 38 means that `win.getBounds()` will return `{ x:
|
|
* 25, y: 38, width: 800, height: 600 }`.
|
|
*/
|
|
getBounds(): Rectangle;
|
|
/**
|
|
* The `BrowserView` attached to `win`. Returns `null` if one is not attached.
|
|
* Throws an error if multiple `BrowserView`s are attached.
|
|
*
|
|
* @experimental
|
|
*/
|
|
getBrowserView(): (BrowserView) | (null);
|
|
/**
|
|
* a sorted by z-index array of all BrowserViews that have been attached with
|
|
* `addBrowserView` or `setBrowserView`. The top-most BrowserView is the last
|
|
* element of the array.
|
|
*
|
|
* **Note:** The BrowserView API is currently experimental and may change or be
|
|
* removed in future Electron releases.
|
|
*
|
|
* @experimental
|
|
*/
|
|
getBrowserViews(): BrowserView[];
|
|
/**
|
|
* All child windows.
|
|
*/
|
|
getChildWindows(): BrowserWindow[];
|
|
/**
|
|
* The `bounds` of the window's client area as `Object`.
|
|
*/
|
|
getContentBounds(): Rectangle;
|
|
/**
|
|
* Contains the window's client area's width and height.
|
|
*/
|
|
getContentSize(): number[];
|
|
/**
|
|
* Contains the window's maximum width and height.
|
|
*/
|
|
getMaximumSize(): number[];
|
|
/**
|
|
* Window id in the format of DesktopCapturerSource's id. For example
|
|
* "window:1324:0".
|
|
*
|
|
* More precisely the format is `window:id:other_id` where `id` is `HWND` on
|
|
* Windows, `CGWindowID` (`uint64_t`) on macOS and `Window` (`unsigned long`) on
|
|
* Linux. `other_id` is used to identify web contents (tabs) so within the same top
|
|
* level window.
|
|
*/
|
|
getMediaSourceId(): string;
|
|
/**
|
|
* Contains the window's minimum width and height.
|
|
*/
|
|
getMinimumSize(): number[];
|
|
/**
|
|
* The platform-specific handle of the window.
|
|
*
|
|
* The native type of the handle is `HWND` on Windows, `NSView*` on macOS, and
|
|
* `Window` (`unsigned long`) on Linux.
|
|
*/
|
|
getNativeWindowHandle(): Buffer;
|
|
/**
|
|
* Contains the window bounds of the normal state
|
|
*
|
|
* **Note:** whatever the current state of the window : maximized, minimized or in
|
|
* fullscreen, this function always returns the position and size of the window in
|
|
* normal state. In normal state, getBounds and getNormalBounds returns the same
|
|
* `Rectangle`.
|
|
*/
|
|
getNormalBounds(): Rectangle;
|
|
/**
|
|
* between 0.0 (fully transparent) and 1.0 (fully opaque). On Linux, always returns
|
|
* 1.
|
|
*/
|
|
getOpacity(): number;
|
|
/**
|
|
* The parent window or `null` if there is no parent.
|
|
*/
|
|
getParentWindow(): (BrowserWindow) | (null);
|
|
/**
|
|
* Contains the window's current position.
|
|
*/
|
|
getPosition(): number[];
|
|
/**
|
|
* The pathname of the file the window represents.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getRepresentedFilename(): string;
|
|
/**
|
|
* Contains the window's width and height.
|
|
*/
|
|
getSize(): number[];
|
|
/**
|
|
* The title of the native window.
|
|
*
|
|
* **Note:** The title of the web page can be different from the title of the
|
|
* native window.
|
|
*/
|
|
getTitle(): string;
|
|
/**
|
|
* The custom position for the traffic light buttons in frameless window, `{ x: 0,
|
|
* y: 0 }` will be returned when there is no custom position.
|
|
*
|
|
* > **Note** This function is deprecated. Use getWindowButtonPosition instead.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
getTrafficLightPosition(): Point;
|
|
/**
|
|
* The custom position for the traffic light buttons in frameless window, `null`
|
|
* will be returned when there is no custom position.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getWindowButtonPosition(): (Point) | (null);
|
|
/**
|
|
* Whether the window has a shadow.
|
|
*/
|
|
hasShadow(): boolean;
|
|
/**
|
|
* Hides the window.
|
|
*/
|
|
hide(): void;
|
|
/**
|
|
* Hooks a windows message. The `callback` is called when the message is received
|
|
* in the WndProc.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
hookWindowMessage(message: number, callback: (wParam: Buffer, lParam: Buffer) => void): void;
|
|
/**
|
|
* Invalidates the window shadow so that it is recomputed based on the current
|
|
* window shape.
|
|
*
|
|
* `BrowserWindows` that are transparent can sometimes leave behind visual
|
|
* artifacts on macOS. This method can be used to clear these artifacts when, for
|
|
* example, performing an animation.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
invalidateShadow(): void;
|
|
/**
|
|
* Whether the window is always on top of other windows.
|
|
*/
|
|
isAlwaysOnTop(): boolean;
|
|
/**
|
|
* Whether the window can be manually closed by user.
|
|
*
|
|
* On Linux always returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
isClosable(): boolean;
|
|
/**
|
|
* Whether the window is destroyed.
|
|
*/
|
|
isDestroyed(): boolean;
|
|
/**
|
|
* Whether the window's document has been edited.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isDocumentEdited(): boolean;
|
|
/**
|
|
* whether the window is enabled.
|
|
*/
|
|
isEnabled(): boolean;
|
|
/**
|
|
* Whether the window can be focused.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
isFocusable(): boolean;
|
|
/**
|
|
* Whether the window is focused.
|
|
*/
|
|
isFocused(): boolean;
|
|
/**
|
|
* Whether the window is in fullscreen mode.
|
|
*/
|
|
isFullScreen(): boolean;
|
|
/**
|
|
* Whether the maximize/zoom window button toggles fullscreen mode or maximizes the
|
|
* window.
|
|
*/
|
|
isFullScreenable(): boolean;
|
|
/**
|
|
* Whether the window will be hidden when the user toggles into mission control.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isHiddenInMissionControl(): boolean;
|
|
/**
|
|
* Whether the window is in kiosk mode.
|
|
*/
|
|
isKiosk(): boolean;
|
|
/**
|
|
* Whether the window can be manually maximized by user.
|
|
*
|
|
* On Linux always returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
isMaximizable(): boolean;
|
|
/**
|
|
* Whether the window is maximized.
|
|
*/
|
|
isMaximized(): boolean;
|
|
/**
|
|
* Whether menu bar automatically hides itself.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
isMenuBarAutoHide(): boolean;
|
|
/**
|
|
* Whether the menu bar is visible.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
isMenuBarVisible(): boolean;
|
|
/**
|
|
* Whether the window can be manually minimized by the user.
|
|
*
|
|
* On Linux always returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
isMinimizable(): boolean;
|
|
/**
|
|
* Whether the window is minimized.
|
|
*/
|
|
isMinimized(): boolean;
|
|
/**
|
|
* Whether current window is a modal window.
|
|
*/
|
|
isModal(): boolean;
|
|
/**
|
|
* Whether the window can be moved by user.
|
|
*
|
|
* On Linux always returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
isMovable(): boolean;
|
|
/**
|
|
* Whether the window is in normal state (not maximized, not minimized, not in
|
|
* fullscreen mode).
|
|
*/
|
|
isNormal(): boolean;
|
|
/**
|
|
* Whether the window can be manually resized by the user.
|
|
*/
|
|
isResizable(): boolean;
|
|
/**
|
|
* Whether the window is in simple (pre-Lion) fullscreen mode.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isSimpleFullScreen(): boolean;
|
|
/**
|
|
* Whether the window is in Windows 10 tablet mode.
|
|
*
|
|
* Since Windows 10 users can use their PC as tablet, under this mode apps can
|
|
* choose to optimize their UI for tablets, such as enlarging the titlebar and
|
|
* hiding titlebar buttons.
|
|
*
|
|
* This API returns whether the window is in tablet mode, and the `resize` event
|
|
* can be be used to listen to changes to tablet mode.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
isTabletMode(): boolean;
|
|
/**
|
|
* Whether the window is visible to the user in the foreground of the app.
|
|
*/
|
|
isVisible(): boolean;
|
|
/**
|
|
* Whether the window is visible on all workspaces.
|
|
*
|
|
* **Note:** This API always returns false on Windows.
|
|
*
|
|
* @platform darwin,linux
|
|
*/
|
|
isVisibleOnAllWorkspaces(): boolean;
|
|
/**
|
|
* `true` or `false` depending on whether the message is hooked.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
isWindowMessageHooked(message: number): boolean;
|
|
/**
|
|
* the promise will resolve when the page has finished loading (see
|
|
* `did-finish-load`), and rejects if the page fails to load (see `did-fail-load`).
|
|
*
|
|
* Same as `webContents.loadFile`, `filePath` should be a path to an HTML file
|
|
* relative to the root of your application. See the `webContents` docs for more
|
|
* information.
|
|
*/
|
|
loadFile(filePath: string, options?: LoadFileOptions): Promise<void>;
|
|
/**
|
|
* the promise will resolve when the page has finished loading (see
|
|
* `did-finish-load`), and rejects if the page fails to load (see `did-fail-load`).
|
|
*
|
|
* Same as `webContents.loadURL(url[, options])`.
|
|
*
|
|
* The `url` can be a remote address (e.g. `http://`) or a path to a local HTML
|
|
* file using the `file://` protocol.
|
|
*
|
|
* To ensure that file URLs are properly formatted, it is recommended to use Node's
|
|
* `url.format` method:
|
|
*
|
|
* You can load a URL using a `POST` request with URL-encoded data by doing the
|
|
* following:
|
|
*/
|
|
loadURL(url: string, options?: LoadURLOptions): Promise<void>;
|
|
/**
|
|
* Maximizes the window. This will also show (but not focus) the window if it isn't
|
|
* being displayed already.
|
|
*/
|
|
maximize(): void;
|
|
/**
|
|
* Merges all windows into one window with multiple tabs when native tabs are
|
|
* enabled and there is more than one open window.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
mergeAllWindows(): void;
|
|
/**
|
|
* Minimizes the window. On some platforms the minimized window will be shown in
|
|
* the Dock.
|
|
*/
|
|
minimize(): void;
|
|
/**
|
|
* Moves window above the source window in the sense of z-order. If the
|
|
* `mediaSourceId` is not of type window or if the window does not exist then this
|
|
* method throws an error.
|
|
*/
|
|
moveAbove(mediaSourceId: string): void;
|
|
/**
|
|
* Moves the current tab into a new window if native tabs are enabled and there is
|
|
* more than one tab in the current window.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
moveTabToNewWindow(): void;
|
|
/**
|
|
* Moves window to top(z-order) regardless of focus
|
|
*/
|
|
moveTop(): void;
|
|
/**
|
|
* Uses Quick Look to preview a file at a given path.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
previewFile(path: string, displayName?: string): void;
|
|
/**
|
|
* Same as `webContents.reload`.
|
|
*/
|
|
reload(): void;
|
|
/**
|
|
* @experimental
|
|
*/
|
|
removeBrowserView(browserView: BrowserView): void;
|
|
/**
|
|
* Remove the window's menu bar.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
removeMenu(): void;
|
|
/**
|
|
* Restores the window from minimized state to its previous state.
|
|
*/
|
|
restore(): void;
|
|
/**
|
|
* Selects the next tab when native tabs are enabled and there are other tabs in
|
|
* the window.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
selectNextTab(): void;
|
|
/**
|
|
* Selects the previous tab when native tabs are enabled and there are other tabs
|
|
* in the window.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
selectPreviousTab(): void;
|
|
/**
|
|
* Sets whether the window should show always on top of other windows. After
|
|
* setting this, the window is still a normal window, not a toolbox window which
|
|
* can not be focused on.
|
|
*/
|
|
setAlwaysOnTop(flag: boolean, level?: 'normal' | 'floating' | 'torn-off-menu' | 'modal-panel' | 'main-menu' | 'status' | 'pop-up-menu' | 'screen-saver', relativeLevel?: number): void;
|
|
/**
|
|
* Sets the properties for the window's taskbar button.
|
|
*
|
|
* **Note:** `relaunchCommand` and `relaunchDisplayName` must always be set
|
|
* together. If one of those properties is not set, then neither will be used.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setAppDetails(options: AppDetailsOptions): void;
|
|
/**
|
|
* This will make a window maintain an aspect ratio. The extra size allows a
|
|
* developer to have space, specified in pixels, not included within the aspect
|
|
* ratio calculations. This API already takes into account the difference between a
|
|
* window's size and its content size.
|
|
*
|
|
* Consider a normal window with an HD video player and associated controls.
|
|
* Perhaps there are 15 pixels of controls on the left edge, 25 pixels of controls
|
|
* on the right edge and 50 pixels of controls below the player. In order to
|
|
* maintain a 16:9 aspect ratio (standard aspect ratio for HD @1920x1080) within
|
|
* the player itself we would call this function with arguments of 16/9 and {
|
|
* width: 40, height: 50 }. The second argument doesn't care where the extra width
|
|
* and height are within the content view--only that they exist. Sum any extra
|
|
* width and height areas you have within the overall content view.
|
|
*
|
|
* The aspect ratio is not respected when window is resized programmatically with
|
|
* APIs like `win.setSize`.
|
|
*
|
|
* To reset an aspect ratio, pass 0 as the `aspectRatio` value:
|
|
* `win.setAspectRatio(0)`.
|
|
*/
|
|
setAspectRatio(aspectRatio: number, extraSize?: Size): void;
|
|
/**
|
|
* Controls whether to hide cursor when typing.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setAutoHideCursor(autoHide: boolean): void;
|
|
/**
|
|
* Sets whether the window menu bar should hide itself automatically. Once set the
|
|
* menu bar will only show when users press the single `Alt` key.
|
|
*
|
|
* If the menu bar is already visible, calling `setAutoHideMenuBar(true)` won't
|
|
* hide it immediately.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
setAutoHideMenuBar(hide: boolean): void;
|
|
/**
|
|
* Examples of valid `backgroundColor` values:
|
|
*
|
|
* * Hex
|
|
* * #fff (shorthand RGB)
|
|
* * #ffff (shorthand ARGB)
|
|
* * #ffffff (RGB)
|
|
* * #ffffffff (ARGB)
|
|
* * RGB
|
|
* * rgb(([\d]+),\s*([\d]+),\s*([\d]+))
|
|
* * e.g. rgb(255, 255, 255)
|
|
* * RGBA
|
|
* * rgba(([\d]+),\s*([\d]+),\s*([\d]+),\s*([\d.]+))
|
|
* * e.g. rgba(255, 255, 255, 1.0)
|
|
* * HSL
|
|
* * hsl((-?[\d.]+),\s*([\d.]+)%,\s*([\d.]+)%)
|
|
* * e.g. hsl(200, 20%, 50%)
|
|
* * HSLA
|
|
* * hsla((-?[\d.]+),\s*([\d.]+)%,\s*([\d.]+)%,\s*([\d.]+))
|
|
* * e.g. hsla(200, 20%, 50%, 0.5)
|
|
* * Color name
|
|
* * Options are listed in SkParseColor.cpp
|
|
* * Similar to CSS Color Module Level 3 keywords, but case-sensitive.
|
|
* * e.g. `blueviolet` or `red`
|
|
*
|
|
* Sets the background color of the window. See Setting `backgroundColor`.
|
|
*/
|
|
setBackgroundColor(backgroundColor: string): void;
|
|
/**
|
|
* This method sets the browser window's system-drawn background material,
|
|
* including behind the non-client area.
|
|
*
|
|
* See the Windows documentation for more details.
|
|
*
|
|
* **Note:** This method is only supported on Windows 11 22H2 and up.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setBackgroundMaterial(material: 'auto' | 'none' | 'mica' | 'acrylic' | 'tabbed'): void;
|
|
/**
|
|
* Resizes and moves the window to the supplied bounds. Any properties that are not
|
|
* supplied will default to their current values.
|
|
*
|
|
* **Note:** On macOS, the y-coordinate value cannot be smaller than the Tray
|
|
* height. The tray height has changed over time and depends on the operating
|
|
* system, but is between 20-40px. Passing a value lower than the tray height will
|
|
* result in a window that is flush to the tray.
|
|
*/
|
|
setBounds(bounds: Partial<Rectangle>, animate?: boolean): void;
|
|
/**
|
|
* @experimental
|
|
*/
|
|
setBrowserView(browserView: (BrowserView) | (null)): void;
|
|
/**
|
|
* Sets whether the window can be manually closed by user. On Linux does nothing.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setClosable(closable: boolean): void;
|
|
/**
|
|
* Resizes and moves the window's client area (e.g. the web page) to the supplied
|
|
* bounds.
|
|
*/
|
|
setContentBounds(bounds: Rectangle, animate?: boolean): void;
|
|
/**
|
|
* Prevents the window contents from being captured by other apps.
|
|
*
|
|
* On macOS it sets the NSWindow's sharingType to NSWindowSharingNone. On Windows
|
|
* it calls SetWindowDisplayAffinity with `WDA_EXCLUDEFROMCAPTURE`. For Windows 10
|
|
* version 2004 and up the window will be removed from capture entirely, older
|
|
* Windows versions behave as if `WDA_MONITOR` is applied capturing a black window.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setContentProtection(enable: boolean): void;
|
|
/**
|
|
* Resizes the window's client area (e.g. the web page) to `width` and `height`.
|
|
*/
|
|
setContentSize(width: number, height: number, animate?: boolean): void;
|
|
/**
|
|
* Specifies whether the window’s document has been edited, and the icon in title
|
|
* bar will become gray when set to `true`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setDocumentEdited(edited: boolean): void;
|
|
/**
|
|
* Disable or enable the window.
|
|
*/
|
|
setEnabled(enable: boolean): void;
|
|
/**
|
|
* Changes whether the window can be focused.
|
|
*
|
|
* On macOS it does not remove the focus from the window.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setFocusable(focusable: boolean): void;
|
|
/**
|
|
* Sets whether the window should be in fullscreen mode.
|
|
*
|
|
* **Note:** On macOS, fullscreen transitions take place asynchronously. If further
|
|
* actions depend on the fullscreen state, use the 'enter-full-screen' or
|
|
* 'leave-full-screen' events.
|
|
*/
|
|
setFullScreen(flag: boolean): void;
|
|
/**
|
|
* Sets whether the maximize/zoom window button toggles fullscreen mode or
|
|
* maximizes the window.
|
|
*/
|
|
setFullScreenable(fullscreenable: boolean): void;
|
|
/**
|
|
* Sets whether the window should have a shadow.
|
|
*/
|
|
setHasShadow(hasShadow: boolean): void;
|
|
/**
|
|
* Sets whether the window will be hidden when the user toggles into mission
|
|
* control.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setHiddenInMissionControl(hidden: boolean): void;
|
|
/**
|
|
* Changes window icon.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
setIcon(icon: (NativeImage) | (string)): void;
|
|
/**
|
|
* Makes the window ignore all mouse events.
|
|
*
|
|
* All mouse events happened in this window will be passed to the window below this
|
|
* window, but if this window has focus, it will still receive keyboard events.
|
|
*/
|
|
setIgnoreMouseEvents(ignore: boolean, options?: IgnoreMouseEventsOptions): void;
|
|
/**
|
|
* Enters or leaves kiosk mode.
|
|
*/
|
|
setKiosk(flag: boolean): void;
|
|
/**
|
|
* Sets whether the window can be manually maximized by user. On Linux does
|
|
* nothing.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setMaximizable(maximizable: boolean): void;
|
|
/**
|
|
* Sets the maximum size of window to `width` and `height`.
|
|
*/
|
|
setMaximumSize(width: number, height: number): void;
|
|
/**
|
|
* Sets the `menu` as the window's menu bar.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
setMenu(menu: (Menu) | (null)): void;
|
|
/**
|
|
* Sets whether the menu bar should be visible. If the menu bar is auto-hide, users
|
|
* can still bring up the menu bar by pressing the single `Alt` key.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
setMenuBarVisibility(visible: boolean): void;
|
|
/**
|
|
* Sets whether the window can be manually minimized by user. On Linux does
|
|
* nothing.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setMinimizable(minimizable: boolean): void;
|
|
/**
|
|
* Sets the minimum size of window to `width` and `height`.
|
|
*/
|
|
setMinimumSize(width: number, height: number): void;
|
|
/**
|
|
* Sets whether the window can be moved by user. On Linux does nothing.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setMovable(movable: boolean): void;
|
|
/**
|
|
* Sets the opacity of the window. On Linux, does nothing. Out of bound number
|
|
* values are clamped to the [0, 1] range.
|
|
*
|
|
* @platform win32,darwin
|
|
*/
|
|
setOpacity(opacity: number): void;
|
|
/**
|
|
* Sets a 16 x 16 pixel overlay onto the current taskbar icon, usually used to
|
|
* convey some sort of application status or to passively notify the user.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setOverlayIcon(overlay: (NativeImage) | (null), description: string): void;
|
|
/**
|
|
* Sets `parent` as current window's parent window, passing `null` will turn
|
|
* current window into a top-level window.
|
|
*/
|
|
setParentWindow(parent: (BrowserWindow) | (null)): void;
|
|
/**
|
|
* Moves window to `x` and `y`.
|
|
*/
|
|
setPosition(x: number, y: number, animate?: boolean): void;
|
|
/**
|
|
* Sets progress value in progress bar. Valid range is [0, 1.0].
|
|
*
|
|
* Remove progress bar when progress < 0; Change to indeterminate mode when
|
|
* progress > 1.
|
|
*
|
|
* On Linux platform, only supports Unity desktop environment, you need to specify
|
|
* the `*.desktop` file name to `desktopName` field in `package.json`. By default,
|
|
* it will assume `{app.name}.desktop`.
|
|
*
|
|
* On Windows, a mode can be passed. Accepted values are `none`, `normal`,
|
|
* `indeterminate`, `error`, and `paused`. If you call `setProgressBar` without a
|
|
* mode set (but with a value within the valid range), `normal` will be assumed.
|
|
*/
|
|
setProgressBar(progress: number, options?: ProgressBarOptions): void;
|
|
/**
|
|
* Sets the pathname of the file the window represents, and the icon of the file
|
|
* will show in window's title bar.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setRepresentedFilename(filename: string): void;
|
|
/**
|
|
* Sets whether the window can be manually resized by the user.
|
|
*/
|
|
setResizable(resizable: boolean): void;
|
|
/**
|
|
* Setting a window shape determines the area within the window where the system
|
|
* permits drawing and user interaction. Outside of the given region, no pixels
|
|
* will be drawn and no mouse events will be registered. Mouse events outside of
|
|
* the region will not be received by that window, but will fall through to
|
|
* whatever is behind the window.
|
|
*
|
|
* @experimental
|
|
* @platform win32,linux
|
|
*/
|
|
setShape(rects: Rectangle[]): void;
|
|
/**
|
|
* Changes the attachment point for sheets on macOS. By default, sheets are
|
|
* attached just below the window frame, but you may want to display them beneath a
|
|
* HTML-rendered toolbar. For example:
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setSheetOffset(offsetY: number, offsetX?: number): void;
|
|
/**
|
|
* Enters or leaves simple fullscreen mode.
|
|
*
|
|
* Simple fullscreen mode emulates the native fullscreen behavior found in versions
|
|
* of macOS prior to Lion (10.7).
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setSimpleFullScreen(flag: boolean): void;
|
|
/**
|
|
* Resizes the window to `width` and `height`. If `width` or `height` are below any
|
|
* set minimum size constraints the window will snap to its minimum size.
|
|
*/
|
|
setSize(width: number, height: number, animate?: boolean): void;
|
|
/**
|
|
* Makes the window not show in the taskbar.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
setSkipTaskbar(skip: boolean): void;
|
|
/**
|
|
* Whether the buttons were added successfully
|
|
*
|
|
* Add a thumbnail toolbar with a specified set of buttons to the thumbnail image
|
|
* of a window in a taskbar button layout. Returns a `boolean` object indicates
|
|
* whether the thumbnail has been added successfully.
|
|
*
|
|
* The number of buttons in thumbnail toolbar should be no greater than 7 due to
|
|
* the limited room. Once you setup the thumbnail toolbar, the toolbar cannot be
|
|
* removed due to the platform's limitation. But you can call the API with an empty
|
|
* array to clean the buttons.
|
|
*
|
|
* The `buttons` is an array of `Button` objects:
|
|
*
|
|
* * `Button` Object
|
|
* * `icon` NativeImage - The icon showing in thumbnail toolbar.
|
|
* * `click` Function
|
|
* * `tooltip` string (optional) - The text of the button's tooltip.
|
|
* * `flags` string[] (optional) - Control specific states and behaviors of the
|
|
* button. By default, it is `['enabled']`.
|
|
*
|
|
* The `flags` is an array that can include following `string`s:
|
|
*
|
|
* * `enabled` - The button is active and available to the user.
|
|
* * `disabled` - The button is disabled. It is present, but has a visual state
|
|
* indicating it will not respond to user action.
|
|
* * `dismissonclick` - When the button is clicked, the thumbnail window closes
|
|
* immediately.
|
|
* * `nobackground` - Do not draw a button border, use only the image.
|
|
* * `hidden` - The button is not shown to the user.
|
|
* * `noninteractive` - The button is enabled but not interactive; no pressed
|
|
* button state is drawn. This value is intended for instances where the button is
|
|
* used in a notification.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setThumbarButtons(buttons: ThumbarButton[]): boolean;
|
|
/**
|
|
* Sets the region of the window to show as the thumbnail image displayed when
|
|
* hovering over the window in the taskbar. You can reset the thumbnail to be the
|
|
* entire window by specifying an empty region: `{ x: 0, y: 0, width: 0, height: 0
|
|
* }`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setThumbnailClip(region: Rectangle): void;
|
|
/**
|
|
* Sets the toolTip that is displayed when hovering over the window thumbnail in
|
|
* the taskbar.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setThumbnailToolTip(toolTip: string): void;
|
|
/**
|
|
* Changes the title of native window to `title`.
|
|
*/
|
|
setTitle(title: string): void;
|
|
/**
|
|
* On a Window with Window Controls Overlay already enabled, this method updates
|
|
* the style of the title bar overlay.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
setTitleBarOverlay(options: TitleBarOverlayOptions): void;
|
|
/**
|
|
* Raises `browserView` above other `BrowserView`s attached to `win`. Throws an
|
|
* error if `browserView` is not attached to `win`.
|
|
*
|
|
* @experimental
|
|
*/
|
|
setTopBrowserView(browserView: BrowserView): void;
|
|
/**
|
|
* Sets the touchBar layout for the current window. Specifying `null` or
|
|
* `undefined` clears the touch bar. This method only has an effect if the machine
|
|
* has a touch bar.
|
|
*
|
|
* **Note:** The TouchBar API is currently experimental and may change or be
|
|
* removed in future Electron releases.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setTouchBar(touchBar: (TouchBar) | (null)): void;
|
|
/**
|
|
* Set a custom position for the traffic light buttons in frameless window. Passing
|
|
* `{ x: 0, y: 0 }` will reset the position to default.
|
|
*
|
|
* > **Note** This function is deprecated. Use setWindowButtonPosition instead.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
setTrafficLightPosition(position: Point): void;
|
|
/**
|
|
* Adds a vibrancy effect to the browser window. Passing `null` or an empty string
|
|
* will remove the vibrancy effect on the window.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setVibrancy(type: (('titlebar' | 'selection' | 'menu' | 'popover' | 'sidebar' | 'header' | 'sheet' | 'window' | 'hud' | 'fullscreen-ui' | 'tooltip' | 'content' | 'under-window' | 'under-page')) | (null)): void;
|
|
/**
|
|
* Sets whether the window should be visible on all workspaces.
|
|
*
|
|
* **Note:** This API does nothing on Windows.
|
|
*
|
|
* @platform darwin,linux
|
|
*/
|
|
setVisibleOnAllWorkspaces(visible: boolean, options?: VisibleOnAllWorkspacesOptions): void;
|
|
/**
|
|
* Set a custom position for the traffic light buttons in frameless window. Passing
|
|
* `null` will reset the position to default.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setWindowButtonPosition(position: (Point) | (null)): void;
|
|
/**
|
|
* Sets whether the window traffic light buttons should be visible.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setWindowButtonVisibility(visible: boolean): void;
|
|
/**
|
|
* Shows and gives focus to the window.
|
|
*/
|
|
show(): void;
|
|
/**
|
|
* Shows or hides the tab overview when native tabs are enabled.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
showAllTabs(): void;
|
|
/**
|
|
* Same as `webContents.showDefinitionForSelection()`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
showDefinitionForSelection(): void;
|
|
/**
|
|
* Shows the window but doesn't focus on it.
|
|
*/
|
|
showInactive(): void;
|
|
/**
|
|
* Toggles the visibility of the tab bar if native tabs are enabled and there is
|
|
* only one tab in the current window.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
toggleTabBar(): void;
|
|
/**
|
|
* Unhooks all of the window messages.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
unhookAllWindowMessages(): void;
|
|
/**
|
|
* Unhook the window message.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
unhookWindowMessage(message: number): void;
|
|
/**
|
|
* Unmaximizes the window.
|
|
*/
|
|
unmaximize(): void;
|
|
/**
|
|
* A `string` property that defines an alternative title provided only to
|
|
* accessibility tools such as screen readers. This string is not directly visible
|
|
* to users.
|
|
*/
|
|
accessibleTitle: string;
|
|
/**
|
|
* A `boolean` property that determines whether the window menu bar should hide
|
|
* itself automatically. Once set, the menu bar will only show when users press the
|
|
* single `Alt` key.
|
|
*
|
|
* If the menu bar is already visible, setting this property to `true` won't hide
|
|
* it immediately.
|
|
*/
|
|
autoHideMenuBar: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window can be manually closed
|
|
* by user.
|
|
*
|
|
* On Linux the setter is a no-op, although the getter returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
closable: boolean;
|
|
/**
|
|
* A `boolean` property that specifies whether the window’s document has been
|
|
* edited.
|
|
*
|
|
* The icon in title bar will become gray when set to `true`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
documentEdited: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window is excluded from the
|
|
* application’s Windows menu. `false` by default.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
excludedFromShownWindowsMenu: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window is focusable.
|
|
*
|
|
* @platform win32,darwin
|
|
*/
|
|
focusable: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window is in fullscreen mode.
|
|
*/
|
|
fullScreen: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the maximize/zoom window button
|
|
* toggles fullscreen mode or maximizes the window.
|
|
*/
|
|
fullScreenable: boolean;
|
|
/**
|
|
* A `Integer` property representing the unique ID of the window. Each ID is unique
|
|
* among all `BrowserWindow` instances of the entire Electron application.
|
|
*
|
|
*/
|
|
readonly id: number;
|
|
/**
|
|
* A `boolean` property that determines whether the window is in kiosk mode.
|
|
*/
|
|
kiosk: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window can be manually
|
|
* maximized by user.
|
|
*
|
|
* On Linux the setter is a no-op, although the getter returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
maximizable: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the menu bar should be visible.
|
|
*
|
|
* **Note:** If the menu bar is auto-hide, users can still bring up the menu bar by
|
|
* pressing the single `Alt` key.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
menuBarVisible: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window can be manually
|
|
* minimized by user.
|
|
*
|
|
* On Linux the setter is a no-op, although the getter returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
minimizable: boolean;
|
|
/**
|
|
* A `boolean` property that determines Whether the window can be moved by user.
|
|
*
|
|
* On Linux the setter is a no-op, although the getter returns `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
movable: boolean;
|
|
/**
|
|
* A `string` property that determines the pathname of the file the window
|
|
* represents, and the icon of the file will show in window's title bar.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
representedFilename: string;
|
|
/**
|
|
* A `boolean` property that determines whether the window can be manually resized
|
|
* by user.
|
|
*/
|
|
resizable: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window has a shadow.
|
|
*/
|
|
shadow: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether the window is in simple (pre-Lion)
|
|
* fullscreen mode.
|
|
*/
|
|
simpleFullScreen: boolean;
|
|
/**
|
|
* A `string` (optional) property that is equal to the `tabbingIdentifier` passed
|
|
* to the `BrowserWindow` constructor or `undefined` if none was set.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
readonly tabbingIdentifier?: string;
|
|
/**
|
|
* A `string` property that determines the title of the native window.
|
|
*
|
|
* **Note:** The title of the web page can be different from the title of the
|
|
* native window.
|
|
*/
|
|
title: string;
|
|
/**
|
|
* A `boolean` property that determines whether the window is visible on all
|
|
* workspaces.
|
|
*
|
|
* **Note:** Always returns false on Windows.
|
|
*
|
|
* @platform darwin,linux
|
|
*/
|
|
visibleOnAllWorkspaces: boolean;
|
|
/**
|
|
* A `WebContents` object this window owns. All web page related events and
|
|
* operations will be done via it.
|
|
*
|
|
* See the `webContents` documentation for its methods and events.
|
|
*
|
|
*/
|
|
readonly webContents: WebContents;
|
|
}
|
|
|
|
interface BrowserWindowConstructorOptions {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/browser-window-options
|
|
|
|
/**
|
|
* Whether clicking an inactive window will also click through to the web contents.
|
|
* Default is `false` on macOS. This option is not configurable on other platforms.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
acceptFirstMouse?: boolean;
|
|
/**
|
|
* Whether the window should always stay on top of other windows. Default is
|
|
* `false`.
|
|
*/
|
|
alwaysOnTop?: boolean;
|
|
/**
|
|
* Auto hide the menu bar unless the `Alt` key is pressed. Default is `false`.
|
|
*/
|
|
autoHideMenuBar?: boolean;
|
|
/**
|
|
* The window's background color in Hex, RGB, RGBA, HSL, HSLA or named CSS color
|
|
* format. Alpha in #AARRGGBB format is supported if `transparent` is set to
|
|
* `true`. Default is `#FFF` (white). See win.setBackgroundColor for more
|
|
* information.
|
|
*/
|
|
backgroundColor?: string;
|
|
/**
|
|
* Set the window's system-drawn background material, including behind the
|
|
* non-client area. Can be `auto`, `none`, `mica`, `acrylic` or `tabbed`. See
|
|
* win.setBackgroundMaterial for more information.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
backgroundMaterial?: ('auto' | 'none' | 'mica' | 'acrylic' | 'tabbed');
|
|
/**
|
|
* Show window in the center of the screen. Default is `false`.
|
|
*/
|
|
center?: boolean;
|
|
/**
|
|
* Whether window is closable. This is not implemented on Linux. Default is `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
closable?: boolean;
|
|
/**
|
|
* Forces using dark theme for the window, only works on some GTK+3 desktop
|
|
* environments. Default is `false`.
|
|
*/
|
|
darkTheme?: boolean;
|
|
/**
|
|
* Whether to hide cursor when typing. Default is `false`.
|
|
*/
|
|
disableAutoHideCursor?: boolean;
|
|
/**
|
|
* Enable the window to be resized larger than screen. Only relevant for macOS, as
|
|
* other OSes allow larger-than-screen windows by default. Default is `false`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
enableLargerThanScreen?: boolean;
|
|
/**
|
|
* Whether the window can be focused. Default is `true`. On Windows setting
|
|
* `focusable: false` also implies setting `skipTaskbar: true`. On Linux setting
|
|
* `focusable: false` makes the window stop interacting with wm, so the window will
|
|
* always stay on top in all workspaces.
|
|
*/
|
|
focusable?: boolean;
|
|
/**
|
|
* Specify `false` to create a frameless window. Default is `true`.
|
|
*/
|
|
frame?: boolean;
|
|
/**
|
|
* Whether the window should show in fullscreen. When explicitly set to `false` the
|
|
* fullscreen button will be hidden or disabled on macOS. Default is `false`.
|
|
*/
|
|
fullscreen?: boolean;
|
|
/**
|
|
* Whether the window can be put into fullscreen mode. On macOS, also whether the
|
|
* maximize/zoom button should toggle full screen mode or maximize window. Default
|
|
* is `true`.
|
|
*/
|
|
fullscreenable?: boolean;
|
|
/**
|
|
* Shows the title in the title bar in full screen mode on macOS for `hiddenInset`
|
|
* titleBarStyle. Default is `false`.
|
|
*
|
|
* @deprecated
|
|
* @platform darwin
|
|
*/
|
|
fullscreenWindowTitle?: boolean;
|
|
/**
|
|
* Whether window should have a shadow. Default is `true`.
|
|
*/
|
|
hasShadow?: boolean;
|
|
/**
|
|
* Window's height in pixels. Default is `600`.
|
|
*/
|
|
height?: number;
|
|
/**
|
|
* Whether window should be hidden when the user toggles into mission control.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
hiddenInMissionControl?: boolean;
|
|
/**
|
|
* The window icon. On Windows it is recommended to use `ICO` icons to get best
|
|
* visual effects, you can also leave it undefined so the executable's icon will be
|
|
* used.
|
|
*/
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* Whether the window is in kiosk mode. Default is `false`.
|
|
*/
|
|
kiosk?: boolean;
|
|
/**
|
|
* Window's maximum height. Default is no limit.
|
|
*/
|
|
maxHeight?: number;
|
|
/**
|
|
* Whether window is maximizable. This is not implemented on Linux. Default is
|
|
* `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
maximizable?: boolean;
|
|
/**
|
|
* Window's maximum width. Default is no limit.
|
|
*/
|
|
maxWidth?: number;
|
|
/**
|
|
* Window's minimum height. Default is `0`.
|
|
*/
|
|
minHeight?: number;
|
|
/**
|
|
* Whether window is minimizable. This is not implemented on Linux. Default is
|
|
* `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
minimizable?: boolean;
|
|
/**
|
|
* Window's minimum width. Default is `0`.
|
|
*/
|
|
minWidth?: number;
|
|
/**
|
|
* Whether this is a modal window. This only works when the window is a child
|
|
* window. Default is `false`.
|
|
*/
|
|
modal?: boolean;
|
|
/**
|
|
* Whether window is movable. This is not implemented on Linux. Default is `true`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
movable?: boolean;
|
|
/**
|
|
* Set the initial opacity of the window, between 0.0 (fully transparent) and 1.0
|
|
* (fully opaque). This is only implemented on Windows and macOS.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
opacity?: number;
|
|
/**
|
|
* Whether the renderer should be active when `show` is `false` and it has just
|
|
* been created. In order for `document.visibilityState` to work correctly on
|
|
* first load with `show: false` you should set this to `false`. Setting this to
|
|
* `false` will cause the `ready-to-show` event to not fire. Default is `true`.
|
|
*/
|
|
paintWhenInitiallyHidden?: boolean;
|
|
/**
|
|
* Specify parent window. Default is `null`.
|
|
*/
|
|
parent?: BrowserWindow;
|
|
/**
|
|
* Whether window is resizable. Default is `true`.
|
|
*/
|
|
resizable?: boolean;
|
|
/**
|
|
* Whether frameless window should have rounded corners on macOS. Default is
|
|
* `true`. Setting this property to `false` will prevent the window from being
|
|
* fullscreenable.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
roundedCorners?: boolean;
|
|
/**
|
|
* Whether window should be shown when created. Default is `true`.
|
|
*/
|
|
show?: boolean;
|
|
/**
|
|
* Use pre-Lion fullscreen on macOS. Default is `false`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
simpleFullscreen?: boolean;
|
|
/**
|
|
* Whether to show the window in taskbar. Default is `false`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
skipTaskbar?: boolean;
|
|
/**
|
|
* Tab group name, allows opening the window as a native tab. Windows with the same
|
|
* tabbing identifier will be grouped together. This also adds a native new tab
|
|
* button to your window's tab bar and allows your `app` and window to receive the
|
|
* `new-window-for-tab` event.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
tabbingIdentifier?: string;
|
|
/**
|
|
* Use `WS_THICKFRAME` style for frameless windows on Windows, which adds standard
|
|
* window frame. Setting it to `false` will remove window shadow and window
|
|
* animations. Default is `true`.
|
|
*/
|
|
thickFrame?: boolean;
|
|
/**
|
|
* Default window title. Default is `"Electron"`. If the HTML tag `<title>` is
|
|
* defined in the HTML file loaded by `loadURL()`, this property will be ignored.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* When using a frameless window in conjunction with
|
|
* `win.setWindowButtonVisibility(true)` on macOS or using a `titleBarStyle` so
|
|
* that the standard window controls ("traffic lights" on macOS) are visible, this
|
|
* property enables the Window Controls Overlay JavaScript APIs and CSS Environment
|
|
* Variables. Specifying `true` will result in an overlay with default system
|
|
* colors. Default is `false`.
|
|
*/
|
|
titleBarOverlay?: (TitleBarOverlay) | (boolean);
|
|
/**
|
|
* The style of window title bar. Default is `default`. Possible values are:
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
titleBarStyle?: ('default' | 'hidden' | 'hiddenInset' | 'customButtonsOnHover');
|
|
/**
|
|
* Set a custom position for the traffic light buttons in frameless windows.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
trafficLightPosition?: Point;
|
|
/**
|
|
* Makes the window transparent. Default is `false`. On Windows, does not work
|
|
* unless the window is frameless.
|
|
*/
|
|
transparent?: boolean;
|
|
/**
|
|
* The type of window, default is normal window. See more about this below.
|
|
*/
|
|
type?: string;
|
|
/**
|
|
* The `width` and `height` would be used as web page's size, which means the
|
|
* actual window's size will include window frame's size and be slightly larger.
|
|
* Default is `false`.
|
|
*/
|
|
useContentSize?: boolean;
|
|
/**
|
|
* Add a type of vibrancy effect to the window, only on macOS. Can be
|
|
* `appearance-based`, `titlebar`, `selection`, `menu`, `popover`, `sidebar`,
|
|
* `header`, `sheet`, `window`, `hud`, `fullscreen-ui`, `tooltip`, `content`,
|
|
* `under-window`, or `under-page`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
vibrancy?: ('appearance-based' | 'titlebar' | 'selection' | 'menu' | 'popover' | 'sidebar' | 'header' | 'sheet' | 'window' | 'hud' | 'fullscreen-ui' | 'tooltip' | 'content' | 'under-window' | 'under-page');
|
|
/**
|
|
* Specify how the material appearance should reflect window activity state on
|
|
* macOS. Must be used with the `vibrancy` property. Possible values are:
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
visualEffectState?: ('followWindow' | 'active' | 'inactive');
|
|
/**
|
|
* Settings of web page's features.
|
|
*/
|
|
webPreferences?: WebPreferences;
|
|
/**
|
|
* Window's width in pixels. Default is `800`.
|
|
*/
|
|
width?: number;
|
|
/**
|
|
* (**required** if y is used) Window's left offset from screen. Default is to
|
|
* center the window.
|
|
*/
|
|
x?: number;
|
|
/**
|
|
* (**required** if x is used) Window's top offset from screen. Default is to
|
|
* center the window.
|
|
*/
|
|
y?: number;
|
|
/**
|
|
* Controls the behavior on macOS when option-clicking the green stoplight button
|
|
* on the toolbar or by clicking the Window > Zoom menu item. If `true`, the window
|
|
* will grow to the preferred width of the web page when zoomed, `false` will cause
|
|
* it to zoom to the width of the screen. This will also affect the behavior when
|
|
* calling `maximize()` directly. Default is `false`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
zoomToPageWidth?: boolean;
|
|
}
|
|
|
|
interface Certificate {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/certificate
|
|
|
|
/**
|
|
* PEM encoded data
|
|
*/
|
|
data: string;
|
|
/**
|
|
* Fingerprint of the certificate
|
|
*/
|
|
fingerprint: string;
|
|
/**
|
|
* Issuer principal
|
|
*/
|
|
issuer: CertificatePrincipal;
|
|
/**
|
|
* Issuer certificate (if not self-signed)
|
|
*/
|
|
issuerCert: Certificate;
|
|
/**
|
|
* Issuer's Common Name
|
|
*/
|
|
issuerName: string;
|
|
/**
|
|
* Hex value represented string
|
|
*/
|
|
serialNumber: string;
|
|
/**
|
|
* Subject principal
|
|
*/
|
|
subject: CertificatePrincipal;
|
|
/**
|
|
* Subject's Common Name
|
|
*/
|
|
subjectName: string;
|
|
/**
|
|
* End date of the certificate being valid in seconds
|
|
*/
|
|
validExpiry: number;
|
|
/**
|
|
* Start date of the certificate being valid in seconds
|
|
*/
|
|
validStart: number;
|
|
}
|
|
|
|
interface CertificatePrincipal {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/certificate-principal
|
|
|
|
/**
|
|
* Common Name.
|
|
*/
|
|
commonName: string;
|
|
/**
|
|
* Country or region.
|
|
*/
|
|
country: string;
|
|
/**
|
|
* Locality.
|
|
*/
|
|
locality: string;
|
|
/**
|
|
* Organization names.
|
|
*/
|
|
organizations: string[];
|
|
/**
|
|
* Organization Unit names.
|
|
*/
|
|
organizationUnits: string[];
|
|
/**
|
|
* State or province.
|
|
*/
|
|
state: string;
|
|
}
|
|
|
|
class ClientRequest extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/client-request
|
|
|
|
/**
|
|
* Emitted when the `request` is aborted. The `abort` event will not be fired if
|
|
* the `request` is already closed.
|
|
*/
|
|
on(event: 'abort', listener: Function): this;
|
|
once(event: 'abort', listener: Function): this;
|
|
addListener(event: 'abort', listener: Function): this;
|
|
removeListener(event: 'abort', listener: Function): this;
|
|
/**
|
|
* Emitted as the last event in the HTTP request-response transaction. The `close`
|
|
* event indicates that no more events will be emitted on either the `request` or
|
|
* `response` objects.
|
|
*/
|
|
on(event: 'close', listener: Function): this;
|
|
once(event: 'close', listener: Function): this;
|
|
addListener(event: 'close', listener: Function): this;
|
|
removeListener(event: 'close', listener: Function): this;
|
|
/**
|
|
* Emitted when the `net` module fails to issue a network request. Typically when
|
|
* the `request` object emits an `error` event, a `close` event will subsequently
|
|
* follow and no response object will be provided.
|
|
*/
|
|
on(event: 'error', listener: (
|
|
/**
|
|
* an error object providing some information about the failure.
|
|
*/
|
|
error: Error) => void): this;
|
|
once(event: 'error', listener: (
|
|
/**
|
|
* an error object providing some information about the failure.
|
|
*/
|
|
error: Error) => void): this;
|
|
addListener(event: 'error', listener: (
|
|
/**
|
|
* an error object providing some information about the failure.
|
|
*/
|
|
error: Error) => void): this;
|
|
removeListener(event: 'error', listener: (
|
|
/**
|
|
* an error object providing some information about the failure.
|
|
*/
|
|
error: Error) => void): this;
|
|
/**
|
|
* Emitted just after the last chunk of the `request`'s data has been written into
|
|
* the `request` object.
|
|
*/
|
|
on(event: 'finish', listener: Function): this;
|
|
once(event: 'finish', listener: Function): this;
|
|
addListener(event: 'finish', listener: Function): this;
|
|
removeListener(event: 'finish', listener: Function): this;
|
|
/**
|
|
* Emitted when an authenticating proxy is asking for user credentials.
|
|
*
|
|
* The `callback` function is expected to be called back with user credentials:
|
|
*
|
|
* * `username` string
|
|
* * `password` string
|
|
*
|
|
* Providing empty credentials will cancel the request and report an authentication
|
|
* error on the response object:
|
|
*/
|
|
on(event: 'login', listener: (authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
once(event: 'login', listener: (authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
addListener(event: 'login', listener: (authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
removeListener(event: 'login', listener: (authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
/**
|
|
* Emitted when the server returns a redirect response (e.g. 301 Moved
|
|
* Permanently). Calling `request.followRedirect` will continue with the
|
|
* redirection. If this event is handled, `request.followRedirect` must be called
|
|
* **synchronously**, otherwise the request will be cancelled.
|
|
*/
|
|
on(event: 'redirect', listener: (statusCode: number,
|
|
method: string,
|
|
redirectUrl: string,
|
|
responseHeaders: Record<string, string[]>) => void): this;
|
|
once(event: 'redirect', listener: (statusCode: number,
|
|
method: string,
|
|
redirectUrl: string,
|
|
responseHeaders: Record<string, string[]>) => void): this;
|
|
addListener(event: 'redirect', listener: (statusCode: number,
|
|
method: string,
|
|
redirectUrl: string,
|
|
responseHeaders: Record<string, string[]>) => void): this;
|
|
removeListener(event: 'redirect', listener: (statusCode: number,
|
|
method: string,
|
|
redirectUrl: string,
|
|
responseHeaders: Record<string, string[]>) => void): this;
|
|
on(event: 'response', listener: (
|
|
/**
|
|
* An object representing the HTTP response message.
|
|
*/
|
|
response: IncomingMessage) => void): this;
|
|
once(event: 'response', listener: (
|
|
/**
|
|
* An object representing the HTTP response message.
|
|
*/
|
|
response: IncomingMessage) => void): this;
|
|
addListener(event: 'response', listener: (
|
|
/**
|
|
* An object representing the HTTP response message.
|
|
*/
|
|
response: IncomingMessage) => void): this;
|
|
removeListener(event: 'response', listener: (
|
|
/**
|
|
* An object representing the HTTP response message.
|
|
*/
|
|
response: IncomingMessage) => void): this;
|
|
/**
|
|
* ClientRequest
|
|
*/
|
|
constructor(options: (ClientRequestConstructorOptions) | (string));
|
|
/**
|
|
* Cancels an ongoing HTTP transaction. If the request has already emitted the
|
|
* `close` event, the abort operation will have no effect. Otherwise an ongoing
|
|
* event will emit `abort` and `close` events. Additionally, if there is an ongoing
|
|
* response object,it will emit the `aborted` event.
|
|
*/
|
|
abort(): void;
|
|
/**
|
|
* Sends the last chunk of the request data. Subsequent write or end operations
|
|
* will not be allowed. The `finish` event is emitted just after the end operation.
|
|
*/
|
|
end(chunk?: (string) | (Buffer), encoding?: string, callback?: () => void): this;
|
|
/**
|
|
* Continues any pending redirection. Can only be called during a `'redirect'`
|
|
* event.
|
|
*/
|
|
followRedirect(): void;
|
|
/**
|
|
* The value of a previously set extra header name.
|
|
*/
|
|
getHeader(name: string): string;
|
|
/**
|
|
* * `active` boolean - Whether the request is currently active. If this is false
|
|
* no other properties will be set
|
|
* * `started` boolean - Whether the upload has started. If this is false both
|
|
* `current` and `total` will be set to 0.
|
|
* * `current` Integer - The number of bytes that have been uploaded so far
|
|
* * `total` Integer - The number of bytes that will be uploaded this request
|
|
*
|
|
* You can use this method in conjunction with `POST` requests to get the progress
|
|
* of a file upload or other data transfer.
|
|
*/
|
|
getUploadProgress(): UploadProgress;
|
|
/**
|
|
* Removes a previously set extra header name. This method can be called only
|
|
* before first write. Trying to call it after the first write will throw an error.
|
|
*/
|
|
removeHeader(name: string): void;
|
|
/**
|
|
* Adds an extra HTTP header. The header name will be issued as-is without
|
|
* lowercasing. It can be called only before first write. Calling this method after
|
|
* the first write will throw an error. If the passed value is not a `string`, its
|
|
* `toString()` method will be called to obtain the final value.
|
|
*
|
|
* Certain headers are restricted from being set by apps. These headers are listed
|
|
* below. More information on restricted headers can be found in Chromium's header
|
|
* utils.
|
|
*
|
|
* * `Content-Length`
|
|
* * `Host`
|
|
* * `Trailer` or `Te`
|
|
* * `Upgrade`
|
|
* * `Cookie2`
|
|
* * `Keep-Alive`
|
|
* * `Transfer-Encoding`
|
|
*
|
|
* Additionally, setting the `Connection` header to the value `upgrade` is also
|
|
* disallowed.
|
|
*/
|
|
setHeader(name: string, value: string): void;
|
|
/**
|
|
* `callback` is essentially a dummy function introduced in the purpose of keeping
|
|
* similarity with the Node.js API. It is called asynchronously in the next tick
|
|
* after `chunk` content have been delivered to the Chromium networking layer.
|
|
* Contrary to the Node.js implementation, it is not guaranteed that `chunk`
|
|
* content have been flushed on the wire before `callback` is called.
|
|
*
|
|
* Adds a chunk of data to the request body. The first write operation may cause
|
|
* the request headers to be issued on the wire. After the first write operation,
|
|
* it is not allowed to add or remove a custom header.
|
|
*/
|
|
write(chunk: (string) | (Buffer), encoding?: string, callback?: () => void): void;
|
|
/**
|
|
* A `boolean` specifying whether the request will use HTTP chunked transfer
|
|
* encoding or not. Defaults to false. The property is readable and writable,
|
|
* however it can be set only before the first write operation as the HTTP headers
|
|
* are not yet put on the wire. Trying to set the `chunkedEncoding` property after
|
|
* the first write will throw an error.
|
|
*
|
|
* Using chunked encoding is strongly recommended if you need to send a large
|
|
* request body as data will be streamed in small chunks instead of being
|
|
* internally buffered inside Electron process memory.
|
|
*/
|
|
chunkedEncoding: boolean;
|
|
}
|
|
|
|
interface Clipboard {
|
|
|
|
// Docs: https://electronjs.org/docs/api/clipboard
|
|
|
|
/**
|
|
* An array of supported formats for the clipboard `type`.
|
|
*/
|
|
availableFormats(type?: 'selection' | 'clipboard'): string[];
|
|
/**
|
|
* Clears the clipboard content.
|
|
*/
|
|
clear(type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Whether the clipboard supports the specified `format`.
|
|
*
|
|
* @experimental
|
|
*/
|
|
has(format: string, type?: 'selection' | 'clipboard'): boolean;
|
|
/**
|
|
* Reads `format` type from the clipboard.
|
|
*
|
|
* `format` should contain valid ASCII characters and have `/` separator. `a/c`,
|
|
* `a/bc` are valid formats while `/abc`, `abc/`, `a/`, `/a`, `a` are not valid.
|
|
*
|
|
* @experimental
|
|
*/
|
|
read(format: string): string;
|
|
/**
|
|
* * `title` string
|
|
* * `url` string
|
|
*
|
|
* Returns an Object containing `title` and `url` keys representing the bookmark in
|
|
* the clipboard. The `title` and `url` values will be empty strings when the
|
|
* bookmark is unavailable. The `title` value will always be empty on Windows.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
readBookmark(): ReadBookmark;
|
|
/**
|
|
* Reads `format` type from the clipboard.
|
|
*
|
|
* @experimental
|
|
*/
|
|
readBuffer(format: string): Buffer;
|
|
/**
|
|
* The text on the find pasteboard, which is the pasteboard that holds information
|
|
* about the current state of the active application’s find panel.
|
|
*
|
|
* This method uses synchronous IPC when called from the renderer process. The
|
|
* cached value is reread from the find pasteboard whenever the application is
|
|
* activated.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
readFindText(): string;
|
|
/**
|
|
* The content in the clipboard as markup.
|
|
*/
|
|
readHTML(type?: 'selection' | 'clipboard'): string;
|
|
/**
|
|
* The image content in the clipboard.
|
|
*/
|
|
readImage(type?: 'selection' | 'clipboard'): NativeImage;
|
|
/**
|
|
* The content in the clipboard as RTF.
|
|
*/
|
|
readRTF(type?: 'selection' | 'clipboard'): string;
|
|
/**
|
|
* The content in the clipboard as plain text.
|
|
*/
|
|
readText(type?: 'selection' | 'clipboard'): string;
|
|
/**
|
|
* Writes `data` to the clipboard.
|
|
*/
|
|
write(data: Data, type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Writes the `title` (macOS only) and `url` into the clipboard as a bookmark.
|
|
*
|
|
* **Note:** Most apps on Windows don't support pasting bookmarks into them so you
|
|
* can use `clipboard.write` to write both a bookmark and fallback text to the
|
|
* clipboard.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
writeBookmark(title: string, url: string, type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Writes the `buffer` into the clipboard as `format`.
|
|
*
|
|
* @experimental
|
|
*/
|
|
writeBuffer(format: string, buffer: Buffer, type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Writes the `text` into the find pasteboard (the pasteboard that holds
|
|
* information about the current state of the active application’s find panel) as
|
|
* plain text. This method uses synchronous IPC when called from the renderer
|
|
* process.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
writeFindText(text: string): void;
|
|
/**
|
|
* Writes `markup` to the clipboard.
|
|
*/
|
|
writeHTML(markup: string, type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Writes `image` to the clipboard.
|
|
*/
|
|
writeImage(image: NativeImage, type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Writes the `text` into the clipboard in RTF.
|
|
*/
|
|
writeRTF(text: string, type?: 'selection' | 'clipboard'): void;
|
|
/**
|
|
* Writes the `text` into the clipboard as plain text.
|
|
*/
|
|
writeText(text: string, type?: 'selection' | 'clipboard'): void;
|
|
}
|
|
|
|
class CommandLine {
|
|
|
|
// Docs: https://electronjs.org/docs/api/command-line
|
|
|
|
/**
|
|
* Append an argument to Chromium's command line. The argument will be quoted
|
|
* correctly. Switches will precede arguments regardless of appending order.
|
|
*
|
|
* If you're appending an argument like `--switch=value`, consider using
|
|
* `appendSwitch('switch', 'value')` instead.
|
|
*
|
|
* **Note:** This will not affect `process.argv`. The intended usage of this
|
|
* function is to control Chromium's behavior.
|
|
*/
|
|
appendArgument(value: string): void;
|
|
/**
|
|
* Append a switch (with optional `value`) to Chromium's command line.
|
|
*
|
|
* **Note:** This will not affect `process.argv`. The intended usage of this
|
|
* function is to control Chromium's behavior.
|
|
*/
|
|
appendSwitch(the_switch: string, value?: string): void;
|
|
/**
|
|
* The command-line switch value.
|
|
*
|
|
* **Note:** When the switch is not present or has no value, it returns empty
|
|
* string.
|
|
*/
|
|
getSwitchValue(the_switch: string): string;
|
|
/**
|
|
* Whether the command-line switch is present.
|
|
*/
|
|
hasSwitch(the_switch: string): boolean;
|
|
/**
|
|
* Removes the specified switch from Chromium's command line.
|
|
*
|
|
* **Note:** This will not affect `process.argv`. The intended usage of this
|
|
* function is to control Chromium's behavior.
|
|
*/
|
|
removeSwitch(the_switch: string): void;
|
|
}
|
|
|
|
interface ContentTracing {
|
|
|
|
// Docs: https://electronjs.org/docs/api/content-tracing
|
|
|
|
/**
|
|
* resolves with an array of category groups once all child processes have
|
|
* acknowledged the `getCategories` request
|
|
*
|
|
* Get a set of category groups. The category groups can change as new code paths
|
|
* are reached. See also the list of built-in tracing categories.
|
|
*
|
|
* > **NOTE:** Electron adds a non-default tracing category called `"electron"`.
|
|
* This category can be used to capture Electron-specific tracing events.
|
|
*/
|
|
getCategories(): Promise<string[]>;
|
|
/**
|
|
* Resolves with an object containing the `value` and `percentage` of trace buffer
|
|
* maximum usage
|
|
*
|
|
* * `value` number
|
|
* * `percentage` number
|
|
*
|
|
* Get the maximum usage across processes of trace buffer as a percentage of the
|
|
* full state.
|
|
*/
|
|
getTraceBufferUsage(): Promise<Electron.TraceBufferUsageReturnValue>;
|
|
/**
|
|
* resolved once all child processes have acknowledged the `startRecording`
|
|
* request.
|
|
*
|
|
* Start recording on all processes.
|
|
*
|
|
* Recording begins immediately locally and asynchronously on child processes as
|
|
* soon as they receive the EnableRecording request.
|
|
*
|
|
* If a recording is already running, the promise will be immediately resolved, as
|
|
* only one trace operation can be in progress at a time.
|
|
*/
|
|
startRecording(options: (TraceConfig) | (TraceCategoriesAndOptions)): Promise<void>;
|
|
/**
|
|
* resolves with a path to a file that contains the traced data once all child
|
|
* processes have acknowledged the `stopRecording` request
|
|
*
|
|
* Stop recording on all processes.
|
|
*
|
|
* Child processes typically cache trace data and only rarely flush and send trace
|
|
* data back to the main process. This helps to minimize the runtime overhead of
|
|
* tracing since sending trace data over IPC can be an expensive operation. So, to
|
|
* end tracing, Chromium asynchronously asks all child processes to flush any
|
|
* pending trace data.
|
|
*
|
|
* Trace data will be written into `resultFilePath`. If `resultFilePath` is empty
|
|
* or not provided, trace data will be written to a temporary file, and the path
|
|
* will be returned in the promise.
|
|
*/
|
|
stopRecording(resultFilePath?: string): Promise<string>;
|
|
}
|
|
|
|
interface ContextBridge {
|
|
|
|
// Docs: https://electronjs.org/docs/api/context-bridge
|
|
|
|
exposeInIsolatedWorld(worldId: number, apiKey: string, api: any): void;
|
|
exposeInMainWorld(apiKey: string, api: any): void;
|
|
}
|
|
|
|
interface Cookie {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/cookie
|
|
|
|
/**
|
|
* The domain of the cookie; this will be normalized with a preceding dot so that
|
|
* it's also valid for subdomains.
|
|
*/
|
|
domain?: string;
|
|
/**
|
|
* The expiration date of the cookie as the number of seconds since the UNIX epoch.
|
|
* Not provided for session cookies.
|
|
*/
|
|
expirationDate?: number;
|
|
/**
|
|
* Whether the cookie is a host-only cookie; this will only be `true` if no domain
|
|
* was passed.
|
|
*/
|
|
hostOnly?: boolean;
|
|
/**
|
|
* Whether the cookie is marked as HTTP only.
|
|
*/
|
|
httpOnly?: boolean;
|
|
/**
|
|
* The name of the cookie.
|
|
*/
|
|
name: string;
|
|
/**
|
|
* The path of the cookie.
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* The Same Site policy applied to this cookie. Can be `unspecified`,
|
|
* `no_restriction`, `lax` or `strict`.
|
|
*/
|
|
sameSite: ('unspecified' | 'no_restriction' | 'lax' | 'strict');
|
|
/**
|
|
* Whether the cookie is marked as secure.
|
|
*/
|
|
secure?: boolean;
|
|
/**
|
|
* Whether the cookie is a session cookie or a persistent cookie with an expiration
|
|
* date.
|
|
*/
|
|
session?: boolean;
|
|
/**
|
|
* The value of the cookie.
|
|
*/
|
|
value: string;
|
|
}
|
|
|
|
class Cookies extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/cookies
|
|
|
|
/**
|
|
* Emitted when a cookie is changed because it was added, edited, removed, or
|
|
* expired.
|
|
*/
|
|
on(event: 'changed', listener: (event: Event,
|
|
/**
|
|
* The cookie that was changed.
|
|
*/
|
|
cookie: Cookie,
|
|
/**
|
|
* The cause of the change with one of the following values:
|
|
*/
|
|
cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
|
|
/**
|
|
* `true` if the cookie was removed, `false` otherwise.
|
|
*/
|
|
removed: boolean) => void): this;
|
|
once(event: 'changed', listener: (event: Event,
|
|
/**
|
|
* The cookie that was changed.
|
|
*/
|
|
cookie: Cookie,
|
|
/**
|
|
* The cause of the change with one of the following values:
|
|
*/
|
|
cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
|
|
/**
|
|
* `true` if the cookie was removed, `false` otherwise.
|
|
*/
|
|
removed: boolean) => void): this;
|
|
addListener(event: 'changed', listener: (event: Event,
|
|
/**
|
|
* The cookie that was changed.
|
|
*/
|
|
cookie: Cookie,
|
|
/**
|
|
* The cause of the change with one of the following values:
|
|
*/
|
|
cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
|
|
/**
|
|
* `true` if the cookie was removed, `false` otherwise.
|
|
*/
|
|
removed: boolean) => void): this;
|
|
removeListener(event: 'changed', listener: (event: Event,
|
|
/**
|
|
* The cookie that was changed.
|
|
*/
|
|
cookie: Cookie,
|
|
/**
|
|
* The cause of the change with one of the following values:
|
|
*/
|
|
cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
|
|
/**
|
|
* `true` if the cookie was removed, `false` otherwise.
|
|
*/
|
|
removed: boolean) => void): this;
|
|
/**
|
|
* A promise which resolves when the cookie store has been flushed
|
|
*
|
|
* Writes any unwritten cookies data to disk
|
|
*
|
|
* Cookies written by any method will not be written to disk immediately, but will
|
|
* be written every 30 seconds or 512 operations
|
|
*
|
|
* Calling this method can cause the cookie to be written to disk immediately.
|
|
*/
|
|
flushStore(): Promise<void>;
|
|
/**
|
|
* A promise which resolves an array of cookie objects.
|
|
*
|
|
* Sends a request to get all cookies matching `filter`, and resolves a promise
|
|
* with the response.
|
|
*/
|
|
get(filter: CookiesGetFilter): Promise<Electron.Cookie[]>;
|
|
/**
|
|
* A promise which resolves when the cookie has been removed
|
|
*
|
|
* Removes the cookies matching `url` and `name`
|
|
*/
|
|
remove(url: string, name: string): Promise<void>;
|
|
/**
|
|
* A promise which resolves when the cookie has been set
|
|
*
|
|
* Sets a cookie with `details`.
|
|
*/
|
|
set(details: CookiesSetDetails): Promise<void>;
|
|
}
|
|
|
|
interface CPUUsage {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/cpu-usage
|
|
|
|
/**
|
|
* The number of average idle CPU wakeups per second since the last call to
|
|
* getCPUUsage. First call returns 0. Will always return 0 on Windows.
|
|
*/
|
|
idleWakeupsPerSecond: number;
|
|
/**
|
|
* Percentage of CPU used since the last call to getCPUUsage. First call returns 0.
|
|
*/
|
|
percentCPUUsage: number;
|
|
}
|
|
|
|
interface CrashReport {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/crash-report
|
|
|
|
date: Date;
|
|
id: string;
|
|
}
|
|
|
|
interface CrashReporter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/crash-reporter
|
|
|
|
/**
|
|
* Set an extra parameter to be sent with the crash report. The values specified
|
|
* here will be sent in addition to any values set via the `extra` option when
|
|
* `start` was called.
|
|
*
|
|
* Parameters added in this fashion (or via the `extra` parameter to
|
|
* `crashReporter.start`) are specific to the calling process. Adding extra
|
|
* parameters in the main process will not cause those parameters to be sent along
|
|
* with crashes from renderer or other child processes. Similarly, adding extra
|
|
* parameters in a renderer process will not result in those parameters being sent
|
|
* with crashes that occur in other renderer processes or in the main process.
|
|
*
|
|
* **Note:** Parameters have limits on the length of the keys and values. Key names
|
|
* must be no longer than 39 bytes, and values must be no longer than 20320 bytes.
|
|
* Keys with names longer than the maximum will be silently ignored. Key values
|
|
* longer than the maximum length will be truncated.
|
|
*/
|
|
addExtraParameter(key: string, value: string): void;
|
|
/**
|
|
* The date and ID of the last crash report. Only crash reports that have been
|
|
* uploaded will be returned; even if a crash report is present on disk it will not
|
|
* be returned until it is uploaded. In the case that there are no uploaded
|
|
* reports, `null` is returned.
|
|
*
|
|
* **Note:** This method is only available in the main process.
|
|
*/
|
|
getLastCrashReport(): CrashReport;
|
|
/**
|
|
* The current 'extra' parameters of the crash reporter.
|
|
*/
|
|
getParameters(): Record<string, string>;
|
|
/**
|
|
* Returns all uploaded crash reports. Each report contains the date and uploaded
|
|
* ID.
|
|
*
|
|
* **Note:** This method is only available in the main process.
|
|
*/
|
|
getUploadedReports(): CrashReport[];
|
|
/**
|
|
* Whether reports should be submitted to the server. Set through the `start`
|
|
* method or `setUploadToServer`.
|
|
*
|
|
* **Note:** This method is only available in the main process.
|
|
*/
|
|
getUploadToServer(): boolean;
|
|
/**
|
|
* Remove an extra parameter from the current set of parameters. Future crashes
|
|
* will not include this parameter.
|
|
*/
|
|
removeExtraParameter(key: string): void;
|
|
/**
|
|
* This would normally be controlled by user preferences. This has no effect if
|
|
* called before `start` is called.
|
|
*
|
|
* **Note:** This method is only available in the main process.
|
|
*/
|
|
setUploadToServer(uploadToServer: boolean): void;
|
|
/**
|
|
* This method must be called before using any other `crashReporter` APIs. Once
|
|
* initialized this way, the crashpad handler collects crashes from all
|
|
* subsequently created processes. The crash reporter cannot be disabled once
|
|
* started.
|
|
*
|
|
* This method should be called as early as possible in app startup, preferably
|
|
* before `app.on('ready')`. If the crash reporter is not initialized at the time a
|
|
* renderer process is created, then that renderer process will not be monitored by
|
|
* the crash reporter.
|
|
*
|
|
* **Note:** You can test out the crash reporter by generating a crash using
|
|
* `process.crash()`.
|
|
*
|
|
* **Note:** If you need to send additional/updated `extra` parameters after your
|
|
* first call `start` you can call `addExtraParameter`.
|
|
*
|
|
* **Note:** Parameters passed in `extra`, `globalExtra` or set with
|
|
* `addExtraParameter` have limits on the length of the keys and values. Key names
|
|
* must be at most 39 bytes long, and values must be no longer than 127 bytes. Keys
|
|
* with names longer than the maximum will be silently ignored. Key values longer
|
|
* than the maximum length will be truncated.
|
|
*
|
|
* **Note:** This method is only available in the main process.
|
|
*/
|
|
start(options: CrashReporterStartOptions): void;
|
|
}
|
|
|
|
interface CustomScheme {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/custom-scheme
|
|
|
|
privileges?: Privileges;
|
|
/**
|
|
* Custom schemes to be registered with options.
|
|
*/
|
|
scheme: string;
|
|
}
|
|
|
|
class Debugger extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/debugger
|
|
|
|
/**
|
|
* Emitted when the debugging session is terminated. This happens either when
|
|
* `webContents` is closed or devtools is invoked for the attached `webContents`.
|
|
*/
|
|
on(event: 'detach', listener: (event: Event,
|
|
/**
|
|
* Reason for detaching debugger.
|
|
*/
|
|
reason: string) => void): this;
|
|
once(event: 'detach', listener: (event: Event,
|
|
/**
|
|
* Reason for detaching debugger.
|
|
*/
|
|
reason: string) => void): this;
|
|
addListener(event: 'detach', listener: (event: Event,
|
|
/**
|
|
* Reason for detaching debugger.
|
|
*/
|
|
reason: string) => void): this;
|
|
removeListener(event: 'detach', listener: (event: Event,
|
|
/**
|
|
* Reason for detaching debugger.
|
|
*/
|
|
reason: string) => void): this;
|
|
/**
|
|
* Emitted whenever the debugging target issues an instrumentation event.
|
|
*/
|
|
on(event: 'message', listener: (event: Event,
|
|
/**
|
|
* Method name.
|
|
*/
|
|
method: string,
|
|
/**
|
|
* Event parameters defined by the 'parameters' attribute in the remote debugging
|
|
* protocol.
|
|
*/
|
|
params: any,
|
|
/**
|
|
* Unique identifier of attached debugging session, will match the value sent from
|
|
* `debugger.sendCommand`.
|
|
*/
|
|
sessionId: string) => void): this;
|
|
once(event: 'message', listener: (event: Event,
|
|
/**
|
|
* Method name.
|
|
*/
|
|
method: string,
|
|
/**
|
|
* Event parameters defined by the 'parameters' attribute in the remote debugging
|
|
* protocol.
|
|
*/
|
|
params: any,
|
|
/**
|
|
* Unique identifier of attached debugging session, will match the value sent from
|
|
* `debugger.sendCommand`.
|
|
*/
|
|
sessionId: string) => void): this;
|
|
addListener(event: 'message', listener: (event: Event,
|
|
/**
|
|
* Method name.
|
|
*/
|
|
method: string,
|
|
/**
|
|
* Event parameters defined by the 'parameters' attribute in the remote debugging
|
|
* protocol.
|
|
*/
|
|
params: any,
|
|
/**
|
|
* Unique identifier of attached debugging session, will match the value sent from
|
|
* `debugger.sendCommand`.
|
|
*/
|
|
sessionId: string) => void): this;
|
|
removeListener(event: 'message', listener: (event: Event,
|
|
/**
|
|
* Method name.
|
|
*/
|
|
method: string,
|
|
/**
|
|
* Event parameters defined by the 'parameters' attribute in the remote debugging
|
|
* protocol.
|
|
*/
|
|
params: any,
|
|
/**
|
|
* Unique identifier of attached debugging session, will match the value sent from
|
|
* `debugger.sendCommand`.
|
|
*/
|
|
sessionId: string) => void): this;
|
|
/**
|
|
* Attaches the debugger to the `webContents`.
|
|
*/
|
|
attach(protocolVersion?: string): void;
|
|
/**
|
|
* Detaches the debugger from the `webContents`.
|
|
*/
|
|
detach(): void;
|
|
/**
|
|
* Whether a debugger is attached to the `webContents`.
|
|
*/
|
|
isAttached(): boolean;
|
|
/**
|
|
* A promise that resolves with the response defined by the 'returns' attribute of
|
|
* the command description in the remote debugging protocol or is rejected
|
|
* indicating the failure of the command.
|
|
*
|
|
* Send given command to the debugging target.
|
|
*/
|
|
sendCommand(method: string, commandParams?: any, sessionId?: string): Promise<any>;
|
|
}
|
|
|
|
interface DesktopCapturer {
|
|
|
|
// Docs: https://electronjs.org/docs/api/desktop-capturer
|
|
|
|
/**
|
|
* Resolves with an array of `DesktopCapturerSource` objects, each
|
|
* `DesktopCapturerSource` represents a screen or an individual window that can be
|
|
* captured.
|
|
*
|
|
* **Note** Capturing the screen contents requires user consent on macOS 10.15
|
|
* Catalina or higher, which can detected by
|
|
* `systemPreferences.getMediaAccessStatus`.
|
|
*/
|
|
getSources(options: SourcesOptions): Promise<Electron.DesktopCapturerSource[]>;
|
|
}
|
|
|
|
interface DesktopCapturerSource {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/desktop-capturer-source
|
|
|
|
/**
|
|
* An icon image of the application that owns the window or null if the source has
|
|
* a type screen. The size of the icon is not known in advance and depends on what
|
|
* the application provides.
|
|
*/
|
|
appIcon: NativeImage;
|
|
/**
|
|
* A unique identifier that will correspond to the `id` of the matching Display
|
|
* returned by the Screen API. On some platforms, this is equivalent to the `XX`
|
|
* portion of the `id` field above and on others it will differ. It will be an
|
|
* empty string if not available.
|
|
*/
|
|
display_id: string;
|
|
/**
|
|
* The identifier of a window or screen that can be used as a `chromeMediaSourceId`
|
|
* constraint when calling `navigator.getUserMedia`. The format of the identifier
|
|
* will be `window:XX:YY` or `screen:ZZ:0`. XX is the windowID/handle. YY is 1 for
|
|
* the current process, and 0 for all others. ZZ is a sequential number that
|
|
* represents the screen, and it does not equal to the index in the source's name.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* A screen source will be named either `Entire Screen` or `Screen <index>`, while
|
|
* the name of a window source will match the window title.
|
|
*/
|
|
name: string;
|
|
/**
|
|
* A thumbnail image. **Note:** There is no guarantee that the size of the
|
|
* thumbnail is the same as the `thumbnailSize` specified in the `options` passed
|
|
* to `desktopCapturer.getSources`. The actual size depends on the scale of the
|
|
* screen or window.
|
|
*/
|
|
thumbnail: NativeImage;
|
|
}
|
|
|
|
interface Dialog {
|
|
|
|
// Docs: https://electronjs.org/docs/api/dialog
|
|
|
|
/**
|
|
* resolves when the certificate trust dialog is shown.
|
|
*
|
|
* On macOS, this displays a modal dialog that shows a message and certificate
|
|
* information, and gives the user the option of trusting/importing the
|
|
* certificate. If you provide a `browserWindow` argument the dialog will be
|
|
* attached to the parent window, making it modal.
|
|
*
|
|
* On Windows the options are more limited, due to the Win32 APIs used:
|
|
*
|
|
* * The `message` argument is not used, as the OS provides its own confirmation
|
|
* dialog.
|
|
* * The `browserWindow` argument is ignored since it is not possible to make this
|
|
* confirmation dialog modal.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
showCertificateTrustDialog(browserWindow: BrowserWindow, options: CertificateTrustDialogOptions): Promise<void>;
|
|
/**
|
|
* resolves when the certificate trust dialog is shown.
|
|
*
|
|
* On macOS, this displays a modal dialog that shows a message and certificate
|
|
* information, and gives the user the option of trusting/importing the
|
|
* certificate. If you provide a `browserWindow` argument the dialog will be
|
|
* attached to the parent window, making it modal.
|
|
*
|
|
* On Windows the options are more limited, due to the Win32 APIs used:
|
|
*
|
|
* * The `message` argument is not used, as the OS provides its own confirmation
|
|
* dialog.
|
|
* * The `browserWindow` argument is ignored since it is not possible to make this
|
|
* confirmation dialog modal.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
showCertificateTrustDialog(options: CertificateTrustDialogOptions): Promise<void>;
|
|
/**
|
|
* Displays a modal dialog that shows an error message.
|
|
*
|
|
* This API can be called safely before the `ready` event the `app` module emits,
|
|
* it is usually used to report errors in early stage of startup. If called before
|
|
* the app `ready`event on Linux, the message will be emitted to stderr, and no GUI
|
|
* dialog will appear.
|
|
*/
|
|
showErrorBox(title: string, content: string): void;
|
|
/**
|
|
* resolves with a promise containing the following properties:
|
|
*
|
|
* * `response` number - The index of the clicked button.
|
|
* * `checkboxChecked` boolean - The checked state of the checkbox if
|
|
* `checkboxLabel` was set. Otherwise `false`.
|
|
*
|
|
* Shows a message box.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*/
|
|
showMessageBox(browserWindow: BrowserWindow, options: MessageBoxOptions): Promise<Electron.MessageBoxReturnValue>;
|
|
/**
|
|
* resolves with a promise containing the following properties:
|
|
*
|
|
* * `response` number - The index of the clicked button.
|
|
* * `checkboxChecked` boolean - The checked state of the checkbox if
|
|
* `checkboxLabel` was set. Otherwise `false`.
|
|
*
|
|
* Shows a message box.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*/
|
|
showMessageBox(options: MessageBoxOptions): Promise<Electron.MessageBoxReturnValue>;
|
|
/**
|
|
* the index of the clicked button.
|
|
*
|
|
* Shows a message box, it will block the process until the message box is closed.
|
|
* It returns the index of the clicked button.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal. If `browserWindow` is not shown dialog will not be
|
|
* attached to it. In such case it will be displayed as an independent window.
|
|
*/
|
|
showMessageBoxSync(browserWindow: BrowserWindow, options: MessageBoxSyncOptions): number;
|
|
/**
|
|
* the index of the clicked button.
|
|
*
|
|
* Shows a message box, it will block the process until the message box is closed.
|
|
* It returns the index of the clicked button.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal. If `browserWindow` is not shown dialog will not be
|
|
* attached to it. In such case it will be displayed as an independent window.
|
|
*/
|
|
showMessageBoxSync(options: MessageBoxSyncOptions): number;
|
|
/**
|
|
* Resolve with an object containing the following:
|
|
*
|
|
* * `canceled` boolean - whether or not the dialog was canceled.
|
|
* * `filePaths` string[] - An array of file paths chosen by the user. If the
|
|
* dialog is cancelled this will be an empty array.
|
|
* * `bookmarks` string[] (optional) _macOS_ _mas_ - An array matching the
|
|
* `filePaths` array of base64 encoded strings which contains security scoped
|
|
* bookmark data. `securityScopedBookmarks` must be enabled for this to be
|
|
* populated. (For return values, see table here.)
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed or selected
|
|
* when you want to limit the user to a specific type. For example:
|
|
*
|
|
* The `extensions` array should contain extensions without wildcards or dots (e.g.
|
|
* `'png'` is good but `'.png'` and `'*.png'` are bad). To show all files, use the
|
|
* `'*'` wildcard (no other wildcard is supported).
|
|
*
|
|
* **Note:** On Windows and Linux an open dialog can not be both a file selector
|
|
* and a directory selector, so if you set `properties` to `['openFile',
|
|
* 'openDirectory']` on these platforms, a directory selector will be shown.
|
|
*/
|
|
showOpenDialog(browserWindow: BrowserWindow, options: OpenDialogOptions): Promise<Electron.OpenDialogReturnValue>;
|
|
/**
|
|
* Resolve with an object containing the following:
|
|
*
|
|
* * `canceled` boolean - whether or not the dialog was canceled.
|
|
* * `filePaths` string[] - An array of file paths chosen by the user. If the
|
|
* dialog is cancelled this will be an empty array.
|
|
* * `bookmarks` string[] (optional) _macOS_ _mas_ - An array matching the
|
|
* `filePaths` array of base64 encoded strings which contains security scoped
|
|
* bookmark data. `securityScopedBookmarks` must be enabled for this to be
|
|
* populated. (For return values, see table here.)
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed or selected
|
|
* when you want to limit the user to a specific type. For example:
|
|
*
|
|
* The `extensions` array should contain extensions without wildcards or dots (e.g.
|
|
* `'png'` is good but `'.png'` and `'*.png'` are bad). To show all files, use the
|
|
* `'*'` wildcard (no other wildcard is supported).
|
|
*
|
|
* **Note:** On Windows and Linux an open dialog can not be both a file selector
|
|
* and a directory selector, so if you set `properties` to `['openFile',
|
|
* 'openDirectory']` on these platforms, a directory selector will be shown.
|
|
*/
|
|
showOpenDialog(options: OpenDialogOptions): Promise<Electron.OpenDialogReturnValue>;
|
|
/**
|
|
* the file paths chosen by the user; if the dialog is cancelled it returns
|
|
* `undefined`.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed or selected
|
|
* when you want to limit the user to a specific type. For example:
|
|
*
|
|
* The `extensions` array should contain extensions without wildcards or dots (e.g.
|
|
* `'png'` is good but `'.png'` and `'*.png'` are bad). To show all files, use the
|
|
* `'*'` wildcard (no other wildcard is supported).
|
|
*
|
|
* **Note:** On Windows and Linux an open dialog can not be both a file selector
|
|
* and a directory selector, so if you set `properties` to `['openFile',
|
|
* 'openDirectory']` on these platforms, a directory selector will be shown.
|
|
*/
|
|
showOpenDialogSync(browserWindow: BrowserWindow, options: OpenDialogSyncOptions): (string[]) | (undefined);
|
|
/**
|
|
* the file paths chosen by the user; if the dialog is cancelled it returns
|
|
* `undefined`.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed or selected
|
|
* when you want to limit the user to a specific type. For example:
|
|
*
|
|
* The `extensions` array should contain extensions without wildcards or dots (e.g.
|
|
* `'png'` is good but `'.png'` and `'*.png'` are bad). To show all files, use the
|
|
* `'*'` wildcard (no other wildcard is supported).
|
|
*
|
|
* **Note:** On Windows and Linux an open dialog can not be both a file selector
|
|
* and a directory selector, so if you set `properties` to `['openFile',
|
|
* 'openDirectory']` on these platforms, a directory selector will be shown.
|
|
*/
|
|
showOpenDialogSync(options: OpenDialogSyncOptions): (string[]) | (undefined);
|
|
/**
|
|
* Resolve with an object containing the following:
|
|
*
|
|
* * `canceled` boolean - whether or not the dialog was canceled.
|
|
* * `filePath` string (optional) - If the dialog is canceled, this will be
|
|
* `undefined`.
|
|
* * `bookmark` string (optional) _macOS_ _mas_ - Base64 encoded string which
|
|
* contains the security scoped bookmark data for the saved file.
|
|
* `securityScopedBookmarks` must be enabled for this to be present. (For return
|
|
* values, see table here.)
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed, see
|
|
* `dialog.showOpenDialog` for an example.
|
|
*
|
|
* **Note:** On macOS, using the asynchronous version is recommended to avoid
|
|
* issues when expanding and collapsing the dialog.
|
|
*/
|
|
showSaveDialog(browserWindow: BrowserWindow, options: SaveDialogOptions): Promise<Electron.SaveDialogReturnValue>;
|
|
/**
|
|
* Resolve with an object containing the following:
|
|
*
|
|
* * `canceled` boolean - whether or not the dialog was canceled.
|
|
* * `filePath` string (optional) - If the dialog is canceled, this will be
|
|
* `undefined`.
|
|
* * `bookmark` string (optional) _macOS_ _mas_ - Base64 encoded string which
|
|
* contains the security scoped bookmark data for the saved file.
|
|
* `securityScopedBookmarks` must be enabled for this to be present. (For return
|
|
* values, see table here.)
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed, see
|
|
* `dialog.showOpenDialog` for an example.
|
|
*
|
|
* **Note:** On macOS, using the asynchronous version is recommended to avoid
|
|
* issues when expanding and collapsing the dialog.
|
|
*/
|
|
showSaveDialog(options: SaveDialogOptions): Promise<Electron.SaveDialogReturnValue>;
|
|
/**
|
|
* the path of the file chosen by the user; if the dialog is cancelled it returns
|
|
* `undefined`.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed, see
|
|
* `dialog.showOpenDialog` for an example.
|
|
*/
|
|
showSaveDialogSync(browserWindow: BrowserWindow, options: SaveDialogSyncOptions): (string) | (undefined);
|
|
/**
|
|
* the path of the file chosen by the user; if the dialog is cancelled it returns
|
|
* `undefined`.
|
|
*
|
|
* The `browserWindow` argument allows the dialog to attach itself to a parent
|
|
* window, making it modal.
|
|
*
|
|
* The `filters` specifies an array of file types that can be displayed, see
|
|
* `dialog.showOpenDialog` for an example.
|
|
*/
|
|
showSaveDialogSync(options: SaveDialogSyncOptions): (string) | (undefined);
|
|
}
|
|
|
|
interface Display {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/display
|
|
|
|
/**
|
|
* Can be `available`, `unavailable`, `unknown`.
|
|
*/
|
|
accelerometerSupport: ('available' | 'unavailable' | 'unknown');
|
|
/**
|
|
* the bounds of the display in DIP points.
|
|
*/
|
|
bounds: Rectangle;
|
|
/**
|
|
* The number of bits per pixel.
|
|
*/
|
|
colorDepth: number;
|
|
/**
|
|
* represent a color space (three-dimensional object which contains all realizable
|
|
* color combinations) for the purpose of color conversions
|
|
*/
|
|
colorSpace: string;
|
|
/**
|
|
* The number of bits per color component.
|
|
*/
|
|
depthPerComponent: number;
|
|
/**
|
|
* The display refresh rate.
|
|
*/
|
|
displayFrequency: number;
|
|
/**
|
|
* Unique identifier associated with the display.
|
|
*/
|
|
id: number;
|
|
/**
|
|
* `true` for an internal display and `false` for an external display
|
|
*/
|
|
internal: boolean;
|
|
/**
|
|
* User-friendly label, determined by the platform.
|
|
*/
|
|
label: string;
|
|
/**
|
|
* Whether or not the display is a monochrome display.
|
|
*/
|
|
monochrome: boolean;
|
|
/**
|
|
* Can be 0, 90, 180, 270, represents screen rotation in clock-wise degrees.
|
|
*/
|
|
rotation: number;
|
|
/**
|
|
* Output device's pixel scale factor.
|
|
*/
|
|
scaleFactor: number;
|
|
size: Size;
|
|
/**
|
|
* Can be `available`, `unavailable`, `unknown`.
|
|
*/
|
|
touchSupport: ('available' | 'unavailable' | 'unknown');
|
|
/**
|
|
* the work area of the display in DIP points.
|
|
*/
|
|
workArea: Rectangle;
|
|
workAreaSize: Size;
|
|
}
|
|
|
|
class Dock {
|
|
|
|
// Docs: https://electronjs.org/docs/api/dock
|
|
|
|
/**
|
|
* an ID representing the request.
|
|
*
|
|
* When `critical` is passed, the dock icon will bounce until either the
|
|
* application becomes active or the request is canceled.
|
|
*
|
|
* When `informational` is passed, the dock icon will bounce for one second.
|
|
* However, the request remains active until either the application becomes active
|
|
* or the request is canceled.
|
|
*
|
|
* **Note:** This method can only be used while the app is not focused; when the
|
|
* app is focused it will return -1.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
bounce(type?: 'critical' | 'informational'): number;
|
|
/**
|
|
* Cancel the bounce of `id`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
cancelBounce(id: number): void;
|
|
/**
|
|
* Bounces the Downloads stack if the filePath is inside the Downloads folder.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
downloadFinished(filePath: string): void;
|
|
/**
|
|
* The badge string of the dock.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getBadge(): string;
|
|
/**
|
|
* The application's dock menu.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getMenu(): (Menu) | (null);
|
|
/**
|
|
* Hides the dock icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
hide(): void;
|
|
/**
|
|
* Whether the dock icon is visible.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isVisible(): boolean;
|
|
/**
|
|
* Sets the string to be displayed in the dock’s badging area.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setBadge(text: string): void;
|
|
/**
|
|
* Sets the `image` associated with this dock icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setIcon(image: (NativeImage) | (string)): void;
|
|
/**
|
|
* Sets the application's dock menu.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setMenu(menu: Menu): void;
|
|
/**
|
|
* Resolves when the dock icon is shown.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
show(): Promise<void>;
|
|
}
|
|
|
|
class DownloadItem extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/download-item
|
|
|
|
/**
|
|
* Emitted when the download is in a terminal state. This includes a completed
|
|
* download, a cancelled download (via `downloadItem.cancel()`), and interrupted
|
|
* download that can't be resumed.
|
|
*
|
|
* The `state` can be one of following:
|
|
*
|
|
* * `completed` - The download completed successfully.
|
|
* * `cancelled` - The download has been cancelled.
|
|
* * `interrupted` - The download has interrupted and can not resume.
|
|
*/
|
|
on(event: 'done', listener: (event: Event,
|
|
/**
|
|
* Can be `completed`, `cancelled` or `interrupted`.
|
|
*/
|
|
state: ('completed' | 'cancelled' | 'interrupted')) => void): this;
|
|
once(event: 'done', listener: (event: Event,
|
|
/**
|
|
* Can be `completed`, `cancelled` or `interrupted`.
|
|
*/
|
|
state: ('completed' | 'cancelled' | 'interrupted')) => void): this;
|
|
addListener(event: 'done', listener: (event: Event,
|
|
/**
|
|
* Can be `completed`, `cancelled` or `interrupted`.
|
|
*/
|
|
state: ('completed' | 'cancelled' | 'interrupted')) => void): this;
|
|
removeListener(event: 'done', listener: (event: Event,
|
|
/**
|
|
* Can be `completed`, `cancelled` or `interrupted`.
|
|
*/
|
|
state: ('completed' | 'cancelled' | 'interrupted')) => void): this;
|
|
/**
|
|
* Emitted when the download has been updated and is not done.
|
|
*
|
|
* The `state` can be one of following:
|
|
*
|
|
* * `progressing` - The download is in-progress.
|
|
* * `interrupted` - The download has interrupted and can be resumed.
|
|
*/
|
|
on(event: 'updated', listener: (event: Event,
|
|
/**
|
|
* Can be `progressing` or `interrupted`.
|
|
*/
|
|
state: ('progressing' | 'interrupted')) => void): this;
|
|
once(event: 'updated', listener: (event: Event,
|
|
/**
|
|
* Can be `progressing` or `interrupted`.
|
|
*/
|
|
state: ('progressing' | 'interrupted')) => void): this;
|
|
addListener(event: 'updated', listener: (event: Event,
|
|
/**
|
|
* Can be `progressing` or `interrupted`.
|
|
*/
|
|
state: ('progressing' | 'interrupted')) => void): this;
|
|
removeListener(event: 'updated', listener: (event: Event,
|
|
/**
|
|
* Can be `progressing` or `interrupted`.
|
|
*/
|
|
state: ('progressing' | 'interrupted')) => void): this;
|
|
/**
|
|
* Cancels the download operation.
|
|
*/
|
|
cancel(): void;
|
|
/**
|
|
* Whether the download can resume.
|
|
*/
|
|
canResume(): boolean;
|
|
/**
|
|
* The Content-Disposition field from the response header.
|
|
*/
|
|
getContentDisposition(): string;
|
|
/**
|
|
* ETag header value.
|
|
*/
|
|
getETag(): string;
|
|
/**
|
|
* The file name of the download item.
|
|
*
|
|
* **Note:** The file name is not always the same as the actual one saved in local
|
|
* disk. If user changes the file name in a prompted download saving dialog, the
|
|
* actual name of saved file will be different.
|
|
*/
|
|
getFilename(): string;
|
|
/**
|
|
* Last-Modified header value.
|
|
*/
|
|
getLastModifiedTime(): string;
|
|
/**
|
|
* The files mime type.
|
|
*/
|
|
getMimeType(): string;
|
|
/**
|
|
* The received bytes of the download item.
|
|
*/
|
|
getReceivedBytes(): number;
|
|
/**
|
|
* Returns the object previously set by
|
|
* `downloadItem.setSaveDialogOptions(options)`.
|
|
*/
|
|
getSaveDialogOptions(): SaveDialogOptions;
|
|
/**
|
|
* The save path of the download item. This will be either the path set via
|
|
* `downloadItem.setSavePath(path)` or the path selected from the shown save
|
|
* dialog.
|
|
*/
|
|
getSavePath(): string;
|
|
/**
|
|
* Number of seconds since the UNIX epoch when the download was started.
|
|
*/
|
|
getStartTime(): number;
|
|
/**
|
|
* The current state. Can be `progressing`, `completed`, `cancelled` or
|
|
* `interrupted`.
|
|
*
|
|
* **Note:** The following methods are useful specifically to resume a `cancelled`
|
|
* item when session is restarted.
|
|
*/
|
|
getState(): ('progressing' | 'completed' | 'cancelled' | 'interrupted');
|
|
/**
|
|
* The total size in bytes of the download item.
|
|
*
|
|
* If the size is unknown, it returns 0.
|
|
*/
|
|
getTotalBytes(): number;
|
|
/**
|
|
* The origin URL where the item is downloaded from.
|
|
*/
|
|
getURL(): string;
|
|
/**
|
|
* The complete URL chain of the item including any redirects.
|
|
*/
|
|
getURLChain(): string[];
|
|
/**
|
|
* Whether the download has user gesture.
|
|
*/
|
|
hasUserGesture(): boolean;
|
|
/**
|
|
* Whether the download is paused.
|
|
*/
|
|
isPaused(): boolean;
|
|
/**
|
|
* Pauses the download.
|
|
*/
|
|
pause(): void;
|
|
/**
|
|
* Resumes the download that has been paused.
|
|
*
|
|
* **Note:** To enable resumable downloads the server you are downloading from must
|
|
* support range requests and provide both `Last-Modified` and `ETag` header
|
|
* values. Otherwise `resume()` will dismiss previously received bytes and restart
|
|
* the download from the beginning.
|
|
*/
|
|
resume(): void;
|
|
/**
|
|
* This API allows the user to set custom options for the save dialog that opens
|
|
* for the download item by default. The API is only available in session's
|
|
* `will-download` callback function.
|
|
*/
|
|
setSaveDialogOptions(options: SaveDialogOptions): void;
|
|
/**
|
|
* The API is only available in session's `will-download` callback function. If
|
|
* `path` doesn't exist, Electron will try to make the directory recursively. If
|
|
* user doesn't set the save path via the API, Electron will use the original
|
|
* routine to determine the save path; this usually prompts a save dialog.
|
|
*/
|
|
setSavePath(path: string): void;
|
|
/**
|
|
* A `string` property that determines the save file path of the download item.
|
|
*
|
|
* The property is only available in session's `will-download` callback function.
|
|
* If user doesn't set the save path via the property, Electron will use the
|
|
* original routine to determine the save path; this usually prompts a save dialog.
|
|
*/
|
|
savePath: string;
|
|
}
|
|
|
|
interface Extension {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/extension
|
|
|
|
id: string;
|
|
/**
|
|
* Copy of the extension's manifest data.
|
|
*/
|
|
manifest: any;
|
|
name: string;
|
|
/**
|
|
* The extension's file path.
|
|
*/
|
|
path: string;
|
|
/**
|
|
* The extension's `chrome-extension://` URL.
|
|
*/
|
|
url: string;
|
|
version: string;
|
|
}
|
|
|
|
interface ExtensionInfo {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/extension-info
|
|
|
|
name: string;
|
|
version: string;
|
|
}
|
|
|
|
interface FileFilter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/file-filter
|
|
|
|
extensions: string[];
|
|
name: string;
|
|
}
|
|
|
|
interface FilePathWithHeaders {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/file-path-with-headers
|
|
|
|
/**
|
|
* Additional headers to be sent.
|
|
*/
|
|
headers?: Record<string, string>;
|
|
/**
|
|
* The path to the file to send.
|
|
*/
|
|
path: string;
|
|
}
|
|
|
|
interface GlobalShortcut {
|
|
|
|
// Docs: https://electronjs.org/docs/api/global-shortcut
|
|
|
|
/**
|
|
* Whether this application has registered `accelerator`.
|
|
*
|
|
* When the accelerator is already taken by other applications, this call will
|
|
* still return `false`. This behavior is intended by operating systems, since they
|
|
* don't want applications to fight for global shortcuts.
|
|
*/
|
|
isRegistered(accelerator: Accelerator): boolean;
|
|
/**
|
|
* Whether or not the shortcut was registered successfully.
|
|
*
|
|
* Registers a global shortcut of `accelerator`. The `callback` is called when the
|
|
* registered shortcut is pressed by the user.
|
|
*
|
|
* When the accelerator is already taken by other applications, this call will
|
|
* silently fail. This behavior is intended by operating systems, since they don't
|
|
* want applications to fight for global shortcuts.
|
|
*
|
|
* The following accelerators will not be registered successfully on macOS 10.14
|
|
* Mojave unless the app has been authorized as a trusted accessibility client:
|
|
*
|
|
* * "Media Play/Pause"
|
|
* * "Media Next Track"
|
|
* * "Media Previous Track"
|
|
* * "Media Stop"
|
|
*/
|
|
register(accelerator: Accelerator, callback: () => void): boolean;
|
|
/**
|
|
* Registers a global shortcut of all `accelerator` items in `accelerators`. The
|
|
* `callback` is called when any of the registered shortcuts are pressed by the
|
|
* user.
|
|
*
|
|
* When a given accelerator is already taken by other applications, this call will
|
|
* silently fail. This behavior is intended by operating systems, since they don't
|
|
* want applications to fight for global shortcuts.
|
|
*
|
|
* The following accelerators will not be registered successfully on macOS 10.14
|
|
* Mojave unless the app has been authorized as a trusted accessibility client:
|
|
*
|
|
* * "Media Play/Pause"
|
|
* * "Media Next Track"
|
|
* * "Media Previous Track"
|
|
* * "Media Stop"
|
|
*/
|
|
registerAll(accelerators: Accelerator[], callback: () => void): void;
|
|
/**
|
|
* Unregisters the global shortcut of `accelerator`.
|
|
*/
|
|
unregister(accelerator: Accelerator): void;
|
|
/**
|
|
* Unregisters all of the global shortcuts.
|
|
*/
|
|
unregisterAll(): void;
|
|
}
|
|
|
|
interface GPUFeatureStatus {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/gpu-feature-status
|
|
|
|
/**
|
|
* Canvas.
|
|
*/
|
|
'2d_canvas': string;
|
|
/**
|
|
* Flash.
|
|
*/
|
|
flash_3d: string;
|
|
/**
|
|
* Flash Stage3D.
|
|
*/
|
|
flash_stage3d: string;
|
|
/**
|
|
* Flash Stage3D Baseline profile.
|
|
*/
|
|
flash_stage3d_baseline: string;
|
|
/**
|
|
* Compositing.
|
|
*/
|
|
gpu_compositing: string;
|
|
/**
|
|
* Multiple Raster Threads.
|
|
*/
|
|
multiple_raster_threads: string;
|
|
/**
|
|
* Native GpuMemoryBuffers.
|
|
*/
|
|
native_gpu_memory_buffers: string;
|
|
/**
|
|
* Rasterization.
|
|
*/
|
|
rasterization: string;
|
|
/**
|
|
* Video Decode.
|
|
*/
|
|
video_decode: string;
|
|
/**
|
|
* Video Encode.
|
|
*/
|
|
video_encode: string;
|
|
/**
|
|
* VPx Video Decode.
|
|
*/
|
|
vpx_decode: string;
|
|
/**
|
|
* WebGL.
|
|
*/
|
|
webgl: string;
|
|
/**
|
|
* WebGL2.
|
|
*/
|
|
webgl2: string;
|
|
}
|
|
|
|
interface HIDDevice {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/hid-device
|
|
|
|
/**
|
|
* Unique identifier for the device.
|
|
*/
|
|
deviceId: string;
|
|
/**
|
|
* Unique identifier for the HID interface. A device may have multiple HID
|
|
* interfaces.
|
|
*/
|
|
guid?: string;
|
|
/**
|
|
* Name of the device.
|
|
*/
|
|
name: string;
|
|
/**
|
|
* The USB product ID.
|
|
*/
|
|
productId: number;
|
|
/**
|
|
* The USB device serial number.
|
|
*/
|
|
serialNumber?: string;
|
|
/**
|
|
* The USB vendor ID.
|
|
*/
|
|
vendorId: number;
|
|
}
|
|
|
|
interface InAppPurchase extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/in-app-purchase
|
|
|
|
on(event: 'transactions-updated', listener: Function): this;
|
|
once(event: 'transactions-updated', listener: Function): this;
|
|
addListener(event: 'transactions-updated', listener: Function): this;
|
|
removeListener(event: 'transactions-updated', listener: Function): this;
|
|
/**
|
|
* whether a user can make a payment.
|
|
*/
|
|
canMakePayments(): boolean;
|
|
/**
|
|
* Completes all pending transactions.
|
|
*/
|
|
finishAllTransactions(): void;
|
|
/**
|
|
* Completes the pending transactions corresponding to the date.
|
|
*/
|
|
finishTransactionByDate(date: string): void;
|
|
/**
|
|
* Resolves with an array of `Product` objects.
|
|
*
|
|
* Retrieves the product descriptions.
|
|
*/
|
|
getProducts(productIDs: string[]): Promise<Electron.Product[]>;
|
|
/**
|
|
* the path to the receipt.
|
|
*/
|
|
getReceiptURL(): string;
|
|
/**
|
|
* Returns `true` if the product is valid and added to the payment queue.
|
|
*
|
|
* You should listen for the `transactions-updated` event as soon as possible and
|
|
* certainly before you call `purchaseProduct`.
|
|
*/
|
|
purchaseProduct(productID: string, opts?: (number) | (PurchaseProductOpts)): Promise<boolean>;
|
|
/**
|
|
* Restores finished transactions. This method can be called either to install
|
|
* purchases on additional devices, or to restore purchases for an application that
|
|
* the user deleted and reinstalled.
|
|
*
|
|
* The payment queue delivers a new transaction for each previously completed
|
|
* transaction that can be restored. Each transaction includes a copy of the
|
|
* original transaction.
|
|
*/
|
|
restoreCompletedTransactions(): void;
|
|
}
|
|
|
|
class IncomingMessage extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/incoming-message
|
|
|
|
/**
|
|
* Emitted when a request has been canceled during an ongoing HTTP transaction.
|
|
*/
|
|
on(event: 'aborted', listener: Function): this;
|
|
once(event: 'aborted', listener: Function): this;
|
|
addListener(event: 'aborted', listener: Function): this;
|
|
removeListener(event: 'aborted', listener: Function): this;
|
|
/**
|
|
* The `data` event is the usual method of transferring response data into
|
|
* applicative code.
|
|
*/
|
|
on(event: 'data', listener: (
|
|
/**
|
|
* A chunk of response body's data.
|
|
*/
|
|
chunk: Buffer) => void): this;
|
|
once(event: 'data', listener: (
|
|
/**
|
|
* A chunk of response body's data.
|
|
*/
|
|
chunk: Buffer) => void): this;
|
|
addListener(event: 'data', listener: (
|
|
/**
|
|
* A chunk of response body's data.
|
|
*/
|
|
chunk: Buffer) => void): this;
|
|
removeListener(event: 'data', listener: (
|
|
/**
|
|
* A chunk of response body's data.
|
|
*/
|
|
chunk: Buffer) => void): this;
|
|
/**
|
|
* Indicates that response body has ended. Must be placed before 'data' event.
|
|
*/
|
|
on(event: 'end', listener: Function): this;
|
|
once(event: 'end', listener: Function): this;
|
|
addListener(event: 'end', listener: Function): this;
|
|
removeListener(event: 'end', listener: Function): this;
|
|
/**
|
|
* Returns:
|
|
*
|
|
* `error` Error - Typically holds an error string identifying failure root cause.
|
|
*
|
|
* Emitted when an error was encountered while streaming response data events. For
|
|
* instance, if the server closes the underlying while the response is still
|
|
* streaming, an `error` event will be emitted on the response object and a `close`
|
|
* event will subsequently follow on the request object.
|
|
*/
|
|
on(event: 'error', listener: Function): this;
|
|
once(event: 'error', listener: Function): this;
|
|
addListener(event: 'error', listener: Function): this;
|
|
removeListener(event: 'error', listener: Function): this;
|
|
/**
|
|
* A `Record<string, string | string[]>` representing the HTTP response headers.
|
|
* The `headers` object is formatted as follows:
|
|
*
|
|
* * All header names are lowercased.
|
|
* * Duplicates of `age`, `authorization`, `content-length`, `content-type`,
|
|
* `etag`, `expires`, `from`, `host`, `if-modified-since`, `if-unmodified-since`,
|
|
* `last-modified`, `location`, `max-forwards`, `proxy-authorization`, `referer`,
|
|
* `retry-after`, `server`, or `user-agent` are discarded.
|
|
* * `set-cookie` is always an array. Duplicates are added to the array.
|
|
* * For duplicate `cookie` headers, the values are joined together with '; '.
|
|
* * For all other headers, the values are joined together with ', '.
|
|
*/
|
|
headers: Record<string, (string) | (string[])>;
|
|
/**
|
|
* A `string` indicating the HTTP protocol version number. Typical values are '1.0'
|
|
* or '1.1'. Additionally `httpVersionMajor` and `httpVersionMinor` are two
|
|
* Integer-valued readable properties that return respectively the HTTP major and
|
|
* minor version numbers.
|
|
*/
|
|
httpVersion: string;
|
|
/**
|
|
* An `Integer` indicating the HTTP protocol major version number.
|
|
*/
|
|
httpVersionMajor: number;
|
|
/**
|
|
* An `Integer` indicating the HTTP protocol minor version number.
|
|
*/
|
|
httpVersionMinor: number;
|
|
/**
|
|
* A `string[]` containing the raw HTTP response headers exactly as they were
|
|
* received. The keys and values are in the same list. It is not a list of tuples.
|
|
* So, the even-numbered offsets are key values, and the odd-numbered offsets are
|
|
* the associated values. Header names are not lowercased, and duplicates are not
|
|
* merged.
|
|
*/
|
|
rawHeaders: string[];
|
|
/**
|
|
* An `Integer` indicating the HTTP response status code.
|
|
*/
|
|
statusCode: number;
|
|
/**
|
|
* A `string` representing the HTTP status message.
|
|
*/
|
|
statusMessage: string;
|
|
}
|
|
|
|
interface InputEvent {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/input-event
|
|
|
|
/**
|
|
* An array of modifiers of the event, can be `shift`, `control`, `ctrl`, `alt`,
|
|
* `meta`, `command`, `cmd`, `isKeypad`, `isAutoRepeat`, `leftButtonDown`,
|
|
* `middleButtonDown`, `rightButtonDown`, `capsLock`, `numLock`, `left`, `right`.
|
|
*/
|
|
modifiers?: Array<'shift' | 'control' | 'ctrl' | 'alt' | 'meta' | 'command' | 'cmd' | 'isKeypad' | 'isAutoRepeat' | 'leftButtonDown' | 'middleButtonDown' | 'rightButtonDown' | 'capsLock' | 'numLock' | 'left' | 'right'>;
|
|
/**
|
|
* Can be `undefined`, `mouseDown`, `mouseUp`, `mouseMove`, `mouseEnter`,
|
|
* `mouseLeave`, `contextMenu`, `mouseWheel`, `rawKeyDown`, `keyDown`, `keyUp`,
|
|
* `char`, `gestureScrollBegin`, `gestureScrollEnd`, `gestureScrollUpdate`,
|
|
* `gestureFlingStart`, `gestureFlingCancel`, `gesturePinchBegin`,
|
|
* `gesturePinchEnd`, `gesturePinchUpdate`, `gestureTapDown`, `gestureShowPress`,
|
|
* `gestureTap`, `gestureTapCancel`, `gestureShortPress`, `gestureLongPress`,
|
|
* `gestureLongTap`, `gestureTwoFingerTap`, `gestureTapUnconfirmed`,
|
|
* `gestureDoubleTap`, `touchStart`, `touchMove`, `touchEnd`, `touchCancel`,
|
|
* `touchScrollStarted`, `pointerDown`, `pointerUp`, `pointerMove`,
|
|
* `pointerRawUpdate`, `pointerCancel` or `pointerCausedUaAction`.
|
|
*/
|
|
type: ('undefined' | 'mouseDown' | 'mouseUp' | 'mouseMove' | 'mouseEnter' | 'mouseLeave' | 'contextMenu' | 'mouseWheel' | 'rawKeyDown' | 'keyDown' | 'keyUp' | 'char' | 'gestureScrollBegin' | 'gestureScrollEnd' | 'gestureScrollUpdate' | 'gestureFlingStart' | 'gestureFlingCancel' | 'gesturePinchBegin' | 'gesturePinchEnd' | 'gesturePinchUpdate' | 'gestureTapDown' | 'gestureShowPress' | 'gestureTap' | 'gestureTapCancel' | 'gestureShortPress' | 'gestureLongPress' | 'gestureLongTap' | 'gestureTwoFingerTap' | 'gestureTapUnconfirmed' | 'gestureDoubleTap' | 'touchStart' | 'touchMove' | 'touchEnd' | 'touchCancel' | 'touchScrollStarted' | 'pointerDown' | 'pointerUp' | 'pointerMove' | 'pointerRawUpdate' | 'pointerCancel' | 'pointerCausedUaAction');
|
|
}
|
|
|
|
interface IOCounters {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/io-counters
|
|
|
|
/**
|
|
* Then number of I/O other operations.
|
|
*/
|
|
otherOperationCount: number;
|
|
/**
|
|
* Then number of I/O other transfers.
|
|
*/
|
|
otherTransferCount: number;
|
|
/**
|
|
* The number of I/O read operations.
|
|
*/
|
|
readOperationCount: number;
|
|
/**
|
|
* The number of I/O read transfers.
|
|
*/
|
|
readTransferCount: number;
|
|
/**
|
|
* The number of I/O write operations.
|
|
*/
|
|
writeOperationCount: number;
|
|
/**
|
|
* The number of I/O write transfers.
|
|
*/
|
|
writeTransferCount: number;
|
|
}
|
|
|
|
interface IpcMain extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/ipc-main
|
|
|
|
/**
|
|
* Adds a handler for an `invoke`able IPC. This handler will be called whenever a
|
|
* renderer calls `ipcRenderer.invoke(channel, ...args)`.
|
|
*
|
|
* If `listener` returns a Promise, the eventual result of the promise will be
|
|
* returned as a reply to the remote caller. Otherwise, the return value of the
|
|
* listener will be used as the value of the reply.
|
|
*
|
|
* The `event` that is passed as the first argument to the handler is the same as
|
|
* that passed to a regular event listener. It includes information about which
|
|
* WebContents is the source of the invoke request.
|
|
*
|
|
* Errors thrown through `handle` in the main process are not transparent as they
|
|
* are serialized and only the `message` property from the original error is
|
|
* provided to the renderer process. Please refer to #24427 for details.
|
|
*/
|
|
handle(channel: string, listener: (event: IpcMainInvokeEvent, ...args: any[]) => (Promise<any>) | (any)): void;
|
|
/**
|
|
* Handles a single `invoke`able IPC message, then removes the listener. See
|
|
* `ipcMain.handle(channel, listener)`.
|
|
*/
|
|
handleOnce(channel: string, listener: (event: IpcMainInvokeEvent, ...args: any[]) => (Promise<any>) | (any)): void;
|
|
/**
|
|
* Listens to `channel`, when a new message arrives `listener` would be called with
|
|
* `listener(event, args...)`.
|
|
*/
|
|
on(channel: string, listener: (event: IpcMainEvent, ...args: any[]) => void): this;
|
|
/**
|
|
* Adds a one time `listener` function for the event. This `listener` is invoked
|
|
* only the next time a message is sent to `channel`, after which it is removed.
|
|
*/
|
|
once(channel: string, listener: (event: IpcMainEvent, ...args: any[]) => void): this;
|
|
/**
|
|
* Removes listeners of the specified `channel`.
|
|
*/
|
|
removeAllListeners(channel?: string): this;
|
|
/**
|
|
* Removes any handler for `channel`, if present.
|
|
*/
|
|
removeHandler(channel: string): void;
|
|
/**
|
|
* Removes the specified `listener` from the listener array for the specified
|
|
* `channel`.
|
|
*/
|
|
removeListener(channel: string, listener: (...args: any[]) => void): this;
|
|
}
|
|
|
|
interface IpcMainEvent extends Event {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/ipc-main-event
|
|
|
|
/**
|
|
* The ID of the renderer frame that sent this message
|
|
*/
|
|
frameId: number;
|
|
/**
|
|
* A list of MessagePorts that were transferred with this message
|
|
*/
|
|
ports: MessagePortMain[];
|
|
/**
|
|
* The internal ID of the renderer process that sent this message
|
|
*/
|
|
processId: number;
|
|
/**
|
|
* A function that will send an IPC message to the renderer frame that sent the
|
|
* original message that you are currently handling. You should use this method to
|
|
* "reply" to the sent message in order to guarantee the reply will go to the
|
|
* correct process and frame.
|
|
*/
|
|
reply: (channel: string, ...args: any[]) => void;
|
|
/**
|
|
* Set this to the value to be returned in a synchronous message
|
|
*/
|
|
returnValue: any;
|
|
/**
|
|
* Returns the `webContents` that sent the message
|
|
*/
|
|
sender: WebContents;
|
|
/**
|
|
* The frame that sent this message
|
|
*
|
|
*/
|
|
readonly senderFrame: WebFrameMain;
|
|
}
|
|
|
|
interface IpcMainInvokeEvent extends Event {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/ipc-main-invoke-event
|
|
|
|
/**
|
|
* The ID of the renderer frame that sent this message
|
|
*/
|
|
frameId: number;
|
|
/**
|
|
* The internal ID of the renderer process that sent this message
|
|
*/
|
|
processId: number;
|
|
/**
|
|
* Returns the `webContents` that sent the message
|
|
*/
|
|
sender: WebContents;
|
|
/**
|
|
* The frame that sent this message
|
|
*
|
|
*/
|
|
readonly senderFrame: WebFrameMain;
|
|
}
|
|
|
|
interface IpcRenderer extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/ipc-renderer
|
|
|
|
/**
|
|
* Resolves with the response from the main process.
|
|
*
|
|
* Send a message to the main process via `channel` and expect a result
|
|
* asynchronously. Arguments will be serialized with the Structured Clone
|
|
* Algorithm, just like `window.postMessage`, so prototype chains will not be
|
|
* included. Sending Functions, Promises, Symbols, WeakMaps, or WeakSets will throw
|
|
* an exception.
|
|
*
|
|
* The main process should listen for `channel` with `ipcMain.handle()`.
|
|
*
|
|
* For example:
|
|
*
|
|
* If you need to transfer a `MessagePort` to the main process, use
|
|
* `ipcRenderer.postMessage`.
|
|
*
|
|
* If you do not need a response to the message, consider using `ipcRenderer.send`.
|
|
*
|
|
* > **Note** Sending non-standard JavaScript types such as DOM objects or special
|
|
* Electron objects will throw an exception.
|
|
*
|
|
* Since the main process does not have support for DOM objects such as
|
|
* `ImageBitmap`, `File`, `DOMMatrix` and so on, such objects cannot be sent over
|
|
* Electron's IPC to the main process, as the main process would have no way to
|
|
* decode them. Attempting to send such objects over IPC will result in an error.
|
|
*
|
|
* > **Note** If the handler in the main process throws an error, the promise
|
|
* returned by `invoke` will reject. However, the `Error` object in the renderer
|
|
* process will not be the same as the one thrown in the main process.
|
|
*/
|
|
invoke(channel: string, ...args: any[]): Promise<any>;
|
|
/**
|
|
* Listens to `channel`, when a new message arrives `listener` would be called with
|
|
* `listener(event, args...)`.
|
|
*/
|
|
on(channel: string, listener: (event: IpcRendererEvent, ...args: any[]) => void): this;
|
|
/**
|
|
* Adds a one time `listener` function for the event. This `listener` is invoked
|
|
* only the next time a message is sent to `channel`, after which it is removed.
|
|
*/
|
|
once(channel: string, listener: (event: IpcRendererEvent, ...args: any[]) => void): this;
|
|
/**
|
|
* Send a message to the main process, optionally transferring ownership of zero or
|
|
* more `MessagePort` objects.
|
|
*
|
|
* The transferred `MessagePort` objects will be available in the main process as
|
|
* `MessagePortMain` objects by accessing the `ports` property of the emitted
|
|
* event.
|
|
*
|
|
* For example:
|
|
*
|
|
* For more information on using `MessagePort` and `MessageChannel`, see the MDN
|
|
* documentation.
|
|
*/
|
|
postMessage(channel: string, message: any, transfer?: MessagePort[]): void;
|
|
/**
|
|
* Removes all listeners, or those of the specified `channel`.
|
|
*/
|
|
removeAllListeners(channel: string): this;
|
|
/**
|
|
* Removes the specified `listener` from the listener array for the specified
|
|
* `channel`.
|
|
*/
|
|
removeListener(channel: string, listener: (...args: any[]) => void): this;
|
|
/**
|
|
* Send an asynchronous message to the main process via `channel`, along with
|
|
* arguments. Arguments will be serialized with the Structured Clone Algorithm,
|
|
* just like `window.postMessage`, so prototype chains will not be included.
|
|
* Sending Functions, Promises, Symbols, WeakMaps, or WeakSets will throw an
|
|
* exception.
|
|
*
|
|
* > **NOTE:** Sending non-standard JavaScript types such as DOM objects or special
|
|
* Electron objects will throw an exception.
|
|
*
|
|
* Since the main process does not have support for DOM objects such as
|
|
* `ImageBitmap`, `File`, `DOMMatrix` and so on, such objects cannot be sent over
|
|
* Electron's IPC to the main process, as the main process would have no way to
|
|
* decode them. Attempting to send such objects over IPC will result in an error.
|
|
*
|
|
* The main process handles it by listening for `channel` with the `ipcMain`
|
|
* module.
|
|
*
|
|
* If you need to transfer a `MessagePort` to the main process, use
|
|
* `ipcRenderer.postMessage`.
|
|
*
|
|
* If you want to receive a single response from the main process, like the result
|
|
* of a method call, consider using `ipcRenderer.invoke`.
|
|
*/
|
|
send(channel: string, ...args: any[]): void;
|
|
/**
|
|
* The value sent back by the `ipcMain` handler.
|
|
*
|
|
* Send a message to the main process via `channel` and expect a result
|
|
* synchronously. Arguments will be serialized with the Structured Clone Algorithm,
|
|
* just like `window.postMessage`, so prototype chains will not be included.
|
|
* Sending Functions, Promises, Symbols, WeakMaps, or WeakSets will throw an
|
|
* exception.
|
|
*
|
|
* > **NOTE:** Sending non-standard JavaScript types such as DOM objects or special
|
|
* Electron objects will throw an exception.
|
|
*
|
|
* Since the main process does not have support for DOM objects such as
|
|
* `ImageBitmap`, `File`, `DOMMatrix` and so on, such objects cannot be sent over
|
|
* Electron's IPC to the main process, as the main process would have no way to
|
|
* decode them. Attempting to send such objects over IPC will result in an error.
|
|
*
|
|
* The main process handles it by listening for `channel` with `ipcMain` module,
|
|
* and replies by setting `event.returnValue`.
|
|
*
|
|
* > :warning: **WARNING**: Sending a synchronous message will block the whole
|
|
* renderer process until the reply is received, so use this method only as a last
|
|
* resort. It's much better to use the asynchronous version, `invoke()`.
|
|
*/
|
|
sendSync(channel: string, ...args: any[]): any;
|
|
/**
|
|
* Sends a message to a window with `webContentsId` via `channel`.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
sendTo(webContentsId: number, channel: string, ...args: any[]): void;
|
|
/**
|
|
* Like `ipcRenderer.send` but the event will be sent to the `<webview>` element in
|
|
* the host page instead of the main process.
|
|
*/
|
|
sendToHost(channel: string, ...args: any[]): void;
|
|
}
|
|
|
|
interface IpcRendererEvent extends Event {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/ipc-renderer-event
|
|
|
|
/**
|
|
* A list of MessagePorts that were transferred with this message
|
|
*/
|
|
ports: MessagePort[];
|
|
/**
|
|
* The `IpcRenderer` instance that emitted the event originally
|
|
*/
|
|
sender: IpcRenderer;
|
|
/**
|
|
* The `webContents.id` that sent the message, you can call
|
|
* `event.sender.sendTo(event.senderId, ...)` to reply to the message, see
|
|
* ipcRenderer.sendTo for more information. This only applies to messages sent from
|
|
* a different renderer. Messages sent directly from the main process set
|
|
* `event.senderId` to `0`.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
senderId: number;
|
|
/**
|
|
* Whether the message sent via ipcRenderer.sendTo was sent by the main frame. This
|
|
* is relevant when `nodeIntegrationInSubFrames` is enabled in the originating
|
|
* `webContents`.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
senderIsMainFrame?: boolean;
|
|
}
|
|
|
|
interface JumpListCategory {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/jump-list-category
|
|
|
|
/**
|
|
* Array of `JumpListItem` objects if `type` is `tasks` or `custom`, otherwise it
|
|
* should be omitted.
|
|
*/
|
|
items?: JumpListItem[];
|
|
/**
|
|
* Must be set if `type` is `custom`, otherwise it should be omitted.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* One of the following:
|
|
*/
|
|
type?: ('tasks' | 'frequent' | 'recent' | 'custom');
|
|
}
|
|
|
|
interface JumpListItem {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/jump-list-item
|
|
|
|
/**
|
|
* The command line arguments when `program` is executed. Should only be set if
|
|
* `type` is `task`.
|
|
*/
|
|
args?: string;
|
|
/**
|
|
* Description of the task (displayed in a tooltip). Should only be set if `type`
|
|
* is `task`. Maximum length 260 characters.
|
|
*/
|
|
description?: string;
|
|
/**
|
|
* The index of the icon in the resource file. If a resource file contains multiple
|
|
* icons this value can be used to specify the zero-based index of the icon that
|
|
* should be displayed for this task. If a resource file contains only one icon,
|
|
* this property should be set to zero.
|
|
*/
|
|
iconIndex?: number;
|
|
/**
|
|
* The absolute path to an icon to be displayed in a Jump List, which can be an
|
|
* arbitrary resource file that contains an icon (e.g. `.ico`, `.exe`, `.dll`). You
|
|
* can usually specify `process.execPath` to show the program icon.
|
|
*/
|
|
iconPath?: string;
|
|
/**
|
|
* Path of the file to open, should only be set if `type` is `file`.
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* Path of the program to execute, usually you should specify `process.execPath`
|
|
* which opens the current program. Should only be set if `type` is `task`.
|
|
*/
|
|
program?: string;
|
|
/**
|
|
* The text to be displayed for the item in the Jump List. Should only be set if
|
|
* `type` is `task`.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* One of the following:
|
|
*/
|
|
type?: ('task' | 'separator' | 'file');
|
|
/**
|
|
* The working directory. Default is empty.
|
|
*/
|
|
workingDirectory?: string;
|
|
}
|
|
|
|
interface KeyboardEvent {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/keyboard-event
|
|
|
|
/**
|
|
* whether an Alt key was used in an accelerator to trigger the Event
|
|
*/
|
|
altKey?: boolean;
|
|
/**
|
|
* whether the Control key was used in an accelerator to trigger the Event
|
|
*/
|
|
ctrlKey?: boolean;
|
|
/**
|
|
* whether a meta key was used in an accelerator to trigger the Event
|
|
*/
|
|
metaKey?: boolean;
|
|
/**
|
|
* whether a Shift key was used in an accelerator to trigger the Event
|
|
*/
|
|
shiftKey?: boolean;
|
|
/**
|
|
* whether an accelerator was used to trigger the event as opposed to another user
|
|
* gesture like mouse click
|
|
*/
|
|
triggeredByAccelerator?: boolean;
|
|
}
|
|
|
|
interface KeyboardInputEvent extends InputEvent {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/keyboard-input-event
|
|
|
|
/**
|
|
* The character that will be sent as the keyboard event. Should only use the valid
|
|
* key codes in Accelerator.
|
|
*/
|
|
keyCode: string;
|
|
/**
|
|
* The type of the event, can be `rawKeyDown`, `keyDown`, `keyUp` or `char`.
|
|
*/
|
|
type: ('rawKeyDown' | 'keyDown' | 'keyUp' | 'char');
|
|
}
|
|
|
|
interface MemoryInfo {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/memory-info
|
|
|
|
/**
|
|
* The maximum amount of memory that has ever been pinned to actual physical RAM.
|
|
*/
|
|
peakWorkingSetSize: number;
|
|
/**
|
|
* The amount of memory not shared by other processes, such as JS heap or HTML
|
|
* content.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
privateBytes?: number;
|
|
/**
|
|
* The amount of memory currently pinned to actual physical RAM.
|
|
*/
|
|
workingSetSize: number;
|
|
}
|
|
|
|
interface MemoryUsageDetails {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/memory-usage-details
|
|
|
|
count: number;
|
|
liveSize: number;
|
|
size: number;
|
|
}
|
|
|
|
class Menu extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/menu
|
|
|
|
/**
|
|
* Emitted when a popup is closed either manually or with `menu.closePopup()`.
|
|
*/
|
|
on(event: 'menu-will-close', listener: (event: Event) => void): this;
|
|
once(event: 'menu-will-close', listener: (event: Event) => void): this;
|
|
addListener(event: 'menu-will-close', listener: (event: Event) => void): this;
|
|
removeListener(event: 'menu-will-close', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when `menu.popup()` is called.
|
|
*/
|
|
on(event: 'menu-will-show', listener: (event: Event) => void): this;
|
|
once(event: 'menu-will-show', listener: (event: Event) => void): this;
|
|
addListener(event: 'menu-will-show', listener: (event: Event) => void): this;
|
|
removeListener(event: 'menu-will-show', listener: (event: Event) => void): this;
|
|
/**
|
|
* Menu
|
|
*/
|
|
constructor();
|
|
/**
|
|
* Generally, the `template` is an array of `options` for constructing a MenuItem.
|
|
* The usage can be referenced above.
|
|
*
|
|
* You can also attach other fields to the element of the `template` and they will
|
|
* become properties of the constructed menu items.
|
|
*/
|
|
static buildFromTemplate(template: Array<(MenuItemConstructorOptions) | (MenuItem)>): Menu;
|
|
/**
|
|
* The application menu, if set, or `null`, if not set.
|
|
*
|
|
* **Note:** The returned `Menu` instance doesn't support dynamic addition or
|
|
* removal of menu items. Instance properties can still be dynamically modified.
|
|
*/
|
|
static getApplicationMenu(): (Menu) | (null);
|
|
/**
|
|
* Sends the `action` to the first responder of application. This is used for
|
|
* emulating default macOS menu behaviors. Usually you would use the `role`
|
|
* property of a `MenuItem`.
|
|
*
|
|
* See the macOS Cocoa Event Handling Guide for more information on macOS' native
|
|
* actions.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
static sendActionToFirstResponder(action: string): void;
|
|
/**
|
|
* Sets `menu` as the application menu on macOS. On Windows and Linux, the `menu`
|
|
* will be set as each window's top menu.
|
|
*
|
|
* Also on Windows and Linux, you can use a `&` in the top-level item name to
|
|
* indicate which letter should get a generated accelerator. For example, using
|
|
* `&File` for the file menu would result in a generated `Alt-F` accelerator that
|
|
* opens the associated menu. The indicated character in the button label then gets
|
|
* an underline, and the `&` character is not displayed on the button label.
|
|
*
|
|
* In order to escape the `&` character in an item name, add a proceeding `&`. For
|
|
* example, `&&File` would result in `&File` displayed on the button label.
|
|
*
|
|
* Passing `null` will suppress the default menu. On Windows and Linux, this has
|
|
* the additional effect of removing the menu bar from the window.
|
|
*
|
|
* **Note:** The default menu will be created automatically if the app does not set
|
|
* one. It contains standard items such as `File`, `Edit`, `View`, `Window` and
|
|
* `Help`.
|
|
*/
|
|
static setApplicationMenu(menu: (Menu) | (null)): void;
|
|
/**
|
|
* Appends the `menuItem` to the menu.
|
|
*/
|
|
append(menuItem: MenuItem): void;
|
|
/**
|
|
* Closes the context menu in the `browserWindow`.
|
|
*/
|
|
closePopup(browserWindow?: BrowserWindow): void;
|
|
/**
|
|
* the item with the specified `id`
|
|
*/
|
|
getMenuItemById(id: string): (MenuItem) | (null);
|
|
/**
|
|
* Inserts the `menuItem` to the `pos` position of the menu.
|
|
*/
|
|
insert(pos: number, menuItem: MenuItem): void;
|
|
/**
|
|
* Pops up this menu as a context menu in the `BrowserWindow`.
|
|
*/
|
|
popup(options?: PopupOptions): void;
|
|
/**
|
|
* A `MenuItem[]` array containing the menu's items.
|
|
*
|
|
* Each `Menu` consists of multiple `MenuItem`s and each `MenuItem` can have a
|
|
* submenu.
|
|
*/
|
|
items: MenuItem[];
|
|
}
|
|
|
|
class MenuItem {
|
|
|
|
// Docs: https://electronjs.org/docs/api/menu-item
|
|
|
|
/**
|
|
* MenuItem
|
|
*/
|
|
constructor(options: MenuItemConstructorOptions);
|
|
/**
|
|
* An `Accelerator` (optional) indicating the item's accelerator, if set.
|
|
*/
|
|
accelerator?: Accelerator;
|
|
/**
|
|
* A `boolean` indicating whether the item is checked, this property can be
|
|
* dynamically changed.
|
|
*
|
|
* A `checkbox` menu item will toggle the `checked` property on and off when
|
|
* selected.
|
|
*
|
|
* A `radio` menu item will turn on its `checked` property when clicked, and will
|
|
* turn off that property for all adjacent items in the same menu.
|
|
*
|
|
* You can add a `click` function for additional behavior.
|
|
*/
|
|
checked: boolean;
|
|
/**
|
|
* A `Function` that is fired when the MenuItem receives a click event. It can be
|
|
* called with `menuItem.click(event, focusedWindow, focusedWebContents)`.
|
|
*
|
|
* * `event` KeyboardEvent
|
|
* * `focusedWindow` BrowserWindow
|
|
* * `focusedWebContents` WebContents
|
|
*/
|
|
click: Function;
|
|
/**
|
|
* A `number` indicating an item's sequential unique id.
|
|
*/
|
|
commandId: number;
|
|
/**
|
|
* A `boolean` indicating whether the item is enabled, this property can be
|
|
* dynamically changed.
|
|
*/
|
|
enabled: boolean;
|
|
/**
|
|
* A `NativeImage | string` (optional) indicating the item's icon, if set.
|
|
*/
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* A `string` indicating the item's unique id, this property can be dynamically
|
|
* changed.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* A `string` indicating the item's visible label.
|
|
*/
|
|
label: string;
|
|
/**
|
|
* A `Menu` that the item is a part of.
|
|
*/
|
|
menu: Menu;
|
|
/**
|
|
* A `boolean` indicating if the accelerator should be registered with the system
|
|
* or just displayed.
|
|
*
|
|
* This property can be dynamically changed.
|
|
*/
|
|
registerAccelerator: boolean;
|
|
/**
|
|
* A `string` (optional) indicating the item's role, if set. Can be `undo`, `redo`,
|
|
* `cut`, `copy`, `paste`, `pasteAndMatchStyle`, `delete`, `selectAll`, `reload`,
|
|
* `forceReload`, `toggleDevTools`, `resetZoom`, `zoomIn`, `zoomOut`,
|
|
* `toggleSpellChecker`, `togglefullscreen`, `window`, `minimize`, `close`, `help`,
|
|
* `about`, `services`, `hide`, `hideOthers`, `unhide`, `quit`, `startSpeaking`,
|
|
* `stopSpeaking`, `zoom`, `front`, `appMenu`, `fileMenu`, `editMenu`, `viewMenu`,
|
|
* `shareMenu`, `recentDocuments`, `toggleTabBar`, `selectNextTab`,
|
|
* `selectPreviousTab`, `showAllTabs`, `mergeAllWindows`, `clearRecentDocuments`,
|
|
* `moveTabToNewWindow` or `windowMenu`
|
|
*/
|
|
role?: ('undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'pasteAndMatchStyle' | 'delete' | 'selectAll' | 'reload' | 'forceReload' | 'toggleDevTools' | 'resetZoom' | 'zoomIn' | 'zoomOut' | 'toggleSpellChecker' | 'togglefullscreen' | 'window' | 'minimize' | 'close' | 'help' | 'about' | 'services' | 'hide' | 'hideOthers' | 'unhide' | 'quit' | 'startSpeaking' | 'stopSpeaking' | 'zoom' | 'front' | 'appMenu' | 'fileMenu' | 'editMenu' | 'viewMenu' | 'shareMenu' | 'recentDocuments' | 'toggleTabBar' | 'selectNextTab' | 'selectPreviousTab' | 'showAllTabs' | 'mergeAllWindows' | 'clearRecentDocuments' | 'moveTabToNewWindow' | 'windowMenu');
|
|
/**
|
|
* A `SharingItem` indicating the item to share when the `role` is `shareMenu`.
|
|
*
|
|
* This property can be dynamically changed.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
sharingItem: SharingItem;
|
|
/**
|
|
* A `string` indicating the item's sublabel.
|
|
*/
|
|
sublabel: string;
|
|
/**
|
|
* A `Menu` (optional) containing the menu item's submenu, if present.
|
|
*/
|
|
submenu?: Menu;
|
|
/**
|
|
* A `string` indicating the item's hover text.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
toolTip: string;
|
|
/**
|
|
* A `string` indicating the type of the item. Can be `normal`, `separator`,
|
|
* `submenu`, `checkbox` or `radio`.
|
|
*/
|
|
type: ('normal' | 'separator' | 'submenu' | 'checkbox' | 'radio');
|
|
/**
|
|
* An `Accelerator | null` indicating the item's user-assigned accelerator for the
|
|
* menu item.
|
|
*
|
|
* **Note:** This property is only initialized after the `MenuItem` has been added
|
|
* to a `Menu`. Either via `Menu.buildFromTemplate` or via
|
|
* `Menu.append()/insert()`. Accessing before initialization will just return
|
|
* `null`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
readonly userAccelerator: (Accelerator) | (null);
|
|
/**
|
|
* A `boolean` indicating whether the item is visible, this property can be
|
|
* dynamically changed.
|
|
*/
|
|
visible: boolean;
|
|
}
|
|
|
|
class MessageChannelMain extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/message-channel-main
|
|
|
|
/**
|
|
* A `MessagePortMain` property.
|
|
*/
|
|
port1: MessagePortMain;
|
|
/**
|
|
* A `MessagePortMain` property.
|
|
*/
|
|
port2: MessagePortMain;
|
|
}
|
|
|
|
class MessagePortMain extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/message-port-main
|
|
|
|
/**
|
|
* Emitted when the remote end of a MessagePortMain object becomes disconnected.
|
|
*/
|
|
on(event: 'close', listener: Function): this;
|
|
once(event: 'close', listener: Function): this;
|
|
addListener(event: 'close', listener: Function): this;
|
|
removeListener(event: 'close', listener: Function): this;
|
|
/**
|
|
* Emitted when a MessagePortMain object receives a message.
|
|
*/
|
|
on(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
once(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
addListener(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
removeListener(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
/**
|
|
* Disconnects the port, so it is no longer active.
|
|
*/
|
|
close(): void;
|
|
/**
|
|
* Sends a message from the port, and optionally, transfers ownership of objects to
|
|
* other browsing contexts.
|
|
*/
|
|
postMessage(message: any, transfer?: MessagePortMain[]): void;
|
|
/**
|
|
* Starts the sending of messages queued on the port. Messages will be queued until
|
|
* this method is called.
|
|
*/
|
|
start(): void;
|
|
}
|
|
|
|
interface MimeTypedBuffer {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/mime-typed-buffer
|
|
|
|
/**
|
|
* Charset of the buffer.
|
|
*/
|
|
charset?: string;
|
|
/**
|
|
* The actual Buffer content.
|
|
*/
|
|
data: Buffer;
|
|
/**
|
|
* MIME type of the buffer.
|
|
*/
|
|
mimeType?: string;
|
|
}
|
|
|
|
interface MouseInputEvent extends InputEvent {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/mouse-input-event
|
|
|
|
/**
|
|
* The button pressed, can be `left`, `middle`, `right`.
|
|
*/
|
|
button?: ('left' | 'middle' | 'right');
|
|
clickCount?: number;
|
|
globalX?: number;
|
|
globalY?: number;
|
|
movementX?: number;
|
|
movementY?: number;
|
|
/**
|
|
* The type of the event, can be `mouseDown`, `mouseUp`, `mouseEnter`,
|
|
* `mouseLeave`, `contextMenu`, `mouseWheel` or `mouseMove`.
|
|
*/
|
|
type: ('mouseDown' | 'mouseUp' | 'mouseEnter' | 'mouseLeave' | 'contextMenu' | 'mouseWheel' | 'mouseMove');
|
|
x: number;
|
|
y: number;
|
|
}
|
|
|
|
interface MouseWheelInputEvent extends MouseInputEvent {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/mouse-wheel-input-event
|
|
|
|
accelerationRatioX?: number;
|
|
accelerationRatioY?: number;
|
|
canScroll?: boolean;
|
|
deltaX?: number;
|
|
deltaY?: number;
|
|
hasPreciseScrollingDeltas?: boolean;
|
|
/**
|
|
* The type of the event, can be `mouseWheel`.
|
|
*/
|
|
type: ('mouseWheel');
|
|
wheelTicksX?: number;
|
|
wheelTicksY?: number;
|
|
}
|
|
|
|
class NativeImage {
|
|
|
|
// Docs: https://electronjs.org/docs/api/native-image
|
|
|
|
/**
|
|
* Creates an empty `NativeImage` instance.
|
|
*/
|
|
static createEmpty(): NativeImage;
|
|
/**
|
|
* Creates a new `NativeImage` instance from `buffer` that contains the raw bitmap
|
|
* pixel data returned by `toBitmap()`. The specific format is platform-dependent.
|
|
*/
|
|
static createFromBitmap(buffer: Buffer, options: CreateFromBitmapOptions): NativeImage;
|
|
/**
|
|
* Creates a new `NativeImage` instance from `buffer`. Tries to decode as PNG or
|
|
* JPEG first.
|
|
*/
|
|
static createFromBuffer(buffer: Buffer, options?: CreateFromBufferOptions): NativeImage;
|
|
/**
|
|
* Creates a new `NativeImage` instance from `dataURL`.
|
|
*/
|
|
static createFromDataURL(dataURL: string): NativeImage;
|
|
/**
|
|
* Creates a new `NativeImage` instance from the NSImage that maps to the given
|
|
* image name. See `System Icons` for a list of possible values.
|
|
*
|
|
* The `hslShift` is applied to the image with the following rules:
|
|
*
|
|
* * `hsl_shift[0]` (hue): The absolute hue value for the image - 0 and 1 map to 0
|
|
* and 360 on the hue color wheel (red).
|
|
* * `hsl_shift[1]` (saturation): A saturation shift for the image, with the
|
|
* following key values: 0 = remove all color. 0.5 = leave unchanged. 1 = fully
|
|
* saturate the image.
|
|
* * `hsl_shift[2]` (lightness): A lightness shift for the image, with the
|
|
* following key values: 0 = remove all lightness (make all pixels black). 0.5 =
|
|
* leave unchanged. 1 = full lightness (make all pixels white).
|
|
*
|
|
* This means that `[-1, 0, 1]` will make the image completely white and `[-1, 1,
|
|
* 0]` will make the image completely black.
|
|
*
|
|
* In some cases, the `NSImageName` doesn't match its string representation; one
|
|
* example of this is `NSFolderImageName`, whose string representation would
|
|
* actually be `NSFolder`. Therefore, you'll need to determine the correct string
|
|
* representation for your image before passing it in. This can be done with the
|
|
* following:
|
|
*
|
|
* `echo -e '#import <Cocoa/Cocoa.h>\nint main() { NSLog(@"%@", SYSTEM_IMAGE_NAME);
|
|
* }' | clang -otest -x objective-c -framework Cocoa - && ./test`
|
|
*
|
|
* where `SYSTEM_IMAGE_NAME` should be replaced with any value from this list.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
static createFromNamedImage(imageName: string, hslShift?: number[]): NativeImage;
|
|
/**
|
|
* Creates a new `NativeImage` instance from a file located at `path`. This method
|
|
* returns an empty image if the `path` does not exist, cannot be read, or is not a
|
|
* valid image.
|
|
*/
|
|
static createFromPath(path: string): NativeImage;
|
|
/**
|
|
* fulfilled with the file's thumbnail preview image, which is a NativeImage.
|
|
*
|
|
* Note: The Windows implementation will ignore `size.height` and scale the height
|
|
* according to `size.width`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
static createThumbnailFromPath(path: string, size: Size): Promise<Electron.NativeImage>;
|
|
/**
|
|
* Add an image representation for a specific scale factor. This can be used to
|
|
* explicitly add different scale factor representations to an image. This can be
|
|
* called on empty images.
|
|
*/
|
|
addRepresentation(options: AddRepresentationOptions): void;
|
|
/**
|
|
* The cropped image.
|
|
*/
|
|
crop(rect: Rectangle): NativeImage;
|
|
/**
|
|
* The image's aspect ratio.
|
|
*
|
|
* If `scaleFactor` is passed, this will return the aspect ratio corresponding to
|
|
* the image representation most closely matching the passed value.
|
|
*/
|
|
getAspectRatio(scaleFactor?: number): number;
|
|
/**
|
|
* A Buffer that contains the image's raw bitmap pixel data.
|
|
*
|
|
* The difference between `getBitmap()` and `toBitmap()` is that `getBitmap()` does
|
|
* not copy the bitmap data, so you have to use the returned Buffer immediately in
|
|
* current event loop tick; otherwise the data might be changed or destroyed.
|
|
*/
|
|
getBitmap(options?: BitmapOptions): Buffer;
|
|
/**
|
|
* A Buffer that stores C pointer to underlying native handle of the image. On
|
|
* macOS, a pointer to `NSImage` instance would be returned.
|
|
*
|
|
* Notice that the returned pointer is a weak pointer to the underlying native
|
|
* image instead of a copy, so you _must_ ensure that the associated `nativeImage`
|
|
* instance is kept around.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getNativeHandle(): Buffer;
|
|
/**
|
|
* An array of all scale factors corresponding to representations for a given
|
|
* nativeImage.
|
|
*/
|
|
getScaleFactors(): number[];
|
|
/**
|
|
* If `scaleFactor` is passed, this will return the size corresponding to the image
|
|
* representation most closely matching the passed value.
|
|
*/
|
|
getSize(scaleFactor?: number): Size;
|
|
/**
|
|
* Whether the image is empty.
|
|
*/
|
|
isEmpty(): boolean;
|
|
/**
|
|
* Whether the image is a template image.
|
|
*/
|
|
isTemplateImage(): boolean;
|
|
/**
|
|
* The resized image.
|
|
*
|
|
* If only the `height` or the `width` are specified then the current aspect ratio
|
|
* will be preserved in the resized image.
|
|
*/
|
|
resize(options: ResizeOptions): NativeImage;
|
|
/**
|
|
* Marks the image as a template image.
|
|
*/
|
|
setTemplateImage(option: boolean): void;
|
|
/**
|
|
* A Buffer that contains a copy of the image's raw bitmap pixel data.
|
|
*/
|
|
toBitmap(options?: ToBitmapOptions): Buffer;
|
|
/**
|
|
* The data URL of the image.
|
|
*/
|
|
toDataURL(options?: ToDataURLOptions): string;
|
|
/**
|
|
* A Buffer that contains the image's `JPEG` encoded data.
|
|
*/
|
|
toJPEG(quality: number): Buffer;
|
|
/**
|
|
* A Buffer that contains the image's `PNG` encoded data.
|
|
*/
|
|
toPNG(options?: ToPNGOptions): Buffer;
|
|
/**
|
|
* A `boolean` property that determines whether the image is considered a template
|
|
* image.
|
|
*
|
|
* Please note that this property only has an effect on macOS.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isMacTemplateImage: boolean;
|
|
}
|
|
|
|
interface NativeTheme extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/native-theme
|
|
|
|
/**
|
|
* Emitted when something in the underlying NativeTheme has changed. This normally
|
|
* means that either the value of `shouldUseDarkColors`,
|
|
* `shouldUseHighContrastColors` or `shouldUseInvertedColorScheme` has changed. You
|
|
* will have to check them to determine which one has changed.
|
|
*/
|
|
on(event: 'updated', listener: Function): this;
|
|
once(event: 'updated', listener: Function): this;
|
|
addListener(event: 'updated', listener: Function): this;
|
|
removeListener(event: 'updated', listener: Function): this;
|
|
/**
|
|
* A `boolean` indicating whether Chromium is in forced colors mode, controlled by
|
|
* system accessibility settings. Currently, Windows high contrast is the only
|
|
* system setting that triggers forced colors mode.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
readonly inForcedColorsMode: boolean;
|
|
/**
|
|
* A `boolean` for if the OS / Chromium currently has a dark mode enabled or is
|
|
* being instructed to show a dark-style UI. If you want to modify this value you
|
|
* should use `themeSource` below.
|
|
*
|
|
*/
|
|
readonly shouldUseDarkColors: boolean;
|
|
/**
|
|
* A `boolean` for if the OS / Chromium currently has high-contrast mode enabled or
|
|
* is being instructed to show a high-contrast UI.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
readonly shouldUseHighContrastColors: boolean;
|
|
/**
|
|
* A `boolean` for if the OS / Chromium currently has an inverted color scheme or
|
|
* is being instructed to use an inverted color scheme.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
readonly shouldUseInvertedColorScheme: boolean;
|
|
/**
|
|
* A `string` property that can be `system`, `light` or `dark`. It is used to
|
|
* override and supersede the value that Chromium has chosen to use internally.
|
|
*
|
|
* Setting this property to `system` will remove the override and everything will
|
|
* be reset to the OS default. By default `themeSource` is `system`.
|
|
*
|
|
* Settings this property to `dark` will have the following effects:
|
|
*
|
|
* * `nativeTheme.shouldUseDarkColors` will be `true` when accessed
|
|
* * Any UI Electron renders on Linux and Windows including context menus,
|
|
* devtools, etc. will use the dark UI.
|
|
* * Any UI the OS renders on macOS including menus, window frames, etc. will use
|
|
* the dark UI.
|
|
* * The `prefers-color-scheme` CSS query will match `dark` mode.
|
|
* * The `updated` event will be emitted
|
|
*
|
|
* Settings this property to `light` will have the following effects:
|
|
*
|
|
* * `nativeTheme.shouldUseDarkColors` will be `false` when accessed
|
|
* * Any UI Electron renders on Linux and Windows including context menus,
|
|
* devtools, etc. will use the light UI.
|
|
* * Any UI the OS renders on macOS including menus, window frames, etc. will use
|
|
* the light UI.
|
|
* * The `prefers-color-scheme` CSS query will match `light` mode.
|
|
* * The `updated` event will be emitted
|
|
*
|
|
* The usage of this property should align with a classic "dark mode" state machine
|
|
* in your application where the user has three options.
|
|
*
|
|
* * `Follow OS` --> `themeSource = 'system'`
|
|
* * `Dark Mode` --> `themeSource = 'dark'`
|
|
* * `Light Mode` --> `themeSource = 'light'`
|
|
*
|
|
* Your application should then always use `shouldUseDarkColors` to determine what
|
|
* CSS to apply.
|
|
*/
|
|
themeSource: ('system' | 'light' | 'dark');
|
|
}
|
|
|
|
interface Net {
|
|
|
|
// Docs: https://electronjs.org/docs/api/net
|
|
|
|
/**
|
|
* see Response.
|
|
*
|
|
* Sends a request, similarly to how `fetch()` works in the renderer, using
|
|
* Chrome's network stack. This differs from Node's `fetch()`, which uses Node.js's
|
|
* HTTP stack.
|
|
*
|
|
* Example:
|
|
*
|
|
* This method will issue requests from the default session. To send a `fetch`
|
|
* request from another session, use ses.fetch().
|
|
*
|
|
* See the MDN documentation for `fetch()` for more details.
|
|
*
|
|
* Limitations:
|
|
*
|
|
* * `net.fetch()` does not support the `data:` or `blob:` schemes.
|
|
* * The value of the `integrity` option is ignored.
|
|
* * The `.type` and `.url` values of the returned `Response` object are incorrect.
|
|
*
|
|
* By default, requests made with `net.fetch` can be made to custom protocols as
|
|
* well as `file:`, and will trigger webRequest handlers if present. When the
|
|
* non-standard `bypassCustomProtocolHandlers` option is set in RequestInit, custom
|
|
* protocol handlers will not be called for this request. This allows forwarding an
|
|
* intercepted request to the built-in handler. webRequest handlers will still be
|
|
* triggered when bypassing custom protocols.
|
|
*/
|
|
fetch(input: (string) | (GlobalRequest), init?: RequestInit & { bypassCustomProtocolHandlers?: boolean }): Promise<GlobalResponse>;
|
|
/**
|
|
* Whether there is currently internet connection.
|
|
*
|
|
* A return value of `false` is a pretty strong indicator that the user won't be
|
|
* able to connect to remote sites. However, a return value of `true` is
|
|
* inconclusive; even if some link is up, it is uncertain whether a particular
|
|
* connection attempt to a particular remote site will be successful.
|
|
*/
|
|
isOnline(): boolean;
|
|
/**
|
|
* Creates a `ClientRequest` instance using the provided `options` which are
|
|
* directly forwarded to the `ClientRequest` constructor. The `net.request` method
|
|
* would be used to issue both secure and insecure HTTP requests according to the
|
|
* specified protocol scheme in the `options` object.
|
|
*/
|
|
request(options: (ClientRequestConstructorOptions) | (string)): ClientRequest;
|
|
/**
|
|
* Resolves with the resolved IP addresses for the `host`.
|
|
*
|
|
* This method will resolve hosts from the default session. To resolve a host from
|
|
* another session, use ses.resolveHost().
|
|
*/
|
|
resolveHost(host: string, options?: ResolveHostOptions): Promise<Electron.ResolvedHost>;
|
|
/**
|
|
* A `boolean` property. Whether there is currently internet connection.
|
|
*
|
|
* A return value of `false` is a pretty strong indicator that the user won't be
|
|
* able to connect to remote sites. However, a return value of `true` is
|
|
* inconclusive; even if some link is up, it is uncertain whether a particular
|
|
* connection attempt to a particular remote site will be successful.
|
|
*
|
|
*/
|
|
readonly online: boolean;
|
|
}
|
|
|
|
interface NetLog {
|
|
|
|
// Docs: https://electronjs.org/docs/api/net-log
|
|
|
|
/**
|
|
* resolves when the net log has begun recording.
|
|
*
|
|
* Starts recording network events to `path`.
|
|
*/
|
|
startLogging(path: string, options?: StartLoggingOptions): Promise<void>;
|
|
/**
|
|
* resolves when the net log has been flushed to disk.
|
|
*
|
|
* Stops recording network events. If not called, net logging will automatically
|
|
* end when app quits.
|
|
*/
|
|
stopLogging(): Promise<void>;
|
|
/**
|
|
* A `boolean` property that indicates whether network logs are currently being
|
|
* recorded.
|
|
*
|
|
*/
|
|
readonly currentlyLogging: boolean;
|
|
}
|
|
|
|
class Notification extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/notification
|
|
|
|
/**
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'action', listener: (event: Event,
|
|
/**
|
|
* The index of the action that was activated.
|
|
*/
|
|
index: number) => void): this;
|
|
once(event: 'action', listener: (event: Event,
|
|
/**
|
|
* The index of the action that was activated.
|
|
*/
|
|
index: number) => void): this;
|
|
addListener(event: 'action', listener: (event: Event,
|
|
/**
|
|
* The index of the action that was activated.
|
|
*/
|
|
index: number) => void): this;
|
|
removeListener(event: 'action', listener: (event: Event,
|
|
/**
|
|
* The index of the action that was activated.
|
|
*/
|
|
index: number) => void): this;
|
|
/**
|
|
* Emitted when the notification is clicked by the user.
|
|
*/
|
|
on(event: 'click', listener: (event: Event) => void): this;
|
|
once(event: 'click', listener: (event: Event) => void): this;
|
|
addListener(event: 'click', listener: (event: Event) => void): this;
|
|
removeListener(event: 'click', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when the notification is closed by manual intervention from the user.
|
|
*
|
|
* This event is not guaranteed to be emitted in all cases where the notification
|
|
* is closed.
|
|
*
|
|
* On Windows, the `close` event can be emitted in one of three ways: programmatic
|
|
* dismissal with `notification.close()`, by the user closing the notification, or
|
|
* via system timeout. If a notification is in the Action Center after the initial
|
|
* `close` event is emitted, a call to `notification.close()` will remove the
|
|
* notification from the action center but the `close` event will not be emitted
|
|
* again.
|
|
*/
|
|
on(event: 'close', listener: (event: Event) => void): this;
|
|
once(event: 'close', listener: (event: Event) => void): this;
|
|
addListener(event: 'close', listener: (event: Event) => void): this;
|
|
removeListener(event: 'close', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when an error is encountered while creating and showing the native
|
|
* notification.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
on(event: 'failed', listener: (event: Event,
|
|
/**
|
|
* The error encountered during execution of the `show()` method.
|
|
*/
|
|
error: string) => void): this;
|
|
once(event: 'failed', listener: (event: Event,
|
|
/**
|
|
* The error encountered during execution of the `show()` method.
|
|
*/
|
|
error: string) => void): this;
|
|
addListener(event: 'failed', listener: (event: Event,
|
|
/**
|
|
* The error encountered during execution of the `show()` method.
|
|
*/
|
|
error: string) => void): this;
|
|
removeListener(event: 'failed', listener: (event: Event,
|
|
/**
|
|
* The error encountered during execution of the `show()` method.
|
|
*/
|
|
error: string) => void): this;
|
|
/**
|
|
* Emitted when the user clicks the "Reply" button on a notification with
|
|
* `hasReply: true`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'reply', listener: (event: Event,
|
|
/**
|
|
* The string the user entered into the inline reply field.
|
|
*/
|
|
reply: string) => void): this;
|
|
once(event: 'reply', listener: (event: Event,
|
|
/**
|
|
* The string the user entered into the inline reply field.
|
|
*/
|
|
reply: string) => void): this;
|
|
addListener(event: 'reply', listener: (event: Event,
|
|
/**
|
|
* The string the user entered into the inline reply field.
|
|
*/
|
|
reply: string) => void): this;
|
|
removeListener(event: 'reply', listener: (event: Event,
|
|
/**
|
|
* The string the user entered into the inline reply field.
|
|
*/
|
|
reply: string) => void): this;
|
|
/**
|
|
* Emitted when the notification is shown to the user. Note that this event can be
|
|
* fired multiple times as a notification can be shown multiple times through the
|
|
* `show()` method.
|
|
*/
|
|
on(event: 'show', listener: (event: Event) => void): this;
|
|
once(event: 'show', listener: (event: Event) => void): this;
|
|
addListener(event: 'show', listener: (event: Event) => void): this;
|
|
removeListener(event: 'show', listener: (event: Event) => void): this;
|
|
/**
|
|
* Notification
|
|
*/
|
|
constructor(options?: NotificationConstructorOptions);
|
|
/**
|
|
* Whether or not desktop notifications are supported on the current system
|
|
*/
|
|
static isSupported(): boolean;
|
|
/**
|
|
* Dismisses the notification.
|
|
*
|
|
* On Windows, calling `notification.close()` while the notification is visible on
|
|
* screen will dismiss the notification and remove it from the Action Center. If
|
|
* `notification.close()` is called after the notification is no longer visible on
|
|
* screen, calling `notification.close()` will try remove it from the Action
|
|
* Center.
|
|
*/
|
|
close(): void;
|
|
/**
|
|
* Immediately shows the notification to the user. Unlike the web notification API,
|
|
* instantiating a `new Notification()` does not immediately show it to the user.
|
|
* Instead, you need to call this method before the OS will display it.
|
|
*
|
|
* If the notification has been shown before, this method will dismiss the
|
|
* previously shown notification and create a new one with identical properties.
|
|
*/
|
|
show(): void;
|
|
/**
|
|
* A `NotificationAction[]` property representing the actions of the notification.
|
|
*/
|
|
actions: NotificationAction[];
|
|
/**
|
|
* A `string` property representing the body of the notification.
|
|
*/
|
|
body: string;
|
|
/**
|
|
* A `string` property representing the close button text of the notification.
|
|
*/
|
|
closeButtonText: string;
|
|
/**
|
|
* A `boolean` property representing whether the notification has a reply action.
|
|
*/
|
|
hasReply: boolean;
|
|
/**
|
|
* A `string` property representing the reply placeholder of the notification.
|
|
*/
|
|
replyPlaceholder: string;
|
|
/**
|
|
* A `boolean` property representing whether the notification is silent.
|
|
*/
|
|
silent: boolean;
|
|
/**
|
|
* A `string` property representing the sound of the notification.
|
|
*/
|
|
sound: string;
|
|
/**
|
|
* A `string` property representing the subtitle of the notification.
|
|
*/
|
|
subtitle: string;
|
|
/**
|
|
* A `string` property representing the type of timeout duration for the
|
|
* notification. Can be 'default' or 'never'.
|
|
*
|
|
* If `timeoutType` is set to 'never', the notification never expires. It stays
|
|
* open until closed by the calling API or the user.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
timeoutType: ('default' | 'never');
|
|
/**
|
|
* A `string` property representing the title of the notification.
|
|
*/
|
|
title: string;
|
|
/**
|
|
* A `string` property representing the custom Toast XML of the notification.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
toastXml: string;
|
|
/**
|
|
* A `string` property representing the urgency level of the notification. Can be
|
|
* 'normal', 'critical', or 'low'.
|
|
*
|
|
* Default is 'low' - see NotifyUrgency for more information.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
urgency: ('normal' | 'critical' | 'low');
|
|
}
|
|
|
|
interface NotificationAction {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/notification-action
|
|
|
|
/**
|
|
* The label for the given action.
|
|
*/
|
|
text?: string;
|
|
/**
|
|
* The type of action, can be `button`.
|
|
*/
|
|
type: ('button');
|
|
}
|
|
|
|
interface NotificationResponse {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/notification-response
|
|
|
|
/**
|
|
* The identifier string of the action that the user selected.
|
|
*/
|
|
actionIdentifier: string;
|
|
/**
|
|
* The delivery date of the notification.
|
|
*/
|
|
date: number;
|
|
/**
|
|
* The unique identifier for this notification request.
|
|
*/
|
|
identifier: string;
|
|
/**
|
|
* A dictionary of custom information associated with the notification.
|
|
*/
|
|
userInfo: Record<string, any>;
|
|
/**
|
|
* The text entered or chosen by the user.
|
|
*/
|
|
userText?: string;
|
|
}
|
|
|
|
interface ParentPort extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/parent-port
|
|
|
|
/**
|
|
* Emitted when the process receives a message. Messages received on this port will
|
|
* be queued up until a handler is registered for this event.
|
|
*/
|
|
on(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
once(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
addListener(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
removeListener(event: 'message', listener: (messageEvent: MessageEvent) => void): this;
|
|
/**
|
|
* Sends a message from the process to its parent.
|
|
*/
|
|
postMessage(message: any): void;
|
|
}
|
|
|
|
interface PaymentDiscount {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/payment-discount
|
|
|
|
/**
|
|
* A string used to uniquely identify a discount offer for a product.
|
|
*/
|
|
identifier: string;
|
|
/**
|
|
* A string that identifies the key used to generate the signature.
|
|
*/
|
|
keyIdentifier: string;
|
|
/**
|
|
* A universally unique ID (UUID) value that you define.
|
|
*/
|
|
nonce: string;
|
|
/**
|
|
* A UTF-8 string representing the properties of a specific discount offer,
|
|
* cryptographically signed.
|
|
*/
|
|
signature: string;
|
|
/**
|
|
* The date and time of the signature's creation in milliseconds, formatted in Unix
|
|
* epoch time.
|
|
*/
|
|
timestamp: number;
|
|
}
|
|
|
|
interface Point {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/point
|
|
|
|
x: number;
|
|
y: number;
|
|
}
|
|
|
|
interface PostBody {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/post-body
|
|
|
|
/**
|
|
* The boundary used to separate multiple parts of the message. Only valid when
|
|
* `contentType` is `multipart/form-data`.
|
|
*/
|
|
boundary?: string;
|
|
/**
|
|
* The `content-type` header used for the data. One of
|
|
* `application/x-www-form-urlencoded` or `multipart/form-data`. Corresponds to the
|
|
* `enctype` attribute of the submitted HTML form.
|
|
*/
|
|
contentType: string;
|
|
/**
|
|
* The post data to be sent to the new window.
|
|
*/
|
|
data: Array<(UploadRawData) | (UploadFile)>;
|
|
}
|
|
|
|
interface PowerMonitor extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/power-monitor
|
|
|
|
/**
|
|
* Emitted when the system is about to lock the screen.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'lock-screen', listener: Function): this;
|
|
once(event: 'lock-screen', listener: Function): this;
|
|
addListener(event: 'lock-screen', listener: Function): this;
|
|
removeListener(event: 'lock-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when the system changes to AC power.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'on-ac', listener: Function): this;
|
|
once(event: 'on-ac', listener: Function): this;
|
|
addListener(event: 'on-ac', listener: Function): this;
|
|
removeListener(event: 'on-ac', listener: Function): this;
|
|
/**
|
|
* Emitted when system changes to battery power.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'on-battery', listener: Function): this;
|
|
once(event: 'on-battery', listener: Function): this;
|
|
addListener(event: 'on-battery', listener: Function): this;
|
|
removeListener(event: 'on-battery', listener: Function): this;
|
|
/**
|
|
* Emitted when system is resuming.
|
|
*/
|
|
on(event: 'resume', listener: Function): this;
|
|
once(event: 'resume', listener: Function): this;
|
|
addListener(event: 'resume', listener: Function): this;
|
|
removeListener(event: 'resume', listener: Function): this;
|
|
/**
|
|
* Emitted when the system is about to reboot or shut down. If the event handler
|
|
* invokes `e.preventDefault()`, Electron will attempt to delay system shutdown in
|
|
* order for the app to exit cleanly. If `e.preventDefault()` is called, the app
|
|
* should exit as soon as possible by calling something like `app.quit()`.
|
|
*
|
|
* @platform linux,darwin
|
|
*/
|
|
on(event: 'shutdown', listener: Function): this;
|
|
once(event: 'shutdown', listener: Function): this;
|
|
addListener(event: 'shutdown', listener: Function): this;
|
|
removeListener(event: 'shutdown', listener: Function): this;
|
|
/**
|
|
* Notification of a change in the operating system's advertised speed limit for
|
|
* CPUs, in percent. Values below 100 indicate that the system is impairing
|
|
* processing power due to thermal management.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'speed-limit-change', listener: Function): this;
|
|
once(event: 'speed-limit-change', listener: Function): this;
|
|
addListener(event: 'speed-limit-change', listener: Function): this;
|
|
removeListener(event: 'speed-limit-change', listener: Function): this;
|
|
/**
|
|
* Emitted when the system is suspending.
|
|
*/
|
|
on(event: 'suspend', listener: Function): this;
|
|
once(event: 'suspend', listener: Function): this;
|
|
addListener(event: 'suspend', listener: Function): this;
|
|
removeListener(event: 'suspend', listener: Function): this;
|
|
/**
|
|
* Emitted when the thermal state of the system changes. Notification of a change
|
|
* in the thermal status of the system, such as entering a critical temperature
|
|
* range. Depending on the severity, the system might take steps to reduce said
|
|
* temperature, for example, throttling the CPU or switching on the fans if
|
|
* available.
|
|
*
|
|
* Apps may react to the new state by reducing expensive computing tasks (e.g.
|
|
* video encoding), or notifying the user. The same state might be received
|
|
* repeatedly.
|
|
*
|
|
* See
|
|
* https://developer.apple.com/library/archive/documentation/Performance/Conceptual/power_efficiency_guidelines_osx/RespondToThermalStateChanges.html
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'thermal-state-change', listener: Function): this;
|
|
once(event: 'thermal-state-change', listener: Function): this;
|
|
addListener(event: 'thermal-state-change', listener: Function): this;
|
|
removeListener(event: 'thermal-state-change', listener: Function): this;
|
|
/**
|
|
* Emitted as soon as the systems screen is unlocked.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'unlock-screen', listener: Function): this;
|
|
once(event: 'unlock-screen', listener: Function): this;
|
|
addListener(event: 'unlock-screen', listener: Function): this;
|
|
removeListener(event: 'unlock-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when a login session is activated. See documentation for more
|
|
* information.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'user-did-become-active', listener: Function): this;
|
|
once(event: 'user-did-become-active', listener: Function): this;
|
|
addListener(event: 'user-did-become-active', listener: Function): this;
|
|
removeListener(event: 'user-did-become-active', listener: Function): this;
|
|
/**
|
|
* Emitted when a login session is deactivated. See documentation for more
|
|
* information.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'user-did-resign-active', listener: Function): this;
|
|
once(event: 'user-did-resign-active', listener: Function): this;
|
|
addListener(event: 'user-did-resign-active', listener: Function): this;
|
|
removeListener(event: 'user-did-resign-active', listener: Function): this;
|
|
/**
|
|
* The system's current thermal state. Can be `unknown`, `nominal`, `fair`,
|
|
* `serious`, or `critical`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getCurrentThermalState(): ('unknown' | 'nominal' | 'fair' | 'serious' | 'critical');
|
|
/**
|
|
* The system's current idle state. Can be `active`, `idle`, `locked` or `unknown`.
|
|
*
|
|
* Calculate the system idle state. `idleThreshold` is the amount of time (in
|
|
* seconds) before considered idle. `locked` is available on supported systems
|
|
* only.
|
|
*/
|
|
getSystemIdleState(idleThreshold: number): ('active' | 'idle' | 'locked' | 'unknown');
|
|
/**
|
|
* Idle time in seconds
|
|
*
|
|
* Calculate system idle time in seconds.
|
|
*/
|
|
getSystemIdleTime(): number;
|
|
/**
|
|
* Whether the system is on battery power.
|
|
*
|
|
* To monitor for changes in this property, use the `on-battery` and `on-ac`
|
|
* events.
|
|
*/
|
|
isOnBatteryPower(): boolean;
|
|
/**
|
|
* A `boolean` property. True if the system is on battery power.
|
|
*
|
|
* See `powerMonitor.isOnBatteryPower()`.
|
|
*/
|
|
onBatteryPower: boolean;
|
|
}
|
|
|
|
interface PowerSaveBlocker {
|
|
|
|
// Docs: https://electronjs.org/docs/api/power-save-blocker
|
|
|
|
/**
|
|
* Whether the corresponding `powerSaveBlocker` has started.
|
|
*/
|
|
isStarted(id: number): boolean;
|
|
/**
|
|
* The blocker ID that is assigned to this power blocker.
|
|
*
|
|
* Starts preventing the system from entering lower-power mode. Returns an integer
|
|
* identifying the power save blocker.
|
|
*
|
|
* **Note:** `prevent-display-sleep` has higher precedence over
|
|
* `prevent-app-suspension`. Only the highest precedence type takes effect. In
|
|
* other words, `prevent-display-sleep` always takes precedence over
|
|
* `prevent-app-suspension`.
|
|
*
|
|
* For example, an API calling A requests for `prevent-app-suspension`, and another
|
|
* calling B requests for `prevent-display-sleep`. `prevent-display-sleep` will be
|
|
* used until B stops its request. After that, `prevent-app-suspension` is used.
|
|
*/
|
|
start(type: 'prevent-app-suspension' | 'prevent-display-sleep'): number;
|
|
/**
|
|
* Stops the specified power save blocker.
|
|
*
|
|
* Whether the specified `powerSaveBlocker` has been stopped.
|
|
*/
|
|
stop(id: number): boolean;
|
|
}
|
|
|
|
interface PrinterInfo {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/printer-info
|
|
|
|
/**
|
|
* a longer description of the printer's type.
|
|
*/
|
|
description: string;
|
|
/**
|
|
* the name of the printer as shown in Print Preview.
|
|
*/
|
|
displayName: string;
|
|
/**
|
|
* whether or not a given printer is set as the default printer on the OS.
|
|
*/
|
|
isDefault: boolean;
|
|
/**
|
|
* the name of the printer as understood by the OS.
|
|
*/
|
|
name: string;
|
|
/**
|
|
* an object containing a variable number of platform-specific printer information.
|
|
*/
|
|
options: Options;
|
|
/**
|
|
* the current status of the printer.
|
|
*/
|
|
status: number;
|
|
}
|
|
|
|
interface ProcessMemoryInfo {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/process-memory-info
|
|
|
|
/**
|
|
* The amount of memory not shared by other processes, such as JS heap or HTML
|
|
* content in Kilobytes.
|
|
*/
|
|
private: number;
|
|
/**
|
|
* The amount of memory currently pinned to actual physical RAM in Kilobytes.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
residentSet: number;
|
|
/**
|
|
* The amount of memory shared between processes, typically memory consumed by the
|
|
* Electron code itself in Kilobytes.
|
|
*/
|
|
shared: number;
|
|
}
|
|
|
|
interface ProcessMetric {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/process-metric
|
|
|
|
/**
|
|
* CPU usage of the process.
|
|
*/
|
|
cpu: CPUUsage;
|
|
/**
|
|
* Creation time for this process. The time is represented as number of
|
|
* milliseconds since epoch. Since the `pid` can be reused after a process dies, it
|
|
* is useful to use both the `pid` and the `creationTime` to uniquely identify a
|
|
* process.
|
|
*/
|
|
creationTime: number;
|
|
/**
|
|
* One of the following values:
|
|
*
|
|
* @platform win32
|
|
*/
|
|
integrityLevel?: ('untrusted' | 'low' | 'medium' | 'high' | 'unknown');
|
|
/**
|
|
* Memory information for the process.
|
|
*/
|
|
memory: MemoryInfo;
|
|
/**
|
|
* The name of the process. Examples for utility: `Audio Service`, `Content
|
|
* Decryption Module Service`, `Network Service`, `Video Capture`, etc.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Process id of the process.
|
|
*/
|
|
pid: number;
|
|
/**
|
|
* Whether the process is sandboxed on OS level.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
sandboxed?: boolean;
|
|
/**
|
|
* The non-localized name of the process.
|
|
*/
|
|
serviceName?: string;
|
|
/**
|
|
* Process type. One of the following values:
|
|
*/
|
|
type: ('Browser' | 'Tab' | 'Utility' | 'Zygote' | 'Sandbox helper' | 'GPU' | 'Pepper Plugin' | 'Pepper Plugin Broker' | 'Unknown');
|
|
}
|
|
|
|
interface Product {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/product
|
|
|
|
/**
|
|
* 3 character code presenting a product's currency based on the ISO 4217 standard.
|
|
*/
|
|
currencyCode: string;
|
|
/**
|
|
* An array of discount offers
|
|
*/
|
|
discounts: ProductDiscount[];
|
|
/**
|
|
* The total size of the content, in bytes.
|
|
*/
|
|
downloadContentLengths: number[];
|
|
/**
|
|
* A string that identifies the version of the content.
|
|
*/
|
|
downloadContentVersion: string;
|
|
/**
|
|
* The locale formatted price of the product.
|
|
*/
|
|
formattedPrice: string;
|
|
/**
|
|
* The object containing introductory price information for the product. available
|
|
* for the product.
|
|
*/
|
|
introductoryPrice?: ProductDiscount;
|
|
/**
|
|
* A boolean value that indicates whether the App Store has downloadable content
|
|
* for this product. `true` if at least one file has been associated with the
|
|
* product.
|
|
*/
|
|
isDownloadable: boolean;
|
|
/**
|
|
* A description of the product.
|
|
*/
|
|
localizedDescription: string;
|
|
/**
|
|
* The name of the product.
|
|
*/
|
|
localizedTitle: string;
|
|
/**
|
|
* The cost of the product in the local currency.
|
|
*/
|
|
price: number;
|
|
/**
|
|
* The string that identifies the product to the Apple App Store.
|
|
*/
|
|
productIdentifier: string;
|
|
/**
|
|
* The identifier of the subscription group to which the subscription belongs.
|
|
*/
|
|
subscriptionGroupIdentifier: string;
|
|
/**
|
|
* The period details for products that are subscriptions.
|
|
*/
|
|
subscriptionPeriod?: ProductSubscriptionPeriod;
|
|
}
|
|
|
|
interface ProductDiscount {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/product-discount
|
|
|
|
/**
|
|
* A string used to uniquely identify a discount offer for a product.
|
|
*/
|
|
identifier: string;
|
|
/**
|
|
* An integer that indicates the number of periods the product discount is
|
|
* available.
|
|
*/
|
|
numberOfPeriods: number;
|
|
/**
|
|
* The payment mode for this product discount. Can be `payAsYouGo`, `payUpFront`,
|
|
* or `freeTrial`.
|
|
*/
|
|
paymentMode: ('payAsYouGo' | 'payUpFront' | 'freeTrial');
|
|
/**
|
|
* The discount price of the product in the local currency.
|
|
*/
|
|
price: number;
|
|
/**
|
|
* The locale used to format the discount price of the product.
|
|
*/
|
|
priceLocale: string;
|
|
/**
|
|
* An object that defines the period for the product discount.
|
|
*/
|
|
subscriptionPeriod?: ProductSubscriptionPeriod;
|
|
/**
|
|
* The type of discount offer.
|
|
*/
|
|
type: number;
|
|
}
|
|
|
|
interface ProductSubscriptionPeriod {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/product-subscription-period
|
|
|
|
/**
|
|
* The number of units per subscription period.
|
|
*/
|
|
numberOfUnits: number;
|
|
/**
|
|
* The increment of time that a subscription period is specified in. Can be `day`,
|
|
* `week`, `month`, `year`.
|
|
*/
|
|
unit: ('day' | 'week' | 'month' | 'year');
|
|
}
|
|
|
|
interface Protocol {
|
|
|
|
// Docs: https://electronjs.org/docs/api/protocol
|
|
|
|
/**
|
|
* Register a protocol handler for `scheme`. Requests made to URLs with this scheme
|
|
* will delegate to this handler to determine what response should be sent.
|
|
*
|
|
* Either a `Response` or a `Promise<Response>` can be returned.
|
|
*
|
|
* Example:
|
|
*
|
|
* See the MDN docs for `Request` and `Response` for more details.
|
|
*/
|
|
handle(scheme: string, handler: (request: GlobalRequest) => (GlobalResponse) | (Promise<GlobalResponse>)): void;
|
|
/**
|
|
* Whether the protocol was successfully intercepted
|
|
*
|
|
* Intercepts `scheme` protocol and uses `handler` as the protocol's new handler
|
|
* which sends a `Buffer` as a response.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
interceptBufferProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (Buffer) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully intercepted
|
|
*
|
|
* Intercepts `scheme` protocol and uses `handler` as the protocol's new handler
|
|
* which sends a file as a response.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
interceptFileProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (string) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully intercepted
|
|
*
|
|
* Intercepts `scheme` protocol and uses `handler` as the protocol's new handler
|
|
* which sends a new HTTP request as a response.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
interceptHttpProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: ProtocolResponse) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully intercepted
|
|
*
|
|
* Same as `protocol.registerStreamProtocol`, except that it replaces an existing
|
|
* protocol handler.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
interceptStreamProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (NodeJS.ReadableStream) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully intercepted
|
|
*
|
|
* Intercepts `scheme` protocol and uses `handler` as the protocol's new handler
|
|
* which sends a `string` as a response.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
interceptStringProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (string) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether `scheme` is already handled.
|
|
*/
|
|
isProtocolHandled(scheme: string): boolean;
|
|
/**
|
|
* Whether `scheme` is already intercepted.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
isProtocolIntercepted(scheme: string): boolean;
|
|
/**
|
|
* Whether `scheme` is already registered.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
isProtocolRegistered(scheme: string): boolean;
|
|
/**
|
|
* Whether the protocol was successfully registered
|
|
*
|
|
* Registers a protocol of `scheme` that will send a `Buffer` as a response.
|
|
*
|
|
* The usage is the same with `registerFileProtocol`, except that the `callback`
|
|
* should be called with either a `Buffer` object or an object that has the `data`
|
|
* property.
|
|
*
|
|
* Example:
|
|
*
|
|
* @deprecated
|
|
*/
|
|
registerBufferProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (Buffer) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully registered
|
|
*
|
|
* Registers a protocol of `scheme` that will send a file as the response. The
|
|
* `handler` will be called with `request` and `callback` where `request` is an
|
|
* incoming request for the `scheme`.
|
|
*
|
|
* To handle the `request`, the `callback` should be called with either the file's
|
|
* path or an object that has a `path` property, e.g. `callback(filePath)` or
|
|
* `callback({ path: filePath })`. The `filePath` must be an absolute path.
|
|
*
|
|
* By default the `scheme` is treated like `http:`, which is parsed differently
|
|
* from protocols that follow the "generic URI syntax" like `file:`.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
registerFileProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (string) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully registered
|
|
*
|
|
* Registers a protocol of `scheme` that will send an HTTP request as a response.
|
|
*
|
|
* The usage is the same with `registerFileProtocol`, except that the `callback`
|
|
* should be called with an object that has the `url` property.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
registerHttpProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: ProtocolResponse) => void) => void): boolean;
|
|
/**
|
|
* **Note:** This method can only be used before the `ready` event of the `app`
|
|
* module gets emitted and can be called only once.
|
|
*
|
|
* Registers the `scheme` as standard, secure, bypasses content security policy for
|
|
* resources, allows registering ServiceWorker, supports fetch API, and streaming
|
|
* video/audio. Specify a privilege with the value of `true` to enable the
|
|
* capability.
|
|
*
|
|
* An example of registering a privileged scheme, that bypasses Content Security
|
|
* Policy:
|
|
*
|
|
* A standard scheme adheres to what RFC 3986 calls generic URI syntax. For example
|
|
* `http` and `https` are standard schemes, while `file` is not.
|
|
*
|
|
* Registering a scheme as standard allows relative and absolute resources to be
|
|
* resolved correctly when served. Otherwise the scheme will behave like the `file`
|
|
* protocol, but without the ability to resolve relative URLs.
|
|
*
|
|
* For example when you load following page with custom protocol without
|
|
* registering it as standard scheme, the image will not be loaded because
|
|
* non-standard schemes can not recognize relative URLs:
|
|
*
|
|
* Registering a scheme as standard will allow access to files through the
|
|
* FileSystem API. Otherwise the renderer will throw a security error for the
|
|
* scheme.
|
|
*
|
|
* By default web storage apis (localStorage, sessionStorage, webSQL, indexedDB,
|
|
* cookies) are disabled for non standard schemes. So in general if you want to
|
|
* register a custom protocol to replace the `http` protocol, you have to register
|
|
* it as a standard scheme.
|
|
*
|
|
* Protocols that use streams (http and stream protocols) should set `stream:
|
|
* true`. The `<video>` and `<audio>` HTML elements expect protocols to buffer
|
|
* their responses by default. The `stream` flag configures those elements to
|
|
* correctly expect streaming responses.
|
|
*/
|
|
registerSchemesAsPrivileged(customSchemes: CustomScheme[]): void;
|
|
/**
|
|
* Whether the protocol was successfully registered
|
|
*
|
|
* Registers a protocol of `scheme` that will send a stream as a response.
|
|
*
|
|
* The usage is the same with `registerFileProtocol`, except that the `callback`
|
|
* should be called with either a `ReadableStream` object or an object that has the
|
|
* `data` property.
|
|
*
|
|
* Example:
|
|
*
|
|
* It is possible to pass any object that implements the readable stream API (emits
|
|
* `data`/`end`/`error` events). For example, here's how a file could be returned:
|
|
*
|
|
* @deprecated
|
|
*/
|
|
registerStreamProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (NodeJS.ReadableStream) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Whether the protocol was successfully registered
|
|
*
|
|
* Registers a protocol of `scheme` that will send a `string` as a response.
|
|
*
|
|
* The usage is the same with `registerFileProtocol`, except that the `callback`
|
|
* should be called with either a `string` or an object that has the `data`
|
|
* property.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
registerStringProtocol(scheme: string, handler: (request: ProtocolRequest, callback: (response: (string) | (ProtocolResponse)) => void) => void): boolean;
|
|
/**
|
|
* Removes a protocol handler registered with `protocol.handle`.
|
|
*/
|
|
unhandle(scheme: string): void;
|
|
/**
|
|
* Whether the protocol was successfully unintercepted
|
|
*
|
|
* Remove the interceptor installed for `scheme` and restore its original handler.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
uninterceptProtocol(scheme: string): boolean;
|
|
/**
|
|
* Whether the protocol was successfully unregistered
|
|
*
|
|
* Unregisters the custom protocol of `scheme`.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
unregisterProtocol(scheme: string): boolean;
|
|
}
|
|
|
|
interface ProtocolRequest {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/protocol-request
|
|
|
|
headers: Record<string, string>;
|
|
method: string;
|
|
referrer: string;
|
|
uploadData?: UploadData[];
|
|
url: string;
|
|
}
|
|
|
|
interface ProtocolResponse {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/protocol-response
|
|
|
|
/**
|
|
* The charset of response body, default is `"utf-8"`.
|
|
*/
|
|
charset?: string;
|
|
/**
|
|
* The response body. When returning stream as response, this is a Node.js readable
|
|
* stream representing the response body. When returning `Buffer` as response, this
|
|
* is a `Buffer`. When returning `string` as response, this is a `string`. This is
|
|
* ignored for other types of responses.
|
|
*/
|
|
data?: (Buffer) | (string) | (NodeJS.ReadableStream);
|
|
/**
|
|
* When assigned, the `request` will fail with the `error` number . For the
|
|
* available error numbers you can use, please see the net error list.
|
|
*/
|
|
error?: number;
|
|
/**
|
|
* An object containing the response headers. The keys must be string, and values
|
|
* must be either string or Array of string.
|
|
*/
|
|
headers?: Record<string, (string) | (string[])>;
|
|
/**
|
|
* The HTTP `method`. This is only used for file and URL responses.
|
|
*/
|
|
method?: string;
|
|
/**
|
|
* The MIME type of response body, default is `"text/html"`. Setting `mimeType`
|
|
* would implicitly set the `content-type` header in response, but if
|
|
* `content-type` is already set in `headers`, the `mimeType` would be ignored.
|
|
*/
|
|
mimeType?: string;
|
|
/**
|
|
* Path to the file which would be sent as response body. This is only used for
|
|
* file responses.
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* The `referrer` URL. This is only used for file and URL responses.
|
|
*/
|
|
referrer?: string;
|
|
/**
|
|
* The session used for requesting URL, by default the HTTP request will reuse the
|
|
* current session. Setting `session` to `null` would use a random independent
|
|
* session. This is only used for URL responses.
|
|
*/
|
|
session?: Session;
|
|
/**
|
|
* The HTTP response code, default is 200.
|
|
*/
|
|
statusCode?: number;
|
|
/**
|
|
* The data used as upload data. This is only used for URL responses when `method`
|
|
* is `"POST"`.
|
|
*/
|
|
uploadData?: ProtocolResponseUploadData;
|
|
/**
|
|
* Download the `url` and pipe the result as response body. This is only used for
|
|
* URL responses.
|
|
*/
|
|
url?: string;
|
|
}
|
|
|
|
interface ProtocolResponseUploadData {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/protocol-response-upload-data
|
|
|
|
/**
|
|
* MIME type of the content.
|
|
*/
|
|
contentType: string;
|
|
/**
|
|
* Content to be sent.
|
|
*/
|
|
data: (string) | (Buffer);
|
|
}
|
|
|
|
interface PushNotifications extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/push-notifications
|
|
|
|
/**
|
|
* Emitted when the app receives a remote notification while running. See:
|
|
* https://developer.apple.com/documentation/appkit/nsapplicationdelegate/1428430-application?language=objc
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'received-apns-notification', listener: (event: Event,
|
|
userInfo: Record<string, any>) => void): this;
|
|
once(event: 'received-apns-notification', listener: (event: Event,
|
|
userInfo: Record<string, any>) => void): this;
|
|
addListener(event: 'received-apns-notification', listener: (event: Event,
|
|
userInfo: Record<string, any>) => void): this;
|
|
removeListener(event: 'received-apns-notification', listener: (event: Event,
|
|
userInfo: Record<string, any>) => void): this;
|
|
/**
|
|
* Registers the app with Apple Push Notification service (APNS) to receive Badge,
|
|
* Sound, and Alert notifications. If registration is successful, the promise will
|
|
* be resolved with the APNS device token. Otherwise, the promise will be rejected
|
|
* with an error message. See:
|
|
* https://developer.apple.com/documentation/appkit/nsapplication/1428476-registerforremotenotificationtyp?language=objc
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
registerForAPNSNotifications(): Promise<string>;
|
|
/**
|
|
* Unregisters the app from notifications received from APNS. See:
|
|
* https://developer.apple.com/documentation/appkit/nsapplication/1428747-unregisterforremotenotifications?language=objc
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
unregisterForAPNSNotifications(): void;
|
|
}
|
|
|
|
interface Rectangle {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/rectangle
|
|
|
|
/**
|
|
* The height of the rectangle (must be an integer).
|
|
*/
|
|
height: number;
|
|
/**
|
|
* The width of the rectangle (must be an integer).
|
|
*/
|
|
width: number;
|
|
/**
|
|
* The x coordinate of the origin of the rectangle (must be an integer).
|
|
*/
|
|
x: number;
|
|
/**
|
|
* The y coordinate of the origin of the rectangle (must be an integer).
|
|
*/
|
|
y: number;
|
|
}
|
|
|
|
interface Referrer {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/referrer
|
|
|
|
/**
|
|
* Can be `default`, `unsafe-url`, `no-referrer-when-downgrade`, `no-referrer`,
|
|
* `origin`, `strict-origin-when-cross-origin`, `same-origin` or `strict-origin`.
|
|
* See the Referrer-Policy spec for more details on the meaning of these values.
|
|
*/
|
|
policy: ('default' | 'unsafe-url' | 'no-referrer-when-downgrade' | 'no-referrer' | 'origin' | 'strict-origin-when-cross-origin' | 'same-origin' | 'strict-origin');
|
|
/**
|
|
* HTTP Referrer URL.
|
|
*/
|
|
url: string;
|
|
}
|
|
|
|
interface RenderProcessGoneDetails {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/render-process-gone-details
|
|
|
|
/**
|
|
* The exit code of the process, unless `reason` is `launch-failed`, in which case
|
|
* `exitCode` will be a platform-specific launch failure error code.
|
|
*/
|
|
exitCode: number;
|
|
/**
|
|
* The reason the render process is gone. Possible values:
|
|
*/
|
|
reason: ('clean-exit' | 'abnormal-exit' | 'killed' | 'crashed' | 'oom' | 'launch-failed' | 'integrity-failure');
|
|
}
|
|
|
|
interface ResolvedEndpoint {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/resolved-endpoint
|
|
|
|
address: string;
|
|
/**
|
|
* One of the following:
|
|
*/
|
|
family: ('ipv4' | 'ipv6' | 'unspec');
|
|
}
|
|
|
|
interface ResolvedHost {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/resolved-host
|
|
|
|
/**
|
|
* resolved DNS entries for the hostname
|
|
*/
|
|
endpoints: ResolvedEndpoint[];
|
|
}
|
|
|
|
interface SafeStorage extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/safe-storage
|
|
|
|
/**
|
|
* the decrypted string. Decrypts the encrypted buffer obtained with
|
|
* `safeStorage.encryptString` back into a string.
|
|
*
|
|
* This function will throw an error if decryption fails.
|
|
*/
|
|
decryptString(encrypted: Buffer): string;
|
|
/**
|
|
* An array of bytes representing the encrypted string.
|
|
*
|
|
* This function will throw an error if encryption fails.
|
|
*/
|
|
encryptString(plainText: string): Buffer;
|
|
/**
|
|
* User friendly name of the password manager selected on Linux.
|
|
*
|
|
* This function will return one of the following values:
|
|
*
|
|
* * `basic_text` - When the desktop environment is not recognised or if the
|
|
* following command line flag is provided `--password-store="basic"`.
|
|
* * `gnome_libsecret` - When the desktop environment is `X-Cinnamon`, `Deepin`,
|
|
* `GNOME`, `Pantheon`, `XFCE`, `UKUI`, `unity` or if the following command line
|
|
* flag is provided `--password-store="gnome-libsecret"`.
|
|
* * `kwallet` - When the desktop session is `kde4` or if the following command
|
|
* line flag is provided `--password-store="kwallet"`.
|
|
* * `kwallet5` - When the desktop session is `kde5` or if the following command
|
|
* line flag is provided `--password-store="kwallet5"`.
|
|
* * `kwallet6` - When the desktop session is `kde6`.
|
|
* * `unknown` - When the function is called before app has emitted the `ready`
|
|
* event.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
getSelectedStorageBackend(): ('basic_text' | 'gnome_libsecret' | 'kwallet' | 'kwallet5' | 'kwallet6' | 'unknown');
|
|
/**
|
|
* Whether encryption is available.
|
|
*
|
|
* On Linux, returns true if the app has emitted the `ready` event and the secret
|
|
* key is available. On MacOS, returns true if Keychain is available. On Windows,
|
|
* returns true once the app has emitted the `ready` event.
|
|
*/
|
|
isEncryptionAvailable(): boolean;
|
|
/**
|
|
* This function on Linux will force the module to use an in memory password for
|
|
* creating symmetric key that is used for encrypt/decrypt functions when a valid
|
|
* OS password manager cannot be determined for the current active desktop
|
|
* environment. This function is a no-op on Windows and MacOS.
|
|
*/
|
|
setUsePlainTextEncryption(usePlainText: boolean): void;
|
|
}
|
|
|
|
interface Screen extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/screen
|
|
|
|
/**
|
|
* Emitted when `newDisplay` has been added.
|
|
*/
|
|
on(event: 'display-added', listener: (event: Event,
|
|
newDisplay: Display) => void): this;
|
|
once(event: 'display-added', listener: (event: Event,
|
|
newDisplay: Display) => void): this;
|
|
addListener(event: 'display-added', listener: (event: Event,
|
|
newDisplay: Display) => void): this;
|
|
removeListener(event: 'display-added', listener: (event: Event,
|
|
newDisplay: Display) => void): this;
|
|
/**
|
|
* Emitted when one or more metrics change in a `display`. The `changedMetrics` is
|
|
* an array of strings that describe the changes. Possible changes are `bounds`,
|
|
* `workArea`, `scaleFactor` and `rotation`.
|
|
*/
|
|
on(event: 'display-metrics-changed', listener: (event: Event,
|
|
display: Display,
|
|
changedMetrics: string[]) => void): this;
|
|
once(event: 'display-metrics-changed', listener: (event: Event,
|
|
display: Display,
|
|
changedMetrics: string[]) => void): this;
|
|
addListener(event: 'display-metrics-changed', listener: (event: Event,
|
|
display: Display,
|
|
changedMetrics: string[]) => void): this;
|
|
removeListener(event: 'display-metrics-changed', listener: (event: Event,
|
|
display: Display,
|
|
changedMetrics: string[]) => void): this;
|
|
/**
|
|
* Emitted when `oldDisplay` has been removed.
|
|
*/
|
|
on(event: 'display-removed', listener: (event: Event,
|
|
oldDisplay: Display) => void): this;
|
|
once(event: 'display-removed', listener: (event: Event,
|
|
oldDisplay: Display) => void): this;
|
|
addListener(event: 'display-removed', listener: (event: Event,
|
|
oldDisplay: Display) => void): this;
|
|
removeListener(event: 'display-removed', listener: (event: Event,
|
|
oldDisplay: Display) => void): this;
|
|
/**
|
|
* Converts a screen DIP point to a screen physical point. The DPI scale is
|
|
* performed relative to the display containing the DIP point.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
dipToScreenPoint(point: Point): Point;
|
|
/**
|
|
* Converts a screen DIP rect to a screen physical rect. The DPI scale is performed
|
|
* relative to the display nearest to `window`. If `window` is null, scaling will
|
|
* be performed to the display nearest to `rect`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
dipToScreenRect(window: (BrowserWindow) | (null), rect: Rectangle): Rectangle;
|
|
/**
|
|
* An array of displays that are currently available.
|
|
*/
|
|
getAllDisplays(): Display[];
|
|
/**
|
|
* The current absolute position of the mouse pointer.
|
|
*
|
|
* **Note:** The return value is a DIP point, not a screen physical point.
|
|
*/
|
|
getCursorScreenPoint(): Point;
|
|
/**
|
|
* The display that most closely intersects the provided bounds.
|
|
*/
|
|
getDisplayMatching(rect: Rectangle): Display;
|
|
/**
|
|
* The display nearest the specified point.
|
|
*/
|
|
getDisplayNearestPoint(point: Point): Display;
|
|
/**
|
|
* The primary display.
|
|
*/
|
|
getPrimaryDisplay(): Display;
|
|
/**
|
|
* Converts a screen physical point to a screen DIP point. The DPI scale is
|
|
* performed relative to the display containing the physical point.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
screenToDipPoint(point: Point): Point;
|
|
/**
|
|
* Converts a screen physical rect to a screen DIP rect. The DPI scale is performed
|
|
* relative to the display nearest to `window`. If `window` is null, scaling will
|
|
* be performed to the display nearest to `rect`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
screenToDipRect(window: (BrowserWindow) | (null), rect: Rectangle): Rectangle;
|
|
}
|
|
|
|
interface ScrubberItem {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/scrubber-item
|
|
|
|
/**
|
|
* The image to appear in this item.
|
|
*/
|
|
icon?: NativeImage;
|
|
/**
|
|
* The text to appear in this item.
|
|
*/
|
|
label?: string;
|
|
}
|
|
|
|
interface SegmentedControlSegment {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/segmented-control-segment
|
|
|
|
/**
|
|
* Whether this segment is selectable. Default: true.
|
|
*/
|
|
enabled?: boolean;
|
|
/**
|
|
* The image to appear in this segment.
|
|
*/
|
|
icon?: NativeImage;
|
|
/**
|
|
* The text to appear in this segment.
|
|
*/
|
|
label?: string;
|
|
}
|
|
|
|
interface SerialPort {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/serial-port
|
|
|
|
/**
|
|
* A stable identifier on Windows that can be used for device permissions.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
deviceInstanceId?: string;
|
|
/**
|
|
* A string suitable for display to the user for describing this device.
|
|
*/
|
|
displayName?: string;
|
|
/**
|
|
* Unique identifier for the port.
|
|
*/
|
|
portId: string;
|
|
/**
|
|
* Name of the port.
|
|
*/
|
|
portName: string;
|
|
/**
|
|
* The USB product ID.
|
|
*/
|
|
productId?: string;
|
|
/**
|
|
* The USB device serial number.
|
|
*/
|
|
serialNumber?: string;
|
|
/**
|
|
* Represents a single serial port on macOS can be enumerated by multiple drivers.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
usbDriverName?: string;
|
|
/**
|
|
* The USB vendor ID.
|
|
*/
|
|
vendorId?: string;
|
|
}
|
|
|
|
interface ServiceWorkerInfo {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/service-worker-info
|
|
|
|
/**
|
|
* The virtual ID of the process that this service worker is running in. This is
|
|
* not an OS level PID. This aligns with the ID set used for
|
|
* `webContents.getProcessId()`.
|
|
*/
|
|
renderProcessId: number;
|
|
/**
|
|
* The base URL that this service worker is active for.
|
|
*/
|
|
scope: string;
|
|
/**
|
|
* The full URL to the script that this service worker runs
|
|
*/
|
|
scriptUrl: string;
|
|
}
|
|
|
|
class ServiceWorkers extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/service-workers
|
|
|
|
/**
|
|
* Emitted when a service worker logs something to the console.
|
|
*/
|
|
on(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* Information about the console message
|
|
*/
|
|
messageDetails: MessageDetails) => void): this;
|
|
once(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* Information about the console message
|
|
*/
|
|
messageDetails: MessageDetails) => void): this;
|
|
addListener(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* Information about the console message
|
|
*/
|
|
messageDetails: MessageDetails) => void): this;
|
|
removeListener(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* Information about the console message
|
|
*/
|
|
messageDetails: MessageDetails) => void): this;
|
|
/**
|
|
* Emitted when a service worker has been registered. Can occur after a call to
|
|
* `navigator.serviceWorker.register('/sw.js')` successfully resolves or when a
|
|
* Chrome extension is loaded.
|
|
*/
|
|
on(event: 'registration-completed', listener: (event: Event,
|
|
/**
|
|
* Information about the registered service worker
|
|
*/
|
|
details: RegistrationCompletedDetails) => void): this;
|
|
once(event: 'registration-completed', listener: (event: Event,
|
|
/**
|
|
* Information about the registered service worker
|
|
*/
|
|
details: RegistrationCompletedDetails) => void): this;
|
|
addListener(event: 'registration-completed', listener: (event: Event,
|
|
/**
|
|
* Information about the registered service worker
|
|
*/
|
|
details: RegistrationCompletedDetails) => void): this;
|
|
removeListener(event: 'registration-completed', listener: (event: Event,
|
|
/**
|
|
* Information about the registered service worker
|
|
*/
|
|
details: RegistrationCompletedDetails) => void): this;
|
|
/**
|
|
* A ServiceWorkerInfo object where the keys are the service worker version ID and
|
|
* the values are the information about that service worker.
|
|
*/
|
|
getAllRunning(): Record<number, ServiceWorkerInfo>;
|
|
/**
|
|
* Information about this service worker
|
|
*
|
|
* If the service worker does not exist or is not running this method will throw an
|
|
* exception.
|
|
*/
|
|
getFromVersionID(versionId: number): ServiceWorkerInfo;
|
|
}
|
|
|
|
class Session extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/session
|
|
|
|
/**
|
|
* A session instance from `partition` string. When there is an existing `Session`
|
|
* with the same `partition`, it will be returned; otherwise a new `Session`
|
|
* instance will be created with `options`.
|
|
*
|
|
* If `partition` starts with `persist:`, the page will use a persistent session
|
|
* available to all pages in the app with the same `partition`. if there is no
|
|
* `persist:` prefix, the page will use an in-memory session. If the `partition` is
|
|
* empty then default session of the app will be returned.
|
|
*
|
|
* To create a `Session` with `options`, you have to ensure the `Session` with the
|
|
* `partition` has never been used before. There is no way to change the `options`
|
|
* of an existing `Session` object.
|
|
*/
|
|
static fromPartition(partition: string, options?: FromPartitionOptions): Session;
|
|
/**
|
|
* A session instance from the absolute path as specified by the `path` string.
|
|
* When there is an existing `Session` with the same absolute path, it will be
|
|
* returned; otherwise a new `Session` instance will be created with `options`. The
|
|
* call will throw an error if the path is not an absolute path. Additionally, an
|
|
* error will be thrown if an empty string is provided.
|
|
*
|
|
* To create a `Session` with `options`, you have to ensure the `Session` with the
|
|
* `path` has never been used before. There is no way to change the `options` of an
|
|
* existing `Session` object.
|
|
*/
|
|
static fromPath(path: string, options?: FromPathOptions): Session;
|
|
/**
|
|
* A `Session` object, the default session object of the app.
|
|
*/
|
|
static defaultSession: Session;
|
|
/**
|
|
* Emitted after an extension is loaded. This occurs whenever an extension is added
|
|
* to the "enabled" set of extensions. This includes:
|
|
*
|
|
* * Extensions being loaded from `Session.loadExtension`.
|
|
* * Extensions being reloaded:
|
|
* * from a crash.
|
|
* * if the extension requested it (`chrome.runtime.reload()`).
|
|
*/
|
|
on(event: 'extension-loaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
once(event: 'extension-loaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
addListener(event: 'extension-loaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
removeListener(event: 'extension-loaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
/**
|
|
* Emitted after an extension is loaded and all necessary browser state is
|
|
* initialized to support the start of the extension's background page.
|
|
*/
|
|
on(event: 'extension-ready', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
once(event: 'extension-ready', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
addListener(event: 'extension-ready', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
removeListener(event: 'extension-ready', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
/**
|
|
* Emitted after an extension is unloaded. This occurs when
|
|
* `Session.removeExtension` is called.
|
|
*/
|
|
on(event: 'extension-unloaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
once(event: 'extension-unloaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
addListener(event: 'extension-unloaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
removeListener(event: 'extension-unloaded', listener: (event: Event,
|
|
extension: Extension) => void): this;
|
|
/**
|
|
* Emitted after `navigator.hid.requestDevice` has been called and
|
|
* `select-hid-device` has fired if a new device becomes available before the
|
|
* callback from `select-hid-device` is called. This event is intended for use
|
|
* when using a UI to ask users to pick a device so that the UI can be updated with
|
|
* the newly added device.
|
|
*/
|
|
on(event: 'hid-device-added', listener: (event: Event,
|
|
details: HidDeviceAddedDetails) => void): this;
|
|
once(event: 'hid-device-added', listener: (event: Event,
|
|
details: HidDeviceAddedDetails) => void): this;
|
|
addListener(event: 'hid-device-added', listener: (event: Event,
|
|
details: HidDeviceAddedDetails) => void): this;
|
|
removeListener(event: 'hid-device-added', listener: (event: Event,
|
|
details: HidDeviceAddedDetails) => void): this;
|
|
/**
|
|
* Emitted after `navigator.hid.requestDevice` has been called and
|
|
* `select-hid-device` has fired if a device has been removed before the callback
|
|
* from `select-hid-device` is called. This event is intended for use when using a
|
|
* UI to ask users to pick a device so that the UI can be updated to remove the
|
|
* specified device.
|
|
*/
|
|
on(event: 'hid-device-removed', listener: (event: Event,
|
|
details: HidDeviceRemovedDetails) => void): this;
|
|
once(event: 'hid-device-removed', listener: (event: Event,
|
|
details: HidDeviceRemovedDetails) => void): this;
|
|
addListener(event: 'hid-device-removed', listener: (event: Event,
|
|
details: HidDeviceRemovedDetails) => void): this;
|
|
removeListener(event: 'hid-device-removed', listener: (event: Event,
|
|
details: HidDeviceRemovedDetails) => void): this;
|
|
/**
|
|
* Emitted after `HIDDevice.forget()` has been called. This event can be used to
|
|
* help maintain persistent storage of permissions when
|
|
* `setDevicePermissionHandler` is used.
|
|
*/
|
|
on(event: 'hid-device-revoked', listener: (event: Event,
|
|
details: HidDeviceRevokedDetails) => void): this;
|
|
once(event: 'hid-device-revoked', listener: (event: Event,
|
|
details: HidDeviceRevokedDetails) => void): this;
|
|
addListener(event: 'hid-device-revoked', listener: (event: Event,
|
|
details: HidDeviceRevokedDetails) => void): this;
|
|
removeListener(event: 'hid-device-revoked', listener: (event: Event,
|
|
details: HidDeviceRevokedDetails) => void): this;
|
|
/**
|
|
* Emitted when a render process requests preconnection to a URL, generally due to
|
|
* a resource hint.
|
|
*/
|
|
on(event: 'preconnect', listener: (event: Event,
|
|
/**
|
|
* The URL being requested for preconnection by the renderer.
|
|
*/
|
|
preconnectUrl: string,
|
|
/**
|
|
* True if the renderer is requesting that the connection include credentials (see
|
|
* the spec for more details.)
|
|
*/
|
|
allowCredentials: boolean) => void): this;
|
|
once(event: 'preconnect', listener: (event: Event,
|
|
/**
|
|
* The URL being requested for preconnection by the renderer.
|
|
*/
|
|
preconnectUrl: string,
|
|
/**
|
|
* True if the renderer is requesting that the connection include credentials (see
|
|
* the spec for more details.)
|
|
*/
|
|
allowCredentials: boolean) => void): this;
|
|
addListener(event: 'preconnect', listener: (event: Event,
|
|
/**
|
|
* The URL being requested for preconnection by the renderer.
|
|
*/
|
|
preconnectUrl: string,
|
|
/**
|
|
* True if the renderer is requesting that the connection include credentials (see
|
|
* the spec for more details.)
|
|
*/
|
|
allowCredentials: boolean) => void): this;
|
|
removeListener(event: 'preconnect', listener: (event: Event,
|
|
/**
|
|
* The URL being requested for preconnection by the renderer.
|
|
*/
|
|
preconnectUrl: string,
|
|
/**
|
|
* True if the renderer is requesting that the connection include credentials (see
|
|
* the spec for more details.)
|
|
*/
|
|
allowCredentials: boolean) => void): this;
|
|
/**
|
|
* Emitted when a HID device needs to be selected when a call to
|
|
* `navigator.hid.requestDevice` is made. `callback` should be called with
|
|
* `deviceId` to be selected; passing no arguments to `callback` will cancel the
|
|
* request. Additionally, permissioning on `navigator.hid` can be further managed
|
|
* by using `ses.setPermissionCheckHandler(handler)` and
|
|
* `ses.setDevicePermissionHandler(handler)`.
|
|
*/
|
|
on(event: 'select-hid-device', listener: (event: Event,
|
|
details: SelectHidDeviceDetails,
|
|
callback: (deviceId?: (string) | (null)) => void) => void): this;
|
|
once(event: 'select-hid-device', listener: (event: Event,
|
|
details: SelectHidDeviceDetails,
|
|
callback: (deviceId?: (string) | (null)) => void) => void): this;
|
|
addListener(event: 'select-hid-device', listener: (event: Event,
|
|
details: SelectHidDeviceDetails,
|
|
callback: (deviceId?: (string) | (null)) => void) => void): this;
|
|
removeListener(event: 'select-hid-device', listener: (event: Event,
|
|
details: SelectHidDeviceDetails,
|
|
callback: (deviceId?: (string) | (null)) => void) => void): this;
|
|
/**
|
|
* Emitted when a serial port needs to be selected when a call to
|
|
* `navigator.serial.requestPort` is made. `callback` should be called with
|
|
* `portId` to be selected, passing an empty string to `callback` will cancel the
|
|
* request. Additionally, permissioning on `navigator.serial` can be managed by
|
|
* using ses.setPermissionCheckHandler(handler) with the `serial` permission.
|
|
*/
|
|
on(event: 'select-serial-port', listener: (event: Event,
|
|
portList: SerialPort[],
|
|
webContents: WebContents,
|
|
callback: (portId: string) => void) => void): this;
|
|
once(event: 'select-serial-port', listener: (event: Event,
|
|
portList: SerialPort[],
|
|
webContents: WebContents,
|
|
callback: (portId: string) => void) => void): this;
|
|
addListener(event: 'select-serial-port', listener: (event: Event,
|
|
portList: SerialPort[],
|
|
webContents: WebContents,
|
|
callback: (portId: string) => void) => void): this;
|
|
removeListener(event: 'select-serial-port', listener: (event: Event,
|
|
portList: SerialPort[],
|
|
webContents: WebContents,
|
|
callback: (portId: string) => void) => void): this;
|
|
/**
|
|
* Emitted when a USB device needs to be selected when a call to
|
|
* `navigator.usb.requestDevice` is made. `callback` should be called with
|
|
* `deviceId` to be selected; passing no arguments to `callback` will cancel the
|
|
* request. Additionally, permissioning on `navigator.usb` can be further managed
|
|
* by using `ses.setPermissionCheckHandler(handler)` and
|
|
* `ses.setDevicePermissionHandler(handler)`.
|
|
*/
|
|
on(event: 'select-usb-device', listener: (event: Event,
|
|
details: SelectUsbDeviceDetails,
|
|
callback: (deviceId?: string) => void) => void): this;
|
|
once(event: 'select-usb-device', listener: (event: Event,
|
|
details: SelectUsbDeviceDetails,
|
|
callback: (deviceId?: string) => void) => void): this;
|
|
addListener(event: 'select-usb-device', listener: (event: Event,
|
|
details: SelectUsbDeviceDetails,
|
|
callback: (deviceId?: string) => void) => void): this;
|
|
removeListener(event: 'select-usb-device', listener: (event: Event,
|
|
details: SelectUsbDeviceDetails,
|
|
callback: (deviceId?: string) => void) => void): this;
|
|
/**
|
|
* Emitted after `navigator.serial.requestPort` has been called and
|
|
* `select-serial-port` has fired if a new serial port becomes available before the
|
|
* callback from `select-serial-port` is called. This event is intended for use
|
|
* when using a UI to ask users to pick a port so that the UI can be updated with
|
|
* the newly added port.
|
|
*/
|
|
on(event: 'serial-port-added', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'serial-port-added', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'serial-port-added', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'serial-port-added', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Emitted after `navigator.serial.requestPort` has been called and
|
|
* `select-serial-port` has fired if a serial port has been removed before the
|
|
* callback from `select-serial-port` is called. This event is intended for use
|
|
* when using a UI to ask users to pick a port so that the UI can be updated to
|
|
* remove the specified port.
|
|
*/
|
|
on(event: 'serial-port-removed', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'serial-port-removed', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'serial-port-removed', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'serial-port-removed', listener: (event: Event,
|
|
port: SerialPort,
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Emitted after `SerialPort.forget()` has been called. This event can be used to
|
|
* help maintain persistent storage of permissions when
|
|
* `setDevicePermissionHandler` is used.
|
|
*/
|
|
on(event: 'serial-port-revoked', listener: (event: Event,
|
|
details: SerialPortRevokedDetails) => void): this;
|
|
once(event: 'serial-port-revoked', listener: (event: Event,
|
|
details: SerialPortRevokedDetails) => void): this;
|
|
addListener(event: 'serial-port-revoked', listener: (event: Event,
|
|
details: SerialPortRevokedDetails) => void): this;
|
|
removeListener(event: 'serial-port-revoked', listener: (event: Event,
|
|
details: SerialPortRevokedDetails) => void): this;
|
|
/**
|
|
* Emitted when a hunspell dictionary file starts downloading
|
|
*/
|
|
on(event: 'spellcheck-dictionary-download-begin', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
once(event: 'spellcheck-dictionary-download-begin', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
addListener(event: 'spellcheck-dictionary-download-begin', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
removeListener(event: 'spellcheck-dictionary-download-begin', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
/**
|
|
* Emitted when a hunspell dictionary file download fails. For details on the
|
|
* failure you should collect a netlog and inspect the download request.
|
|
*/
|
|
on(event: 'spellcheck-dictionary-download-failure', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
once(event: 'spellcheck-dictionary-download-failure', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
addListener(event: 'spellcheck-dictionary-download-failure', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
removeListener(event: 'spellcheck-dictionary-download-failure', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
/**
|
|
* Emitted when a hunspell dictionary file has been successfully downloaded
|
|
*/
|
|
on(event: 'spellcheck-dictionary-download-success', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
once(event: 'spellcheck-dictionary-download-success', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
addListener(event: 'spellcheck-dictionary-download-success', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
removeListener(event: 'spellcheck-dictionary-download-success', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
/**
|
|
* Emitted when a hunspell dictionary file has been successfully initialized. This
|
|
* occurs after the file has been downloaded.
|
|
*/
|
|
on(event: 'spellcheck-dictionary-initialized', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
once(event: 'spellcheck-dictionary-initialized', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
addListener(event: 'spellcheck-dictionary-initialized', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
removeListener(event: 'spellcheck-dictionary-initialized', listener: (event: Event,
|
|
/**
|
|
* The language code of the dictionary file
|
|
*/
|
|
languageCode: string) => void): this;
|
|
/**
|
|
* Emitted after `navigator.usb.requestDevice` has been called and
|
|
* `select-usb-device` has fired if a new device becomes available before the
|
|
* callback from `select-usb-device` is called. This event is intended for use
|
|
* when using a UI to ask users to pick a device so that the UI can be updated with
|
|
* the newly added device.
|
|
*/
|
|
on(event: 'usb-device-added', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'usb-device-added', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'usb-device-added', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'usb-device-added', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Emitted after `navigator.usb.requestDevice` has been called and
|
|
* `select-usb-device` has fired if a device has been removed before the callback
|
|
* from `select-usb-device` is called. This event is intended for use when using a
|
|
* UI to ask users to pick a device so that the UI can be updated to remove the
|
|
* specified device.
|
|
*/
|
|
on(event: 'usb-device-removed', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'usb-device-removed', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'usb-device-removed', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'usb-device-removed', listener: (event: Event,
|
|
device: USBDevice,
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Emitted after `USBDevice.forget()` has been called. This event can be used to
|
|
* help maintain persistent storage of permissions when
|
|
* `setDevicePermissionHandler` is used.
|
|
*/
|
|
on(event: 'usb-device-revoked', listener: (event: Event,
|
|
details: UsbDeviceRevokedDetails) => void): this;
|
|
once(event: 'usb-device-revoked', listener: (event: Event,
|
|
details: UsbDeviceRevokedDetails) => void): this;
|
|
addListener(event: 'usb-device-revoked', listener: (event: Event,
|
|
details: UsbDeviceRevokedDetails) => void): this;
|
|
removeListener(event: 'usb-device-revoked', listener: (event: Event,
|
|
details: UsbDeviceRevokedDetails) => void): this;
|
|
/**
|
|
* Emitted when Electron is about to download `item` in `webContents`.
|
|
*
|
|
* Calling `event.preventDefault()` will cancel the download and `item` will not be
|
|
* available from next tick of the process.
|
|
*/
|
|
on(event: 'will-download', listener: (event: Event,
|
|
item: DownloadItem,
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'will-download', listener: (event: Event,
|
|
item: DownloadItem,
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'will-download', listener: (event: Event,
|
|
item: DownloadItem,
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'will-download', listener: (event: Event,
|
|
item: DownloadItem,
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Whether the word was successfully written to the custom dictionary. This API
|
|
* will not work on non-persistent (in-memory) sessions.
|
|
*
|
|
* **Note:** On macOS and Windows 10 this word will be written to the OS custom
|
|
* dictionary as well
|
|
*/
|
|
addWordToSpellCheckerDictionary(word: string): boolean;
|
|
/**
|
|
* Dynamically sets whether to always send credentials for HTTP NTLM or Negotiate
|
|
* authentication.
|
|
*/
|
|
allowNTLMCredentialsForDomains(domains: string): void;
|
|
/**
|
|
* resolves when the session’s HTTP authentication cache has been cleared.
|
|
*/
|
|
clearAuthCache(): Promise<void>;
|
|
/**
|
|
* resolves when the cache clear operation is complete.
|
|
*
|
|
* Clears the session’s HTTP cache.
|
|
*/
|
|
clearCache(): Promise<void>;
|
|
/**
|
|
* resolves when the code cache clear operation is complete.
|
|
*/
|
|
clearCodeCaches(options: ClearCodeCachesOptions): Promise<void>;
|
|
/**
|
|
* Resolves when the operation is complete.
|
|
*
|
|
* Clears the host resolver cache.
|
|
*/
|
|
clearHostResolverCache(): Promise<void>;
|
|
/**
|
|
* resolves when the storage data has been cleared.
|
|
*/
|
|
clearStorageData(options?: ClearStorageDataOptions): Promise<void>;
|
|
/**
|
|
* Resolves when all connections are closed.
|
|
*
|
|
* **Note:** It will terminate / fail all requests currently in flight.
|
|
*/
|
|
closeAllConnections(): Promise<void>;
|
|
/**
|
|
* Allows resuming `cancelled` or `interrupted` downloads from previous `Session`.
|
|
* The API will generate a DownloadItem that can be accessed with the will-download
|
|
* event. The DownloadItem will not have any `WebContents` associated with it and
|
|
* the initial state will be `interrupted`. The download will start only when the
|
|
* `resume` API is called on the DownloadItem.
|
|
*/
|
|
createInterruptedDownload(options: CreateInterruptedDownloadOptions): void;
|
|
/**
|
|
* Disables any network emulation already active for the `session`. Resets to the
|
|
* original network configuration.
|
|
*/
|
|
disableNetworkEmulation(): void;
|
|
/**
|
|
* Initiates a download of the resource at `url`. The API will generate a
|
|
* DownloadItem that can be accessed with the will-download event.
|
|
*
|
|
* **Note:** This does not perform any security checks that relate to a page's
|
|
* origin, unlike `webContents.downloadURL`.
|
|
*/
|
|
downloadURL(url: string, options?: DownloadURLOptions): void;
|
|
/**
|
|
* Emulates network with the given configuration for the `session`.
|
|
*/
|
|
enableNetworkEmulation(options: EnableNetworkEmulationOptions): void;
|
|
/**
|
|
* see Response.
|
|
*
|
|
* Sends a request, similarly to how `fetch()` works in the renderer, using
|
|
* Chrome's network stack. This differs from Node's `fetch()`, which uses Node.js's
|
|
* HTTP stack.
|
|
*
|
|
* Example:
|
|
*
|
|
* See also `net.fetch()`, a convenience method which issues requests from the
|
|
* default session.
|
|
*
|
|
* See the MDN documentation for `fetch()` for more details.
|
|
*
|
|
* Limitations:
|
|
*
|
|
* * `net.fetch()` does not support the `data:` or `blob:` schemes.
|
|
* * The value of the `integrity` option is ignored.
|
|
* * The `.type` and `.url` values of the returned `Response` object are incorrect.
|
|
*
|
|
* By default, requests made with `net.fetch` can be made to custom protocols as
|
|
* well as `file:`, and will trigger webRequest handlers if present. When the
|
|
* non-standard `bypassCustomProtocolHandlers` option is set in RequestInit, custom
|
|
* protocol handlers will not be called for this request. This allows forwarding an
|
|
* intercepted request to the built-in handler. webRequest handlers will still be
|
|
* triggered when bypassing custom protocols.
|
|
*/
|
|
fetch(input: (string) | (GlobalRequest), init?: RequestInit): Promise<GlobalResponse>;
|
|
/**
|
|
* Writes any unwritten DOMStorage data to disk.
|
|
*/
|
|
flushStorageData(): void;
|
|
/**
|
|
* Resolves when the all internal states of proxy service is reset and the latest
|
|
* proxy configuration is reapplied if it's already available. The pac script will
|
|
* be fetched from `pacScript` again if the proxy mode is `pac_script`.
|
|
*/
|
|
forceReloadProxyConfig(): Promise<void>;
|
|
/**
|
|
* A list of all loaded extensions.
|
|
*
|
|
* **Note:** This API cannot be called before the `ready` event of the `app` module
|
|
* is emitted.
|
|
*/
|
|
getAllExtensions(): Extension[];
|
|
/**
|
|
* resolves with blob data.
|
|
*/
|
|
getBlobData(identifier: string): Promise<Buffer>;
|
|
/**
|
|
* the session's current cache size, in bytes.
|
|
*/
|
|
getCacheSize(): Promise<number>;
|
|
/**
|
|
* The loaded extension with the given ID.
|
|
*
|
|
* **Note:** This API cannot be called before the `ready` event of the `app` module
|
|
* is emitted.
|
|
*/
|
|
getExtension(extensionId: string): (Extension) | (null);
|
|
/**
|
|
* an array of paths to preload scripts that have been registered.
|
|
*/
|
|
getPreloads(): string[];
|
|
/**
|
|
* An array of language codes the spellchecker is enabled for. If this list is
|
|
* empty the spellchecker will fallback to using `en-US`. By default on launch if
|
|
* this setting is an empty list Electron will try to populate this setting with
|
|
* the current OS locale. This setting is persisted across restarts.
|
|
*
|
|
* **Note:** On macOS the OS spellchecker is used and has its own list of
|
|
* languages. On macOS, this API will return whichever languages have been
|
|
* configured by the OS.
|
|
*/
|
|
getSpellCheckerLanguages(): string[];
|
|
/**
|
|
* The absolute file system path where data for this session is persisted on disk.
|
|
* For in memory sessions this returns `null`.
|
|
*/
|
|
getStoragePath(): (string) | (null);
|
|
/**
|
|
* The user agent for this session.
|
|
*/
|
|
getUserAgent(): string;
|
|
/**
|
|
* Whether or not this session is a persistent one. The default `webContents`
|
|
* session of a `BrowserWindow` is persistent. When creating a session from a
|
|
* partition, session prefixed with `persist:` will be persistent, while others
|
|
* will be temporary.
|
|
*/
|
|
isPersistent(): boolean;
|
|
/**
|
|
* Whether the builtin spell checker is enabled.
|
|
*/
|
|
isSpellCheckerEnabled(): boolean;
|
|
/**
|
|
* An array of all words in app's custom dictionary. Resolves when the full
|
|
* dictionary is loaded from disk.
|
|
*/
|
|
listWordsInSpellCheckerDictionary(): Promise<string[]>;
|
|
/**
|
|
* resolves when the extension is loaded.
|
|
*
|
|
* This method will raise an exception if the extension could not be loaded. If
|
|
* there are warnings when installing the extension (e.g. if the extension requests
|
|
* an API that Electron does not support) then they will be logged to the console.
|
|
*
|
|
* Note that Electron does not support the full range of Chrome extensions APIs.
|
|
* See Supported Extensions APIs for more details on what is supported.
|
|
*
|
|
* Note that in previous versions of Electron, extensions that were loaded would be
|
|
* remembered for future runs of the application. This is no longer the case:
|
|
* `loadExtension` must be called on every boot of your app if you want the
|
|
* extension to be loaded.
|
|
*
|
|
* This API does not support loading packed (.crx) extensions.
|
|
*
|
|
* **Note:** This API cannot be called before the `ready` event of the `app` module
|
|
* is emitted.
|
|
*
|
|
* **Note:** Loading extensions into in-memory (non-persistent) sessions is not
|
|
* supported and will throw an error.
|
|
*/
|
|
loadExtension(path: string, options?: LoadExtensionOptions): Promise<Electron.Extension>;
|
|
/**
|
|
* Preconnects the given number of sockets to an origin.
|
|
*/
|
|
preconnect(options: PreconnectOptions): void;
|
|
/**
|
|
* Unloads an extension.
|
|
*
|
|
* **Note:** This API cannot be called before the `ready` event of the `app` module
|
|
* is emitted.
|
|
*/
|
|
removeExtension(extensionId: string): void;
|
|
/**
|
|
* Whether the word was successfully removed from the custom dictionary. This API
|
|
* will not work on non-persistent (in-memory) sessions.
|
|
*
|
|
* **Note:** On macOS and Windows 10 this word will be removed from the OS custom
|
|
* dictionary as well
|
|
*/
|
|
removeWordFromSpellCheckerDictionary(word: string): boolean;
|
|
/**
|
|
* Resolves with the resolved IP addresses for the `host`.
|
|
*/
|
|
resolveHost(host: string, options?: ResolveHostOptions): Promise<Electron.ResolvedHost>;
|
|
/**
|
|
* Resolves with the proxy information for `url`.
|
|
*/
|
|
resolveProxy(url: string): Promise<string>;
|
|
/**
|
|
* Sets a handler to respond to Bluetooth pairing requests. This handler allows
|
|
* developers to handle devices that require additional validation before pairing.
|
|
* When a handler is not defined, any pairing on Linux or Windows that requires
|
|
* additional validation will be automatically cancelled. macOS does not require a
|
|
* handler because macOS handles the pairing automatically. To clear the handler,
|
|
* call `setBluetoothPairingHandler(null)`.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
setBluetoothPairingHandler(handler: ((details: BluetoothPairingHandlerHandlerDetails, callback: (response: Response) => void) => void) | (null)): void;
|
|
/**
|
|
* Sets the certificate verify proc for `session`, the `proc` will be called with
|
|
* `proc(request, callback)` whenever a server certificate verification is
|
|
* requested. Calling `callback(0)` accepts the certificate, calling `callback(-2)`
|
|
* rejects it.
|
|
*
|
|
* Calling `setCertificateVerifyProc(null)` will revert back to default certificate
|
|
* verify proc.
|
|
*
|
|
* > **NOTE:** The result of this procedure is cached by the network service.
|
|
*/
|
|
setCertificateVerifyProc(proc: ((request: Request, callback: (verificationResult: number) => void) => void) | (null)): void;
|
|
/**
|
|
* Sets the directory to store the generated JS code cache for this session. The
|
|
* directory is not required to be created by the user before this call, the
|
|
* runtime will create if it does not exist otherwise will use the existing
|
|
* directory. If directory cannot be created, then code cache will not be used and
|
|
* all operations related to code cache will fail silently inside the runtime. By
|
|
* default, the directory will be `Code Cache` under the respective user data
|
|
* folder.
|
|
*/
|
|
setCodeCachePath(path: string): void;
|
|
/**
|
|
* Sets the handler which can be used to respond to device permission checks for
|
|
* the `session`. Returning `true` will allow the device to be permitted and
|
|
* `false` will reject it. To clear the handler, call
|
|
* `setDevicePermissionHandler(null)`. This handler can be used to provide default
|
|
* permissioning to devices without first calling for permission to devices (eg via
|
|
* `navigator.hid.requestDevice`). If this handler is not defined, the default
|
|
* device permissions as granted through device selection (eg via
|
|
* `navigator.hid.requestDevice`) will be used. Additionally, the default behavior
|
|
* of Electron is to store granted device permision in memory. If longer term
|
|
* storage is needed, a developer can store granted device permissions (eg when
|
|
* handling the `select-hid-device` event) and then read from that storage with
|
|
* `setDevicePermissionHandler`.
|
|
*/
|
|
setDevicePermissionHandler(handler: ((details: DevicePermissionHandlerHandlerDetails) => boolean) | (null)): void;
|
|
/**
|
|
* This handler will be called when web content requests access to display media
|
|
* via the `navigator.mediaDevices.getDisplayMedia` API. Use the desktopCapturer
|
|
* API to choose which stream(s) to grant access to.
|
|
*
|
|
* Passing a WebFrameMain object as a video or audio stream will capture the video
|
|
* or audio stream from that frame.
|
|
*
|
|
* Passing `null` instead of a function resets the handler to its default state.
|
|
*/
|
|
setDisplayMediaRequestHandler(handler: ((request: DisplayMediaRequestHandlerHandlerRequest, callback: (streams: Streams) => void) => void) | (null)): void;
|
|
/**
|
|
* Sets download saving directory. By default, the download directory will be the
|
|
* `Downloads` under the respective app folder.
|
|
*/
|
|
setDownloadPath(path: string): void;
|
|
/**
|
|
* Sets the handler which can be used to respond to permission checks for the
|
|
* `session`. Returning `true` will allow the permission and `false` will reject
|
|
* it. Please note that you must also implement `setPermissionRequestHandler` to
|
|
* get complete permission handling. Most web APIs do a permission check and then
|
|
* make a permission request if the check is denied. To clear the handler, call
|
|
* `setPermissionCheckHandler(null)`.
|
|
*/
|
|
setPermissionCheckHandler(handler: ((webContents: (WebContents) | (null), permission: 'clipboard-read' | 'clipboard-sanitized-write' | 'geolocation' | 'fullscreen' | 'hid' | 'idle-detection' | 'media' | 'mediaKeySystem' | 'midi' | 'midiSysex' | 'notifications' | 'openExternal' | 'pointerLock' | 'serial' | 'usb', requestingOrigin: string, details: PermissionCheckHandlerHandlerDetails) => boolean) | (null)): void;
|
|
/**
|
|
* Sets the handler which can be used to respond to permission requests for the
|
|
* `session`. Calling `callback(true)` will allow the permission and
|
|
* `callback(false)` will reject it. To clear the handler, call
|
|
* `setPermissionRequestHandler(null)`. Please note that you must also implement
|
|
* `setPermissionCheckHandler` to get complete permission handling. Most web APIs
|
|
* do a permission check and then make a permission request if the check is denied.
|
|
*/
|
|
setPermissionRequestHandler(handler: ((webContents: WebContents, permission: 'clipboard-read' | 'clipboard-sanitized-write' | 'display-capture' | 'fullscreen' | 'geolocation' | 'idle-detection' | 'media' | 'mediaKeySystem' | 'midi' | 'midiSysex' | 'notifications' | 'pointerLock' | 'openExternal' | 'window-management' | 'unknown', callback: (permissionGranted: boolean) => void, details: PermissionRequestHandlerHandlerDetails) => void) | (null)): void;
|
|
/**
|
|
* Adds scripts that will be executed on ALL web contents that are associated with
|
|
* this session just before normal `preload` scripts run.
|
|
*/
|
|
setPreloads(preloads: string[]): void;
|
|
/**
|
|
* Resolves when the proxy setting process is complete.
|
|
*
|
|
* Sets the proxy settings.
|
|
*
|
|
* When `mode` is unspecified, `pacScript` and `proxyRules` are provided together,
|
|
* the `proxyRules` option is ignored and `pacScript` configuration is applied.
|
|
*
|
|
* You may need `ses.closeAllConnections` to close currently in flight connections
|
|
* to prevent pooled sockets using previous proxy from being reused by future
|
|
* requests.
|
|
*
|
|
* The `proxyRules` has to follow the rules below:
|
|
*
|
|
* For example:
|
|
*
|
|
* * `http=foopy:80;ftp=foopy2` - Use HTTP proxy `foopy:80` for `http://` URLs, and
|
|
* HTTP proxy `foopy2:80` for `ftp://` URLs.
|
|
* * `foopy:80` - Use HTTP proxy `foopy:80` for all URLs.
|
|
* * `foopy:80,bar,direct://` - Use HTTP proxy `foopy:80` for all URLs, failing
|
|
* over to `bar` if `foopy:80` is unavailable, and after that using no proxy.
|
|
* * `socks4://foopy` - Use SOCKS v4 proxy `foopy:1080` for all URLs.
|
|
* * `http=foopy,socks5://bar.com` - Use HTTP proxy `foopy` for http URLs, and fail
|
|
* over to the SOCKS5 proxy `bar.com` if `foopy` is unavailable.
|
|
* * `http=foopy,direct://` - Use HTTP proxy `foopy` for http URLs, and use no
|
|
* proxy if `foopy` is unavailable.
|
|
* * `http=foopy;socks=foopy2` - Use HTTP proxy `foopy` for http URLs, and use
|
|
* `socks4://foopy2` for all other URLs.
|
|
*
|
|
* The `proxyBypassRules` is a comma separated list of rules described below:
|
|
*
|
|
* * `[ URL_SCHEME "://" ] HOSTNAME_PATTERN [ ":" <port> ]`
|
|
*
|
|
* Match all hostnames that match the pattern HOSTNAME_PATTERN.
|
|
*
|
|
* Examples: "foobar.com", "*foobar.com", "*.foobar.com", "*foobar.com:99",
|
|
* "https://x.*.y.com:99"
|
|
* * `"." HOSTNAME_SUFFIX_PATTERN [ ":" PORT ]`
|
|
*
|
|
* Match a particular domain suffix.
|
|
*
|
|
* Examples: ".google.com", ".com", "http://.google.com"
|
|
* * `[ SCHEME "://" ] IP_LITERAL [ ":" PORT ]`
|
|
*
|
|
* Match URLs which are IP address literals.
|
|
*
|
|
* Examples: "127.0.1", "[0:0::1]", "[::1]", "http://[::1]:99"
|
|
* * `IP_LITERAL "/" PREFIX_LENGTH_IN_BITS`
|
|
*
|
|
* Match any URL that is to an IP literal that falls between the given range. IP
|
|
* range is specified using CIDR notation.
|
|
*
|
|
* Examples: "192.168.1.1/16", "fefe:13::abc/33".
|
|
* * `<local>`
|
|
*
|
|
* Match local addresses. The meaning of `<local>` is whether the host matches one
|
|
* of: "127.0.0.1", "::1", "localhost".
|
|
*/
|
|
setProxy(config: Config): Promise<void>;
|
|
/**
|
|
* By default Electron will download hunspell dictionaries from the Chromium CDN.
|
|
* If you want to override this behavior you can use this API to point the
|
|
* dictionary downloader at your own hosted version of the hunspell dictionaries.
|
|
* We publish a `hunspell_dictionaries.zip` file with each release which contains
|
|
* the files you need to host here.
|
|
*
|
|
* The file server must be **case insensitive**. If you cannot do this, you must
|
|
* upload each file twice: once with the case it has in the ZIP file and once with
|
|
* the filename as all lowercase.
|
|
*
|
|
* If the files present in `hunspell_dictionaries.zip` are available at
|
|
* `https://example.com/dictionaries/language-code.bdic` then you should call this
|
|
* api with
|
|
* `ses.setSpellCheckerDictionaryDownloadURL('https://example.com/dictionaries/')`.
|
|
* Please note the trailing slash. The URL to the dictionaries is formed as
|
|
* `${url}${filename}`.
|
|
*
|
|
* **Note:** On macOS the OS spellchecker is used and therefore we do not download
|
|
* any dictionary files. This API is a no-op on macOS.
|
|
*/
|
|
setSpellCheckerDictionaryDownloadURL(url: string): void;
|
|
/**
|
|
* Sets whether to enable the builtin spell checker.
|
|
*/
|
|
setSpellCheckerEnabled(enable: boolean): void;
|
|
/**
|
|
* The built in spellchecker does not automatically detect what language a user is
|
|
* typing in. In order for the spell checker to correctly check their words you
|
|
* must call this API with an array of language codes. You can get the list of
|
|
* supported language codes with the `ses.availableSpellCheckerLanguages` property.
|
|
*
|
|
* **Note:** On macOS the OS spellchecker is used and will detect your language
|
|
* automatically. This API is a no-op on macOS.
|
|
*/
|
|
setSpellCheckerLanguages(languages: string[]): void;
|
|
/**
|
|
* Sets the SSL configuration for the session. All subsequent network requests will
|
|
* use the new configuration. Existing network connections (such as WebSocket
|
|
* connections) will not be terminated, but old sockets in the pool will not be
|
|
* reused for new connections.
|
|
*/
|
|
setSSLConfig(config: SSLConfigConfig): void;
|
|
/**
|
|
* Sets the handler which can be used to override which USB classes are protected.
|
|
* The return value for the handler is a string array of USB classes which should
|
|
* be considered protected (eg not available in the renderer). Valid values for
|
|
* the array are:
|
|
*
|
|
* * `audio`
|
|
* * `audio-video`
|
|
* * `hid`
|
|
* * `mass-storage`
|
|
* * `smart-card`
|
|
* * `video`
|
|
* * `wireless`
|
|
*
|
|
* Returning an empty string array from the handler will allow all USB classes;
|
|
* returning the passed in array will maintain the default list of protected USB
|
|
* classes (this is also the default behavior if a handler is not defined). To
|
|
* clear the handler, call `setUSBProtectedClassesHandler(null)`.
|
|
*/
|
|
setUSBProtectedClassesHandler(handler: ((details: USBProtectedClassesHandlerHandlerDetails) => string[]) | (null)): void;
|
|
/**
|
|
* Overrides the `userAgent` and `acceptLanguages` for this session.
|
|
*
|
|
* The `acceptLanguages` must a comma separated ordered list of language codes, for
|
|
* example `"en-US,fr,de,ko,zh-CN,ja"`.
|
|
*
|
|
* This doesn't affect existing `WebContents`, and each `WebContents` can use
|
|
* `webContents.setUserAgent` to override the session-wide user agent.
|
|
*/
|
|
setUserAgent(userAgent: string, acceptLanguages?: string): void;
|
|
/**
|
|
* A `string[]` array which consists of all the known available spell checker
|
|
* languages. Providing a language code to the `setSpellCheckerLanguages` API that
|
|
* isn't in this array will result in an error.
|
|
*
|
|
*/
|
|
readonly availableSpellCheckerLanguages: string[];
|
|
/**
|
|
* A `Cookies` object for this session.
|
|
*
|
|
*/
|
|
readonly cookies: Cookies;
|
|
/**
|
|
* A `NetLog` object for this session.
|
|
*
|
|
*/
|
|
readonly netLog: NetLog;
|
|
/**
|
|
* A `Protocol` object for this session.
|
|
*
|
|
*/
|
|
readonly protocol: Protocol;
|
|
/**
|
|
* A `ServiceWorkers` object for this session.
|
|
*
|
|
*/
|
|
readonly serviceWorkers: ServiceWorkers;
|
|
/**
|
|
* A `boolean` indicating whether builtin spell checker is enabled.
|
|
*/
|
|
spellCheckerEnabled: boolean;
|
|
/**
|
|
* A `string | null` indicating the absolute file system path where data for this
|
|
* session is persisted on disk. For in memory sessions this returns `null`.
|
|
*
|
|
*/
|
|
readonly storagePath: (string) | (null);
|
|
/**
|
|
* A `WebRequest` object for this session.
|
|
*
|
|
*/
|
|
readonly webRequest: WebRequest;
|
|
}
|
|
|
|
interface SharedWorkerInfo {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/shared-worker-info
|
|
|
|
/**
|
|
* The unique id of the shared worker.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* The url of the shared worker.
|
|
*/
|
|
url: string;
|
|
}
|
|
|
|
class ShareMenu extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/share-menu
|
|
|
|
/**
|
|
* ShareMenu
|
|
*/
|
|
constructor(sharingItem: SharingItem);
|
|
/**
|
|
* Closes the context menu in the `browserWindow`.
|
|
*/
|
|
closePopup(browserWindow?: BrowserWindow): void;
|
|
/**
|
|
* Pops up this menu as a context menu in the `BrowserWindow`.
|
|
*/
|
|
popup(options?: PopupOptions): void;
|
|
}
|
|
|
|
interface SharingItem {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/sharing-item
|
|
|
|
/**
|
|
* An array of files to share.
|
|
*/
|
|
filePaths?: string[];
|
|
/**
|
|
* An array of text to share.
|
|
*/
|
|
texts?: string[];
|
|
/**
|
|
* An array of URLs to share.
|
|
*/
|
|
urls?: string[];
|
|
}
|
|
|
|
interface Shell {
|
|
|
|
// Docs: https://electronjs.org/docs/api/shell
|
|
|
|
/**
|
|
* Play the beep sound.
|
|
*/
|
|
beep(): void;
|
|
/**
|
|
* Open the given external protocol URL in the desktop's default manner. (For
|
|
* example, mailto: URLs in the user's default mail agent).
|
|
*/
|
|
openExternal(url: string, options?: OpenExternalOptions): Promise<void>;
|
|
/**
|
|
* Resolves with a string containing the error message corresponding to the failure
|
|
* if a failure occurred, otherwise "".
|
|
*
|
|
* Open the given file in the desktop's default manner.
|
|
*/
|
|
openPath(path: string): Promise<string>;
|
|
/**
|
|
* Resolves the shortcut link at `shortcutPath`.
|
|
*
|
|
* An exception will be thrown when any error happens.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
readShortcutLink(shortcutPath: string): ShortcutDetails;
|
|
/**
|
|
* Show the given file in a file manager. If possible, select the file.
|
|
*/
|
|
showItemInFolder(fullPath: string): void;
|
|
/**
|
|
* Resolves when the operation has been completed. Rejects if there was an error
|
|
* while deleting the requested item.
|
|
*
|
|
* This moves a path to the OS-specific trash location (Trash on macOS, Recycle Bin
|
|
* on Windows, and a desktop-environment-specific location on Linux).
|
|
*/
|
|
trashItem(path: string): Promise<void>;
|
|
/**
|
|
* Whether the shortcut was created successfully.
|
|
*
|
|
* Creates or updates a shortcut link at `shortcutPath`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
writeShortcutLink(shortcutPath: string, operation: 'create' | 'update' | 'replace', options: ShortcutDetails): boolean;
|
|
/**
|
|
* Whether the shortcut was created successfully.
|
|
*
|
|
* Creates or updates a shortcut link at `shortcutPath`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
writeShortcutLink(shortcutPath: string, options: ShortcutDetails): boolean;
|
|
}
|
|
|
|
interface ShortcutDetails {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/shortcut-details
|
|
|
|
/**
|
|
* The Application User Model ID. Default is empty.
|
|
*/
|
|
appUserModelId?: string;
|
|
/**
|
|
* The arguments to be applied to `target` when launching from this shortcut.
|
|
* Default is empty.
|
|
*/
|
|
args?: string;
|
|
/**
|
|
* The working directory. Default is empty.
|
|
*/
|
|
cwd?: string;
|
|
/**
|
|
* The description of the shortcut. Default is empty.
|
|
*/
|
|
description?: string;
|
|
/**
|
|
* The path to the icon, can be a DLL or EXE. `icon` and `iconIndex` have to be set
|
|
* together. Default is empty, which uses the target's icon.
|
|
*/
|
|
icon?: string;
|
|
/**
|
|
* The resource ID of icon when `icon` is a DLL or EXE. Default is 0.
|
|
*/
|
|
iconIndex?: number;
|
|
/**
|
|
* The target to launch from this shortcut.
|
|
*/
|
|
target: string;
|
|
/**
|
|
* The Application Toast Activator CLSID. Needed for participating in Action
|
|
* Center.
|
|
*/
|
|
toastActivatorClsid?: string;
|
|
}
|
|
|
|
interface Size {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/size
|
|
|
|
height: number;
|
|
width: number;
|
|
}
|
|
|
|
interface SystemPreferences extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/system-preferences
|
|
|
|
/**
|
|
* @platform win32
|
|
*/
|
|
on(event: 'accent-color-changed', listener: (event: Event,
|
|
/**
|
|
* The new RGBA color the user assigned to be their system accent color.
|
|
*/
|
|
newColor: string) => void): this;
|
|
once(event: 'accent-color-changed', listener: (event: Event,
|
|
/**
|
|
* The new RGBA color the user assigned to be their system accent color.
|
|
*/
|
|
newColor: string) => void): this;
|
|
addListener(event: 'accent-color-changed', listener: (event: Event,
|
|
/**
|
|
* The new RGBA color the user assigned to be their system accent color.
|
|
*/
|
|
newColor: string) => void): this;
|
|
removeListener(event: 'accent-color-changed', listener: (event: Event,
|
|
/**
|
|
* The new RGBA color the user assigned to be their system accent color.
|
|
*/
|
|
newColor: string) => void): this;
|
|
/**
|
|
* @platform win32
|
|
*/
|
|
on(event: 'color-changed', listener: (event: Event) => void): this;
|
|
once(event: 'color-changed', listener: (event: Event) => void): this;
|
|
addListener(event: 'color-changed', listener: (event: Event) => void): this;
|
|
removeListener(event: 'color-changed', listener: (event: Event) => void): this;
|
|
/**
|
|
* A promise that resolves with `true` if consent was granted and `false` if it was
|
|
* denied. If an invalid `mediaType` is passed, the promise will be rejected. If an
|
|
* access request was denied and later is changed through the System Preferences
|
|
* pane, a restart of the app will be required for the new permissions to take
|
|
* effect. If access has already been requested and denied, it _must_ be changed
|
|
* through the preference pane; an alert will not pop up and the promise will
|
|
* resolve with the existing access status.
|
|
*
|
|
* **Important:** In order to properly leverage this API, you must set the
|
|
* `NSMicrophoneUsageDescription` and `NSCameraUsageDescription` strings in your
|
|
* app's `Info.plist` file. The values for these keys will be used to populate the
|
|
* permission dialogs so that the user will be properly informed as to the purpose
|
|
* of the permission request. See Electron Application Distribution for more
|
|
* information about how to set these in the context of Electron.
|
|
*
|
|
* This user consent was not required until macOS 10.14 Mojave, so this method will
|
|
* always return `true` if your system is running 10.13 High Sierra.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
askForMediaAccess(mediaType: 'microphone' | 'camera'): Promise<boolean>;
|
|
/**
|
|
* whether or not this device has the ability to use Touch ID.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
canPromptTouchID(): boolean;
|
|
/**
|
|
* The users current system wide accent color preference in RGBA hexadecimal form.
|
|
*
|
|
* This API is only available on macOS 10.14 Mojave or newer.
|
|
*
|
|
* @platform win32,darwin
|
|
*/
|
|
getAccentColor(): string;
|
|
/**
|
|
* * `shouldRenderRichAnimation` boolean - Returns true if rich animations should
|
|
* be rendered. Looks at session type (e.g. remote desktop) and accessibility
|
|
* settings to give guidance for heavy animations.
|
|
* * `scrollAnimationsEnabledBySystem` boolean - Determines on a per-platform basis
|
|
* whether scroll animations (e.g. produced by home/end key) should be enabled.
|
|
* * `prefersReducedMotion` boolean - Determines whether the user desires reduced
|
|
* motion based on platform APIs.
|
|
*
|
|
* Returns an object with system animation settings.
|
|
*/
|
|
getAnimationSettings(): AnimationSettings;
|
|
/**
|
|
* The system color setting in RGB hexadecimal form (`#ABCDEF`). See the Windows
|
|
* docs and the macOS docs for more details.
|
|
*
|
|
* The following colors are only available on macOS 10.14: `find-highlight`,
|
|
* `selected-content-background`, `separator`,
|
|
* `unemphasized-selected-content-background`,
|
|
* `unemphasized-selected-text-background`, and `unemphasized-selected-text`.
|
|
*
|
|
* @platform win32,darwin
|
|
*/
|
|
getColor(color: '3d-dark-shadow' | '3d-face' | '3d-highlight' | '3d-light' | '3d-shadow' | 'active-border' | 'active-caption' | 'active-caption-gradient' | 'app-workspace' | 'button-text' | 'caption-text' | 'desktop' | 'disabled-text' | 'highlight' | 'highlight-text' | 'hotlight' | 'inactive-border' | 'inactive-caption' | 'inactive-caption-gradient' | 'inactive-caption-text' | 'info-background' | 'info-text' | 'menu' | 'menu-highlight' | 'menubar' | 'menu-text' | 'scrollbar' | 'window' | 'window-frame' | 'window-text' | 'control-background' | 'control' | 'control-text' | 'disabled-control-text' | 'find-highlight' | 'grid' | 'header-text' | 'highlight' | 'keyboard-focus-indicator' | 'label' | 'link' | 'placeholder-text' | 'quaternary-label' | 'scrubber-textured-background' | 'secondary-label' | 'selected-content-background' | 'selected-control' | 'selected-control-text' | 'selected-menu-item-text' | 'selected-text-background' | 'selected-text' | 'separator' | 'shadow' | 'tertiary-label' | 'text-background' | 'text' | 'under-page-background' | 'unemphasized-selected-content-background' | 'unemphasized-selected-text-background' | 'unemphasized-selected-text' | 'window-background' | 'window-frame-text'): string;
|
|
/**
|
|
* Can be `dark`, `light` or `unknown`.
|
|
*
|
|
* Gets the macOS appearance setting that is currently applied to your application,
|
|
* maps to NSApplication.effectiveAppearance
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getEffectiveAppearance(): ('dark' | 'light' | 'unknown');
|
|
/**
|
|
* Can be `not-determined`, `granted`, `denied`, `restricted` or `unknown`.
|
|
*
|
|
* This user consent was not required on macOS 10.13 High Sierra so this method
|
|
* will always return `granted`. macOS 10.14 Mojave or higher requires consent for
|
|
* `microphone` and `camera` access. macOS 10.15 Catalina or higher requires
|
|
* consent for `screen` access.
|
|
*
|
|
* Windows 10 has a global setting controlling `microphone` and `camera` access for
|
|
* all win32 applications. It will always return `granted` for `screen` and for all
|
|
* media types on older versions of Windows.
|
|
*
|
|
* @platform win32,darwin
|
|
*/
|
|
getMediaAccessStatus(mediaType: 'microphone' | 'camera' | 'screen'): ('not-determined' | 'granted' | 'denied' | 'restricted' | 'unknown');
|
|
/**
|
|
* The standard system color formatted as `#RRGGBBAA`.
|
|
*
|
|
* Returns one of several standard system colors that automatically adapt to
|
|
* vibrancy and changes in accessibility settings like 'Increase contrast' and
|
|
* 'Reduce transparency'. See Apple Documentation for more details.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getSystemColor(color: 'blue' | 'brown' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'yellow'): string;
|
|
/**
|
|
* The value of `key` in `NSUserDefaults`.
|
|
*
|
|
* Some popular `key` and `type`s are:
|
|
*
|
|
* * `AppleInterfaceStyle`: `string`
|
|
* * `AppleAquaColorVariant`: `integer`
|
|
* * `AppleHighlightColor`: `string`
|
|
* * `AppleShowScrollBars`: `string`
|
|
* * `NSNavRecentPlaces`: `array`
|
|
* * `NSPreferredWebServices`: `dictionary`
|
|
* * `NSUserDictionaryReplacementItems`: `array`
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getUserDefault<Type extends keyof UserDefaultTypes>(key: string, type: Type): UserDefaultTypes[Type];
|
|
/**
|
|
* `true` if DWM composition (Aero Glass) is enabled, and `false` otherwise.
|
|
*
|
|
* An example of using it to determine if you should create a transparent window or
|
|
* not (transparent windows won't work correctly when DWM composition is disabled):
|
|
*
|
|
* @platform win32
|
|
*/
|
|
isAeroGlassEnabled(): boolean;
|
|
/**
|
|
* Whether the Swipe between pages setting is on.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isSwipeTrackingFromScrollEventsEnabled(): boolean;
|
|
/**
|
|
* `true` if the current process is a trusted accessibility client and `false` if
|
|
* it is not.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
isTrustedAccessibilityClient(prompt: boolean): boolean;
|
|
/**
|
|
* Posts `event` as native notifications of macOS. The `userInfo` is an Object that
|
|
* contains the user information dictionary sent along with the notification.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
postLocalNotification(event: string, userInfo: Record<string, any>): void;
|
|
/**
|
|
* Posts `event` as native notifications of macOS. The `userInfo` is an Object that
|
|
* contains the user information dictionary sent along with the notification.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
postNotification(event: string, userInfo: Record<string, any>, deliverImmediately?: boolean): void;
|
|
/**
|
|
* Posts `event` as native notifications of macOS. The `userInfo` is an Object that
|
|
* contains the user information dictionary sent along with the notification.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
postWorkspaceNotification(event: string, userInfo: Record<string, any>): void;
|
|
/**
|
|
* resolves if the user has successfully authenticated with Touch ID.
|
|
*
|
|
* This API itself will not protect your user data; rather, it is a mechanism to
|
|
* allow you to do so. Native apps will need to set Access Control Constants like
|
|
* `kSecAccessControlUserPresence` on their keychain entry so that reading it would
|
|
* auto-prompt for Touch ID biometric consent. This could be done with
|
|
* `node-keytar`, such that one would store an encryption key with `node-keytar`
|
|
* and only fetch it if `promptTouchID()` resolves.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
promptTouchID(reason: string): Promise<void>;
|
|
/**
|
|
* Add the specified defaults to your application's `NSUserDefaults`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
registerDefaults(defaults: Record<string, (string) | (boolean) | (number)>): void;
|
|
/**
|
|
* Removes the `key` in `NSUserDefaults`. This can be used to restore the default
|
|
* or global value of a `key` previously set with `setUserDefault`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
removeUserDefault(key: string): void;
|
|
/**
|
|
* Set the value of `key` in `NSUserDefaults`.
|
|
*
|
|
* Note that `type` should match actual type of `value`. An exception is thrown if
|
|
* they don't.
|
|
*
|
|
* Some popular `key` and `type`s are:
|
|
*
|
|
* * `ApplePressAndHoldEnabled`: `boolean`
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setUserDefault<Type extends keyof UserDefaultTypes>(key: string, type: Type, value: UserDefaultTypes[Type]): void;
|
|
/**
|
|
* The ID of this subscription
|
|
*
|
|
* Same as `subscribeNotification`, but uses `NSNotificationCenter` for local
|
|
* defaults. This is necessary for events such as
|
|
* `NSUserDefaultsDidChangeNotification`.
|
|
*
|
|
* If `event` is null, the `NSNotificationCenter` doesn’t use it as criteria for
|
|
* delivery to the observer. See docs for more information.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
subscribeLocalNotification(event: (string) | (null), callback: (event: string, userInfo: Record<string, unknown>, object: string) => void): number;
|
|
/**
|
|
* The ID of this subscription
|
|
*
|
|
* Subscribes to native notifications of macOS, `callback` will be called with
|
|
* `callback(event, userInfo)` when the corresponding `event` happens. The
|
|
* `userInfo` is an Object that contains the user information dictionary sent along
|
|
* with the notification. The `object` is the sender of the notification, and only
|
|
* supports `NSString` values for now.
|
|
*
|
|
* The `id` of the subscriber is returned, which can be used to unsubscribe the
|
|
* `event`.
|
|
*
|
|
* Under the hood this API subscribes to `NSDistributedNotificationCenter`, example
|
|
* values of `event` are:
|
|
*
|
|
* * `AppleInterfaceThemeChangedNotification`
|
|
* * `AppleAquaColorVariantChanged`
|
|
* * `AppleColorPreferencesChangedNotification`
|
|
* * `AppleShowScrollBarsSettingChanged`
|
|
*
|
|
* If `event` is null, the `NSDistributedNotificationCenter` doesn’t use it as
|
|
* criteria for delivery to the observer. See docs for more information.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
subscribeNotification(event: (string) | (null), callback: (event: string, userInfo: Record<string, unknown>, object: string) => void): number;
|
|
/**
|
|
* The ID of this subscription
|
|
*
|
|
* Same as `subscribeNotification`, but uses
|
|
* `NSWorkspace.sharedWorkspace.notificationCenter`. This is necessary for events
|
|
* such as `NSWorkspaceDidActivateApplicationNotification`.
|
|
*
|
|
* If `event` is null, the `NSWorkspaceNotificationCenter` doesn’t use it as
|
|
* criteria for delivery to the observer. See docs for more information.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
subscribeWorkspaceNotification(event: (string) | (null), callback: (event: string, userInfo: Record<string, unknown>, object: string) => void): number;
|
|
/**
|
|
* Same as `unsubscribeNotification`, but removes the subscriber from
|
|
* `NSNotificationCenter`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
unsubscribeLocalNotification(id: number): void;
|
|
/**
|
|
* Removes the subscriber with `id`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
unsubscribeNotification(id: number): void;
|
|
/**
|
|
* Same as `unsubscribeNotification`, but removes the subscriber from
|
|
* `NSWorkspace.sharedWorkspace.notificationCenter`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
unsubscribeWorkspaceNotification(id: number): void;
|
|
/**
|
|
* A `boolean` property which determines whether the app avoids using
|
|
* semitransparent backgrounds. This maps to
|
|
* NSWorkspace.accessibilityDisplayShouldReduceTransparency
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
accessibilityDisplayShouldReduceTransparency(): boolean;
|
|
/**
|
|
* A `string` property that can be `dark`, `light` or `unknown`.
|
|
*
|
|
* Returns the macOS appearance setting that is currently applied to your
|
|
* application, maps to NSApplication.effectiveAppearance
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
readonly effectiveAppearance: ('dark' | 'light' | 'unknown');
|
|
}
|
|
|
|
interface Task {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/task
|
|
|
|
/**
|
|
* The command line arguments when `program` is executed.
|
|
*/
|
|
arguments: string;
|
|
/**
|
|
* Description of this task.
|
|
*/
|
|
description: string;
|
|
/**
|
|
* The icon index in the icon file. If an icon file consists of two or more icons,
|
|
* set this value to identify the icon. If an icon file consists of one icon, this
|
|
* value is 0.
|
|
*/
|
|
iconIndex: number;
|
|
/**
|
|
* The absolute path to an icon to be displayed in a JumpList, which can be an
|
|
* arbitrary resource file that contains an icon. You can usually specify
|
|
* `process.execPath` to show the icon of the program.
|
|
*/
|
|
iconPath: string;
|
|
/**
|
|
* Path of the program to execute, usually you should specify `process.execPath`
|
|
* which opens the current program.
|
|
*/
|
|
program: string;
|
|
/**
|
|
* The string to be displayed in a JumpList.
|
|
*/
|
|
title: string;
|
|
/**
|
|
* The working directory. Default is empty.
|
|
*/
|
|
workingDirectory?: string;
|
|
}
|
|
|
|
interface ThumbarButton {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/thumbar-button
|
|
|
|
click: () => void;
|
|
/**
|
|
* Control specific states and behaviors of the button. By default, it is
|
|
* `['enabled']`.
|
|
*/
|
|
flags?: string[];
|
|
/**
|
|
* The icon showing in thumbnail toolbar.
|
|
*/
|
|
icon: NativeImage;
|
|
/**
|
|
* The text of the button's tooltip.
|
|
*/
|
|
tooltip?: string;
|
|
}
|
|
|
|
class TouchBar {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar
|
|
|
|
/**
|
|
* TouchBar
|
|
*/
|
|
constructor(options: TouchBarConstructorOptions);
|
|
/**
|
|
* A `TouchBarItem` that will replace the "esc" button on the touch bar when set.
|
|
* Setting to `null` restores the default "esc" button. Changing this value
|
|
* immediately updates the escape item in the touch bar.
|
|
*/
|
|
escapeItem: (TouchBarButton | TouchBarColorPicker | TouchBarGroup | TouchBarLabel | TouchBarPopover | TouchBarScrubber | TouchBarSegmentedControl | TouchBarSlider | TouchBarSpacer | null);
|
|
/**
|
|
* A `typeof TouchBarButton` reference to the `TouchBarButton` class.
|
|
*/
|
|
static TouchBarButton: typeof TouchBarButton;
|
|
/**
|
|
* A `typeof TouchBarColorPicker` reference to the `TouchBarColorPicker` class.
|
|
*/
|
|
static TouchBarColorPicker: typeof TouchBarColorPicker;
|
|
/**
|
|
* A `typeof TouchBarGroup` reference to the `TouchBarGroup` class.
|
|
*/
|
|
static TouchBarGroup: typeof TouchBarGroup;
|
|
/**
|
|
* A `typeof TouchBarLabel` reference to the `TouchBarLabel` class.
|
|
*/
|
|
static TouchBarLabel: typeof TouchBarLabel;
|
|
/**
|
|
* A `typeof TouchBarOtherItemsProxy` reference to the `TouchBarOtherItemsProxy`
|
|
* class.
|
|
*/
|
|
static TouchBarOtherItemsProxy: typeof TouchBarOtherItemsProxy;
|
|
/**
|
|
* A `typeof TouchBarPopover` reference to the `TouchBarPopover` class.
|
|
*/
|
|
static TouchBarPopover: typeof TouchBarPopover;
|
|
/**
|
|
* A `typeof TouchBarScrubber` reference to the `TouchBarScrubber` class.
|
|
*/
|
|
static TouchBarScrubber: typeof TouchBarScrubber;
|
|
/**
|
|
* A `typeof TouchBarSegmentedControl` reference to the `TouchBarSegmentedControl`
|
|
* class.
|
|
*/
|
|
static TouchBarSegmentedControl: typeof TouchBarSegmentedControl;
|
|
/**
|
|
* A `typeof TouchBarSlider` reference to the `TouchBarSlider` class.
|
|
*/
|
|
static TouchBarSlider: typeof TouchBarSlider;
|
|
/**
|
|
* A `typeof TouchBarSpacer` reference to the `TouchBarSpacer` class.
|
|
*/
|
|
static TouchBarSpacer: typeof TouchBarSpacer;
|
|
}
|
|
|
|
class TouchBarButton {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-button
|
|
|
|
/**
|
|
* TouchBarButton
|
|
*/
|
|
constructor(options: TouchBarButtonConstructorOptions);
|
|
/**
|
|
* A `string` representing the description of the button to be read by a screen
|
|
* reader. Will only be read by screen readers if no label is set.
|
|
*/
|
|
accessibilityLabel: string;
|
|
/**
|
|
* A `string` hex code representing the button's current background color. Changing
|
|
* this value immediately updates the button in the touch bar.
|
|
*/
|
|
backgroundColor: string;
|
|
/**
|
|
* A `boolean` representing whether the button is in an enabled state.
|
|
*/
|
|
enabled: boolean;
|
|
/**
|
|
* A `NativeImage` representing the button's current icon. Changing this value
|
|
* immediately updates the button in the touch bar.
|
|
*/
|
|
icon: NativeImage;
|
|
/**
|
|
* A `string` - Can be `left`, `right` or `overlay`. Defaults to `overlay`.
|
|
*/
|
|
iconPosition: ('left' | 'right' | 'overlay');
|
|
/**
|
|
* A `string` representing the button's current text. Changing this value
|
|
* immediately updates the button in the touch bar.
|
|
*/
|
|
label: string;
|
|
}
|
|
|
|
class TouchBarColorPicker extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-color-picker
|
|
|
|
/**
|
|
* TouchBarColorPicker
|
|
*/
|
|
constructor(options: TouchBarColorPickerConstructorOptions);
|
|
/**
|
|
* A `string[]` array representing the color picker's available colors to select.
|
|
* Changing this value immediately updates the color picker in the touch bar.
|
|
*/
|
|
availableColors: string[];
|
|
/**
|
|
* A `string` hex code representing the color picker's currently selected color.
|
|
* Changing this value immediately updates the color picker in the touch bar.
|
|
*/
|
|
selectedColor: string;
|
|
}
|
|
|
|
class TouchBarGroup extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-group
|
|
|
|
/**
|
|
* TouchBarGroup
|
|
*/
|
|
constructor(options: TouchBarGroupConstructorOptions);
|
|
}
|
|
|
|
class TouchBarLabel extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-label
|
|
|
|
/**
|
|
* TouchBarLabel
|
|
*/
|
|
constructor(options: TouchBarLabelConstructorOptions);
|
|
/**
|
|
* A `string` representing the description of the label to be read by a screen
|
|
* reader.
|
|
*/
|
|
accessibilityLabel: string;
|
|
/**
|
|
* A `string` representing the label's current text. Changing this value
|
|
* immediately updates the label in the touch bar.
|
|
*/
|
|
label: string;
|
|
/**
|
|
* A `string` hex code representing the label's current text color. Changing this
|
|
* value immediately updates the label in the touch bar.
|
|
*/
|
|
textColor: string;
|
|
}
|
|
|
|
class TouchBarOtherItemsProxy extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-other-items-proxy
|
|
|
|
/**
|
|
* TouchBarOtherItemsProxy
|
|
*/
|
|
constructor();
|
|
}
|
|
|
|
class TouchBarPopover extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-popover
|
|
|
|
/**
|
|
* TouchBarPopover
|
|
*/
|
|
constructor(options: TouchBarPopoverConstructorOptions);
|
|
/**
|
|
* A `NativeImage` representing the popover's current button icon. Changing this
|
|
* value immediately updates the popover in the touch bar.
|
|
*/
|
|
icon: NativeImage;
|
|
/**
|
|
* A `string` representing the popover's current button text. Changing this value
|
|
* immediately updates the popover in the touch bar.
|
|
*/
|
|
label: string;
|
|
}
|
|
|
|
class TouchBarScrubber extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-scrubber
|
|
|
|
/**
|
|
* TouchBarScrubber
|
|
*/
|
|
constructor(options: TouchBarScrubberConstructorOptions);
|
|
/**
|
|
* A `boolean` representing whether this scrubber is continuous or not. Updating
|
|
* this value immediately updates the control in the touch bar.
|
|
*/
|
|
continuous: boolean;
|
|
/**
|
|
* A `ScrubberItem[]` array representing the items in this scrubber. Updating this
|
|
* value immediately updates the control in the touch bar. Updating deep properties
|
|
* inside this array **does not update the touch bar**.
|
|
*/
|
|
items: ScrubberItem[];
|
|
/**
|
|
* A `string` representing the mode of this scrubber. Updating this value
|
|
* immediately updates the control in the touch bar. Possible values:
|
|
*
|
|
* * `fixed` - Maps to `NSScrubberModeFixed`.
|
|
* * `free` - Maps to `NSScrubberModeFree`.
|
|
*/
|
|
mode: ('fixed' | 'free');
|
|
/**
|
|
* A `string` representing the style that selected items in the scrubber should
|
|
* have. This style is overlayed on top of the scrubber item instead of being
|
|
* placed behind it. Updating this value immediately updates the control in the
|
|
* touch bar. Possible values:
|
|
*
|
|
* * `background` - Maps to `[NSScrubberSelectionStyle roundedBackgroundStyle]`.
|
|
* * `outline` - Maps to `[NSScrubberSelectionStyle outlineOverlayStyle]`.
|
|
* * `none` - Removes all styles.
|
|
*/
|
|
overlayStyle: ('background' | 'outline' | 'none');
|
|
/**
|
|
* A `string` representing the style that selected items in the scrubber should
|
|
* have. Updating this value immediately updates the control in the touch bar.
|
|
* Possible values:
|
|
*
|
|
* * `background` - Maps to `[NSScrubberSelectionStyle roundedBackgroundStyle]`.
|
|
* * `outline` - Maps to `[NSScrubberSelectionStyle outlineOverlayStyle]`.
|
|
* * `none` - Removes all styles.
|
|
*/
|
|
selectedStyle: ('background' | 'outline' | 'none');
|
|
/**
|
|
* A `boolean` representing whether to show the left / right selection arrows in
|
|
* this scrubber. Updating this value immediately updates the control in the touch
|
|
* bar.
|
|
*/
|
|
showArrowButtons: boolean;
|
|
}
|
|
|
|
class TouchBarSegmentedControl extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-segmented-control
|
|
|
|
/**
|
|
* TouchBarSegmentedControl
|
|
*/
|
|
constructor(options: TouchBarSegmentedControlConstructorOptions);
|
|
/**
|
|
* A `string` representing the current selection mode of the control. Can be
|
|
* `single`, `multiple` or `buttons`.
|
|
*/
|
|
mode: ('single' | 'multiple' | 'buttons');
|
|
/**
|
|
* A `SegmentedControlSegment[]` array representing the segments in this control.
|
|
* Updating this value immediately updates the control in the touch bar. Updating
|
|
* deep properties inside this array **does not update the touch bar**.
|
|
*/
|
|
segments: SegmentedControlSegment[];
|
|
/**
|
|
* A `string` representing the controls current segment style. Updating this value
|
|
* immediately updates the control in the touch bar.
|
|
*/
|
|
segmentStyle: string;
|
|
/**
|
|
* An `Integer` representing the currently selected segment. Changing this value
|
|
* immediately updates the control in the touch bar. User interaction with the
|
|
* touch bar will update this value automatically.
|
|
*/
|
|
selectedIndex: number;
|
|
}
|
|
|
|
class TouchBarSlider extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-slider
|
|
|
|
/**
|
|
* TouchBarSlider
|
|
*/
|
|
constructor(options: TouchBarSliderConstructorOptions);
|
|
/**
|
|
* A `string` representing the slider's current text. Changing this value
|
|
* immediately updates the slider in the touch bar.
|
|
*/
|
|
label: string;
|
|
/**
|
|
* A `number` representing the slider's current maximum value. Changing this value
|
|
* immediately updates the slider in the touch bar.
|
|
*/
|
|
maxValue: number;
|
|
/**
|
|
* A `number` representing the slider's current minimum value. Changing this value
|
|
* immediately updates the slider in the touch bar.
|
|
*/
|
|
minValue: number;
|
|
/**
|
|
* A `number` representing the slider's current value. Changing this value
|
|
* immediately updates the slider in the touch bar.
|
|
*/
|
|
value: number;
|
|
}
|
|
|
|
class TouchBarSpacer extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/touch-bar-spacer
|
|
|
|
/**
|
|
* TouchBarSpacer
|
|
*/
|
|
constructor(options: TouchBarSpacerConstructorOptions);
|
|
/**
|
|
* A `string` representing the size of the spacer. Can be `small`, `large` or
|
|
* `flexible`.
|
|
*/
|
|
size: ('small' | 'large' | 'flexible');
|
|
}
|
|
|
|
interface TraceCategoriesAndOptions {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/trace-categories-and-options
|
|
|
|
/**
|
|
* A filter to control what category groups should be traced. A filter can have an
|
|
* optional '-' prefix to exclude category groups that contain a matching category.
|
|
* Having both included and excluded category patterns in the same list is not
|
|
* supported. Examples: `test_MyTest*`, `test_MyTest*,test_OtherStuff`,
|
|
* `-excluded_category1,-excluded_category2`.
|
|
*/
|
|
categoryFilter: string;
|
|
/**
|
|
* Controls what kind of tracing is enabled, it is a comma-delimited sequence of
|
|
* the following strings: `record-until-full`, `record-continuously`,
|
|
* `trace-to-console`, `enable-sampling`, `enable-systrace`, e.g.
|
|
* `'record-until-full,enable-sampling'`. The first 3 options are trace recording
|
|
* modes and hence mutually exclusive. If more than one trace recording modes
|
|
* appear in the `traceOptions` string, the last one takes precedence. If none of
|
|
* the trace recording modes are specified, recording mode is `record-until-full`.
|
|
* The trace option will first be reset to the default option (`record_mode` set to
|
|
* `record-until-full`, `enable_sampling` and `enable_systrace` set to `false`)
|
|
* before options parsed from `traceOptions` are applied on it.
|
|
*/
|
|
traceOptions: string;
|
|
}
|
|
|
|
interface TraceConfig {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/trace-config
|
|
|
|
/**
|
|
* if true, filter event data according to a specific list of events that have been
|
|
* manually vetted to not include any PII. See the implementation in Chromium for
|
|
* specifics.
|
|
*/
|
|
enable_argument_filter?: boolean;
|
|
/**
|
|
* a list of tracing categories to exclude. Can include glob-like patterns using
|
|
* `*` at the end of the category name. See tracing categories for the list of
|
|
* categories.
|
|
*/
|
|
excluded_categories?: string[];
|
|
/**
|
|
* a list of histogram names to report with the trace.
|
|
*/
|
|
histogram_names?: string[];
|
|
/**
|
|
* a list of tracing categories to include. Can include glob-like patterns using
|
|
* `*` at the end of the category name. See tracing categories for the list of
|
|
* categories.
|
|
*/
|
|
included_categories?: string[];
|
|
/**
|
|
* a list of process IDs to include in the trace. If not specified, trace all
|
|
* processes.
|
|
*/
|
|
included_process_ids?: number[];
|
|
/**
|
|
* if the `disabled-by-default-memory-infra` category is enabled, this contains
|
|
* optional additional configuration for data collection. See the Chromium
|
|
* memory-infra docs for more information.
|
|
*/
|
|
memory_dump_config?: Record<string, any>;
|
|
/**
|
|
* Can be `record-until-full`, `record-continuously`, `record-as-much-as-possible`
|
|
* or `trace-to-console`. Defaults to `record-until-full`.
|
|
*/
|
|
recording_mode?: ('record-until-full' | 'record-continuously' | 'record-as-much-as-possible' | 'trace-to-console');
|
|
/**
|
|
* maximum size of the trace recording buffer in events.
|
|
*/
|
|
trace_buffer_size_in_events?: number;
|
|
/**
|
|
* maximum size of the trace recording buffer in kilobytes. Defaults to 100MB.
|
|
*/
|
|
trace_buffer_size_in_kb?: number;
|
|
}
|
|
|
|
interface Transaction {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/transaction
|
|
|
|
/**
|
|
* The error code if an error occurred while processing the transaction.
|
|
*/
|
|
errorCode: number;
|
|
/**
|
|
* The error message if an error occurred while processing the transaction.
|
|
*/
|
|
errorMessage: string;
|
|
/**
|
|
* The identifier of the restored transaction by the App Store.
|
|
*/
|
|
originalTransactionIdentifier: string;
|
|
payment: Payment;
|
|
/**
|
|
* The date the transaction was added to the App Store’s payment queue.
|
|
*/
|
|
transactionDate: string;
|
|
/**
|
|
* A string that uniquely identifies a successful payment transaction.
|
|
*/
|
|
transactionIdentifier: string;
|
|
/**
|
|
* The transaction state, can be `purchasing`, `purchased`, `failed`, `restored` or
|
|
* `deferred`.
|
|
*/
|
|
transactionState: ('purchasing' | 'purchased' | 'failed' | 'restored' | 'deferred');
|
|
}
|
|
|
|
class Tray extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/tray
|
|
|
|
/**
|
|
* Emitted when the tray balloon is clicked.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
on(event: 'balloon-click', listener: Function): this;
|
|
once(event: 'balloon-click', listener: Function): this;
|
|
addListener(event: 'balloon-click', listener: Function): this;
|
|
removeListener(event: 'balloon-click', listener: Function): this;
|
|
/**
|
|
* Emitted when the tray balloon is closed because of timeout or user manually
|
|
* closes it.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
on(event: 'balloon-closed', listener: Function): this;
|
|
once(event: 'balloon-closed', listener: Function): this;
|
|
addListener(event: 'balloon-closed', listener: Function): this;
|
|
removeListener(event: 'balloon-closed', listener: Function): this;
|
|
/**
|
|
* Emitted when the tray balloon shows.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
on(event: 'balloon-show', listener: Function): this;
|
|
once(event: 'balloon-show', listener: Function): this;
|
|
addListener(event: 'balloon-show', listener: Function): this;
|
|
removeListener(event: 'balloon-show', listener: Function): this;
|
|
/**
|
|
* Emitted when the tray icon is clicked.
|
|
*
|
|
* Note that on Linux this event is emitted when the tray icon receives an
|
|
* activation, which might not necessarily be left mouse click.
|
|
*/
|
|
on(event: 'click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
once(event: 'click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
addListener(event: 'click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
removeListener(event: 'click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
/**
|
|
* Emitted when the tray icon is double clicked.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'double-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
once(event: 'double-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
addListener(event: 'double-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
removeListener(event: 'double-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
/**
|
|
* Emitted when a drag operation ends on the tray or ends at another location.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'drag-end', listener: Function): this;
|
|
once(event: 'drag-end', listener: Function): this;
|
|
addListener(event: 'drag-end', listener: Function): this;
|
|
removeListener(event: 'drag-end', listener: Function): this;
|
|
/**
|
|
* Emitted when a drag operation enters the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'drag-enter', listener: Function): this;
|
|
once(event: 'drag-enter', listener: Function): this;
|
|
addListener(event: 'drag-enter', listener: Function): this;
|
|
removeListener(event: 'drag-enter', listener: Function): this;
|
|
/**
|
|
* Emitted when a drag operation exits the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'drag-leave', listener: Function): this;
|
|
once(event: 'drag-leave', listener: Function): this;
|
|
addListener(event: 'drag-leave', listener: Function): this;
|
|
removeListener(event: 'drag-leave', listener: Function): this;
|
|
/**
|
|
* Emitted when any dragged items are dropped on the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'drop', listener: Function): this;
|
|
once(event: 'drop', listener: Function): this;
|
|
addListener(event: 'drop', listener: Function): this;
|
|
removeListener(event: 'drop', listener: Function): this;
|
|
/**
|
|
* Emitted when dragged files are dropped in the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'drop-files', listener: (event: Event,
|
|
/**
|
|
* The paths of the dropped files.
|
|
*/
|
|
files: string[]) => void): this;
|
|
once(event: 'drop-files', listener: (event: Event,
|
|
/**
|
|
* The paths of the dropped files.
|
|
*/
|
|
files: string[]) => void): this;
|
|
addListener(event: 'drop-files', listener: (event: Event,
|
|
/**
|
|
* The paths of the dropped files.
|
|
*/
|
|
files: string[]) => void): this;
|
|
removeListener(event: 'drop-files', listener: (event: Event,
|
|
/**
|
|
* The paths of the dropped files.
|
|
*/
|
|
files: string[]) => void): this;
|
|
/**
|
|
* Emitted when dragged text is dropped in the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'drop-text', listener: (event: Event,
|
|
/**
|
|
* the dropped text string.
|
|
*/
|
|
text: string) => void): this;
|
|
once(event: 'drop-text', listener: (event: Event,
|
|
/**
|
|
* the dropped text string.
|
|
*/
|
|
text: string) => void): this;
|
|
addListener(event: 'drop-text', listener: (event: Event,
|
|
/**
|
|
* the dropped text string.
|
|
*/
|
|
text: string) => void): this;
|
|
removeListener(event: 'drop-text', listener: (event: Event,
|
|
/**
|
|
* the dropped text string.
|
|
*/
|
|
text: string) => void): this;
|
|
/**
|
|
* Emitted when the mouse clicks the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'mouse-down', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
once(event: 'mouse-down', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
addListener(event: 'mouse-down', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
removeListener(event: 'mouse-down', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
/**
|
|
* Emitted when the mouse enters the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'mouse-enter', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
once(event: 'mouse-enter', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
addListener(event: 'mouse-enter', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
removeListener(event: 'mouse-enter', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
/**
|
|
* Emitted when the mouse exits the tray icon.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'mouse-leave', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
once(event: 'mouse-leave', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
addListener(event: 'mouse-leave', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
removeListener(event: 'mouse-leave', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
/**
|
|
* Emitted when the mouse moves in the tray icon.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'mouse-move', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
once(event: 'mouse-move', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
addListener(event: 'mouse-move', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
removeListener(event: 'mouse-move', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
/**
|
|
* Emitted when the mouse is released from clicking the tray icon.
|
|
*
|
|
* Note: This will not be emitted if you have set a context menu for your Tray
|
|
* using `tray.setContextMenu`, as a result of macOS-level constraints.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
on(event: 'mouse-up', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
once(event: 'mouse-up', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
addListener(event: 'mouse-up', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
removeListener(event: 'mouse-up', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The position of the event.
|
|
*/
|
|
position: Point) => void): this;
|
|
/**
|
|
* Emitted when the tray icon is right clicked.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
on(event: 'right-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
once(event: 'right-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
addListener(event: 'right-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
removeListener(event: 'right-click', listener: (event: KeyboardEvent,
|
|
/**
|
|
* The bounds of tray icon.
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
/**
|
|
* Tray
|
|
*/
|
|
constructor(image: (NativeImage) | (string), guid?: string);
|
|
/**
|
|
* Closes an open context menu, as set by `tray.setContextMenu()`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
closeContextMenu(): void;
|
|
/**
|
|
* Destroys the tray icon immediately.
|
|
*/
|
|
destroy(): void;
|
|
/**
|
|
* Displays a tray balloon.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
displayBalloon(options: DisplayBalloonOptions): void;
|
|
/**
|
|
* Returns focus to the taskbar notification area. Notification area icons should
|
|
* use this message when they have completed their UI operation. For example, if
|
|
* the icon displays a shortcut menu, but the user presses ESC to cancel it, use
|
|
* `tray.focus()` to return focus to the notification area.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
focus(): void;
|
|
/**
|
|
* The `bounds` of this tray icon as `Object`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
getBounds(): Rectangle;
|
|
/**
|
|
* Whether double click events will be ignored.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getIgnoreDoubleClickEvents(): boolean;
|
|
/**
|
|
* the title displayed next to the tray icon in the status bar
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
getTitle(): string;
|
|
/**
|
|
* Whether the tray icon is destroyed.
|
|
*/
|
|
isDestroyed(): boolean;
|
|
/**
|
|
* Pops up the context menu of the tray icon. When `menu` is passed, the `menu`
|
|
* will be shown instead of the tray icon's context menu.
|
|
*
|
|
* The `position` is only available on Windows, and it is (0, 0) by default.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
popUpContextMenu(menu?: Menu, position?: Point): void;
|
|
/**
|
|
* Removes a tray balloon.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
removeBalloon(): void;
|
|
/**
|
|
* Sets the context menu for this icon.
|
|
*/
|
|
setContextMenu(menu: (Menu) | (null)): void;
|
|
/**
|
|
* Sets the option to ignore double click events. Ignoring these events allows you
|
|
* to detect every individual click of the tray icon.
|
|
*
|
|
* This value is set to false by default.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setIgnoreDoubleClickEvents(ignore: boolean): void;
|
|
/**
|
|
* Sets the `image` associated with this tray icon.
|
|
*/
|
|
setImage(image: (NativeImage) | (string)): void;
|
|
/**
|
|
* Sets the `image` associated with this tray icon when pressed on macOS.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setPressedImage(image: (NativeImage) | (string)): void;
|
|
/**
|
|
* Sets the title displayed next to the tray icon in the status bar (Support ANSI
|
|
* colors).
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
setTitle(title: string, options?: TitleOptions): void;
|
|
/**
|
|
* Sets the hover text for this tray icon.
|
|
*/
|
|
setToolTip(toolTip: string): void;
|
|
}
|
|
|
|
interface UploadData {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/upload-data
|
|
|
|
/**
|
|
* UUID of blob data. Use ses.getBlobData method to retrieve the data.
|
|
*/
|
|
blobUUID?: string;
|
|
/**
|
|
* Content being sent.
|
|
*/
|
|
bytes: Buffer;
|
|
/**
|
|
* Path of file being uploaded.
|
|
*/
|
|
file?: string;
|
|
}
|
|
|
|
interface UploadFile {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/upload-file
|
|
|
|
/**
|
|
* Path of file to be uploaded.
|
|
*/
|
|
filePath: string;
|
|
/**
|
|
* Number of bytes to read from `offset`. Defaults to `0`.
|
|
*/
|
|
length?: number;
|
|
/**
|
|
* Last Modification time in number of seconds since the UNIX epoch. Defaults to
|
|
* `0`.
|
|
*/
|
|
modificationTime?: number;
|
|
/**
|
|
* Defaults to `0`.
|
|
*/
|
|
offset?: number;
|
|
/**
|
|
* `file`.
|
|
*/
|
|
type: 'file';
|
|
}
|
|
|
|
interface UploadRawData {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/upload-raw-data
|
|
|
|
/**
|
|
* Data to be uploaded.
|
|
*/
|
|
bytes: Buffer;
|
|
/**
|
|
* `rawData`.
|
|
*/
|
|
type: 'rawData';
|
|
}
|
|
|
|
interface USBDevice {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/usb-device
|
|
|
|
/**
|
|
* The device class for the communication interface supported by the device
|
|
*/
|
|
deviceClass: number;
|
|
/**
|
|
* Unique identifier for the device.
|
|
*/
|
|
deviceId: string;
|
|
/**
|
|
* The device protocol for the communication interface supported by the device
|
|
*/
|
|
deviceProtocol: number;
|
|
/**
|
|
* The device subclass for the communication interface supported by the device
|
|
*/
|
|
deviceSubclass: number;
|
|
/**
|
|
* The major version number of the device as defined by the device manufacturer.
|
|
*/
|
|
deviceVersionMajor: number;
|
|
/**
|
|
* The minor version number of the device as defined by the device manufacturer.
|
|
*/
|
|
deviceVersionMinor: number;
|
|
/**
|
|
* The subminor version number of the device as defined by the device manufacturer.
|
|
*/
|
|
deviceVersionSubminor: number;
|
|
/**
|
|
* The manufacturer name of the device.
|
|
*/
|
|
manufacturerName?: string;
|
|
/**
|
|
* The USB product ID.
|
|
*/
|
|
productId: number;
|
|
/**
|
|
* Name of the device.
|
|
*/
|
|
productName?: string;
|
|
/**
|
|
* The USB device serial number.
|
|
*/
|
|
serialNumber?: string;
|
|
/**
|
|
* The USB protocol major version supported by the device
|
|
*/
|
|
usbVersionMajor: number;
|
|
/**
|
|
* The USB protocol minor version supported by the device
|
|
*/
|
|
usbVersionMinor: number;
|
|
/**
|
|
* The USB protocol subminor version supported by the device
|
|
*/
|
|
usbVersionSubminor: number;
|
|
/**
|
|
* The USB vendor ID.
|
|
*/
|
|
vendorId: number;
|
|
}
|
|
|
|
interface UserDefaultTypes {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/user-default-types
|
|
|
|
array: Array<unknown>;
|
|
boolean: boolean;
|
|
dictionary: Record<string, unknown>;
|
|
double: number;
|
|
float: number;
|
|
integer: number;
|
|
string: string;
|
|
url: string;
|
|
}
|
|
|
|
class UtilityProcess extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/utility-process
|
|
|
|
static fork(modulePath: string, args?: string[], options?: ForkOptions): UtilityProcess;
|
|
/**
|
|
* Emitted after the child process ends.
|
|
*/
|
|
on(event: 'exit', listener: (
|
|
/**
|
|
* Contains the exit code for the process obtained from waitpid on posix, or
|
|
* GetExitCodeProcess on windows.
|
|
*/
|
|
code: number) => void): this;
|
|
once(event: 'exit', listener: (
|
|
/**
|
|
* Contains the exit code for the process obtained from waitpid on posix, or
|
|
* GetExitCodeProcess on windows.
|
|
*/
|
|
code: number) => void): this;
|
|
addListener(event: 'exit', listener: (
|
|
/**
|
|
* Contains the exit code for the process obtained from waitpid on posix, or
|
|
* GetExitCodeProcess on windows.
|
|
*/
|
|
code: number) => void): this;
|
|
removeListener(event: 'exit', listener: (
|
|
/**
|
|
* Contains the exit code for the process obtained from waitpid on posix, or
|
|
* GetExitCodeProcess on windows.
|
|
*/
|
|
code: number) => void): this;
|
|
/**
|
|
* Emitted when the child process sends a message using
|
|
* `process.parentPort.postMessage()`.
|
|
*/
|
|
on(event: 'message', listener: (message: any) => void): this;
|
|
once(event: 'message', listener: (message: any) => void): this;
|
|
addListener(event: 'message', listener: (message: any) => void): this;
|
|
removeListener(event: 'message', listener: (message: any) => void): this;
|
|
/**
|
|
* Emitted once the child process has spawned successfully.
|
|
*/
|
|
on(event: 'spawn', listener: Function): this;
|
|
once(event: 'spawn', listener: Function): this;
|
|
addListener(event: 'spawn', listener: Function): this;
|
|
removeListener(event: 'spawn', listener: Function): this;
|
|
/**
|
|
* Terminates the process gracefully. On POSIX, it uses SIGTERM but will ensure the
|
|
* process is reaped on exit. This function returns true if the kill is successful,
|
|
* and false otherwise.
|
|
*/
|
|
kill(): boolean;
|
|
/**
|
|
* Send a message to the child process, optionally transferring ownership of zero
|
|
* or more `MessagePortMain` objects.
|
|
*
|
|
* For example:
|
|
*/
|
|
postMessage(message: any, transfer?: MessagePortMain[]): void;
|
|
/**
|
|
* A `Integer | undefined` representing the process identifier (PID) of the child
|
|
* process. If the child process fails to spawn due to errors, then the value is
|
|
* `undefined`. When the child process exits, then the value is `undefined` after
|
|
* the `exit` event is emitted.
|
|
*/
|
|
pid: (number) | (undefined);
|
|
/**
|
|
* A `NodeJS.ReadableStream | null` that represents the child process's stderr. If
|
|
* the child was spawned with options.stdio[2] set to anything other than 'pipe',
|
|
* then this will be `null`. When the child process exits, then the value is `null`
|
|
* after the `exit` event is emitted.
|
|
*/
|
|
stderr: (NodeJS.ReadableStream) | (null);
|
|
/**
|
|
* A `NodeJS.ReadableStream | null` that represents the child process's stdout. If
|
|
* the child was spawned with options.stdio[1] set to anything other than 'pipe',
|
|
* then this will be `null`. When the child process exits, then the value is `null`
|
|
* after the `exit` event is emitted.
|
|
*/
|
|
stdout: (NodeJS.ReadableStream) | (null);
|
|
}
|
|
|
|
class WebContents extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/web-contents
|
|
|
|
/**
|
|
* A WebContents instance with the given TargetID, or `undefined` if there is no
|
|
* WebContents associated with the given TargetID.
|
|
*
|
|
* When communicating with the Chrome DevTools Protocol, it can be useful to lookup
|
|
* a WebContents instance based on its assigned TargetID.
|
|
*/
|
|
static fromDevToolsTargetId(targetId: string): (WebContents) | (undefined);
|
|
/**
|
|
* A WebContents instance with the given WebFrameMain, or `undefined` if there is
|
|
* no WebContents associated with the given WebFrameMain.
|
|
*/
|
|
static fromFrame(frame: WebFrameMain): (WebContents) | (undefined);
|
|
/**
|
|
* A WebContents instance with the given ID, or `undefined` if there is no
|
|
* WebContents associated with the given ID.
|
|
*/
|
|
static fromId(id: number): (WebContents) | (undefined);
|
|
/**
|
|
* An array of all `WebContents` instances. This will contain web contents for all
|
|
* windows, webviews, opened devtools, and devtools extension background pages.
|
|
*/
|
|
static getAllWebContents(): WebContents[];
|
|
/**
|
|
* The web contents that is focused in this application, otherwise returns `null`.
|
|
*/
|
|
static getFocusedWebContents(): (WebContents) | (null);
|
|
/**
|
|
* Emitted when media becomes audible or inaudible.
|
|
*/
|
|
on(event: 'audio-state-changed', listener: (event: Event<WebContentsAudioStateChangedEventParams>) => void): this;
|
|
once(event: 'audio-state-changed', listener: (event: Event<WebContentsAudioStateChangedEventParams>) => void): this;
|
|
addListener(event: 'audio-state-changed', listener: (event: Event<WebContentsAudioStateChangedEventParams>) => void): this;
|
|
removeListener(event: 'audio-state-changed', listener: (event: Event<WebContentsAudioStateChangedEventParams>) => void): this;
|
|
/**
|
|
* Emitted before dispatching the `keydown` and `keyup` events in the page. Calling
|
|
* `event.preventDefault` will prevent the page `keydown`/`keyup` events and the
|
|
* menu shortcuts.
|
|
*
|
|
* To only prevent the menu shortcuts, use `setIgnoreMenuShortcuts`:
|
|
*/
|
|
on(event: 'before-input-event', listener: (event: Event,
|
|
/**
|
|
* Input properties.
|
|
*/
|
|
input: Input) => void): this;
|
|
once(event: 'before-input-event', listener: (event: Event,
|
|
/**
|
|
* Input properties.
|
|
*/
|
|
input: Input) => void): this;
|
|
addListener(event: 'before-input-event', listener: (event: Event,
|
|
/**
|
|
* Input properties.
|
|
*/
|
|
input: Input) => void): this;
|
|
removeListener(event: 'before-input-event', listener: (event: Event,
|
|
/**
|
|
* Input properties.
|
|
*/
|
|
input: Input) => void): this;
|
|
/**
|
|
* Emitted when the `WebContents` loses focus.
|
|
*/
|
|
on(event: 'blur', listener: Function): this;
|
|
once(event: 'blur', listener: Function): this;
|
|
addListener(event: 'blur', listener: Function): this;
|
|
removeListener(event: 'blur', listener: Function): this;
|
|
/**
|
|
* Emitted when failed to verify the `certificate` for `url`.
|
|
*
|
|
* The usage is the same with the `certificate-error` event of `app`.
|
|
*/
|
|
on(event: 'certificate-error', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* The error code.
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
once(event: 'certificate-error', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* The error code.
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
addListener(event: 'certificate-error', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* The error code.
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
removeListener(event: 'certificate-error', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* The error code.
|
|
*/
|
|
error: string,
|
|
certificate: Certificate,
|
|
callback: (isTrusted: boolean) => void,
|
|
isMainFrame: boolean) => void): this;
|
|
/**
|
|
* Emitted when the associated window logs a console message.
|
|
*/
|
|
on(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* The log level, from 0 to 3. In order it matches `verbose`, `info`, `warning` and
|
|
* `error`.
|
|
*/
|
|
level: number,
|
|
/**
|
|
* The actual console message
|
|
*/
|
|
message: string,
|
|
/**
|
|
* The line number of the source that triggered this console message
|
|
*/
|
|
line: number,
|
|
sourceId: string) => void): this;
|
|
once(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* The log level, from 0 to 3. In order it matches `verbose`, `info`, `warning` and
|
|
* `error`.
|
|
*/
|
|
level: number,
|
|
/**
|
|
* The actual console message
|
|
*/
|
|
message: string,
|
|
/**
|
|
* The line number of the source that triggered this console message
|
|
*/
|
|
line: number,
|
|
sourceId: string) => void): this;
|
|
addListener(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* The log level, from 0 to 3. In order it matches `verbose`, `info`, `warning` and
|
|
* `error`.
|
|
*/
|
|
level: number,
|
|
/**
|
|
* The actual console message
|
|
*/
|
|
message: string,
|
|
/**
|
|
* The line number of the source that triggered this console message
|
|
*/
|
|
line: number,
|
|
sourceId: string) => void): this;
|
|
removeListener(event: 'console-message', listener: (event: Event,
|
|
/**
|
|
* The log level, from 0 to 3. In order it matches `verbose`, `info`, `warning` and
|
|
* `error`.
|
|
*/
|
|
level: number,
|
|
/**
|
|
* The actual console message
|
|
*/
|
|
message: string,
|
|
/**
|
|
* The line number of the source that triggered this console message
|
|
*/
|
|
line: number,
|
|
sourceId: string) => void): this;
|
|
/**
|
|
* Emitted when the page calls `window.moveTo`, `window.resizeTo` or related APIs.
|
|
*
|
|
* By default, this will move the window. To prevent that behavior, call
|
|
* `event.preventDefault()`.
|
|
*/
|
|
on(event: 'content-bounds-updated', listener: (event: Event,
|
|
/**
|
|
* requested new content bounds
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
once(event: 'content-bounds-updated', listener: (event: Event,
|
|
/**
|
|
* requested new content bounds
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
addListener(event: 'content-bounds-updated', listener: (event: Event,
|
|
/**
|
|
* requested new content bounds
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
removeListener(event: 'content-bounds-updated', listener: (event: Event,
|
|
/**
|
|
* requested new content bounds
|
|
*/
|
|
bounds: Rectangle) => void): this;
|
|
/**
|
|
* Emitted when there is a new context menu that needs to be handled.
|
|
*/
|
|
on(event: 'context-menu', listener: (event: Event,
|
|
params: ContextMenuParams) => void): this;
|
|
once(event: 'context-menu', listener: (event: Event,
|
|
params: ContextMenuParams) => void): this;
|
|
addListener(event: 'context-menu', listener: (event: Event,
|
|
params: ContextMenuParams) => void): this;
|
|
removeListener(event: 'context-menu', listener: (event: Event,
|
|
params: ContextMenuParams) => void): this;
|
|
/**
|
|
* Emitted when the renderer process crashes or is killed.
|
|
*
|
|
* **Deprecated:** This event is superceded by the `render-process-gone` event
|
|
* which contains more information about why the render process disappeared. It
|
|
* isn't always because it crashed. The `killed` boolean can be replaced by
|
|
* checking `reason === 'killed'` when you switch to that event.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
on(event: 'crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
once(event: 'crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
addListener(event: 'crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
removeListener(event: 'crashed', listener: (event: Event,
|
|
killed: boolean) => void): this;
|
|
/**
|
|
* Emitted when the cursor's type changes. The `type` parameter can be `pointer`,
|
|
* `crosshair`, `hand`, `text`, `wait`, `help`, `e-resize`, `n-resize`,
|
|
* `ne-resize`, `nw-resize`, `s-resize`, `se-resize`, `sw-resize`, `w-resize`,
|
|
* `ns-resize`, `ew-resize`, `nesw-resize`, `nwse-resize`, `col-resize`,
|
|
* `row-resize`, `m-panning`, `m-panning-vertical`, `m-panning-horizontal`,
|
|
* `e-panning`, `n-panning`, `ne-panning`, `nw-panning`, `s-panning`, `se-panning`,
|
|
* `sw-panning`, `w-panning`, `move`, `vertical-text`, `cell`, `context-menu`,
|
|
* `alias`, `progress`, `nodrop`, `copy`, `none`, `not-allowed`, `zoom-in`,
|
|
* `zoom-out`, `grab`, `grabbing`, `custom`, `null`, `drag-drop-none`,
|
|
* `drag-drop-move`, `drag-drop-copy`, `drag-drop-link`, `ns-no-resize`,
|
|
* `ew-no-resize`, `nesw-no-resize`, `nwse-no-resize`, or `default`.
|
|
*
|
|
* If the `type` parameter is `custom`, the `image` parameter will hold the custom
|
|
* cursor image in a `NativeImage`, and `scale`, `size` and `hotspot` will hold
|
|
* additional information about the custom cursor.
|
|
*/
|
|
on(event: 'cursor-changed', listener: (event: Event,
|
|
type: string,
|
|
image: NativeImage,
|
|
/**
|
|
* scaling factor for the custom cursor.
|
|
*/
|
|
scale: number,
|
|
/**
|
|
* the size of the `image`.
|
|
*/
|
|
size: Size,
|
|
/**
|
|
* coordinates of the custom cursor's hotspot.
|
|
*/
|
|
hotspot: Point) => void): this;
|
|
once(event: 'cursor-changed', listener: (event: Event,
|
|
type: string,
|
|
image: NativeImage,
|
|
/**
|
|
* scaling factor for the custom cursor.
|
|
*/
|
|
scale: number,
|
|
/**
|
|
* the size of the `image`.
|
|
*/
|
|
size: Size,
|
|
/**
|
|
* coordinates of the custom cursor's hotspot.
|
|
*/
|
|
hotspot: Point) => void): this;
|
|
addListener(event: 'cursor-changed', listener: (event: Event,
|
|
type: string,
|
|
image: NativeImage,
|
|
/**
|
|
* scaling factor for the custom cursor.
|
|
*/
|
|
scale: number,
|
|
/**
|
|
* the size of the `image`.
|
|
*/
|
|
size: Size,
|
|
/**
|
|
* coordinates of the custom cursor's hotspot.
|
|
*/
|
|
hotspot: Point) => void): this;
|
|
removeListener(event: 'cursor-changed', listener: (event: Event,
|
|
type: string,
|
|
image: NativeImage,
|
|
/**
|
|
* scaling factor for the custom cursor.
|
|
*/
|
|
scale: number,
|
|
/**
|
|
* the size of the `image`.
|
|
*/
|
|
size: Size,
|
|
/**
|
|
* coordinates of the custom cursor's hotspot.
|
|
*/
|
|
hotspot: Point) => void): this;
|
|
/**
|
|
* Emitted when `webContents` is destroyed.
|
|
*/
|
|
on(event: 'destroyed', listener: Function): this;
|
|
once(event: 'destroyed', listener: Function): this;
|
|
addListener(event: 'destroyed', listener: Function): this;
|
|
removeListener(event: 'destroyed', listener: Function): this;
|
|
/**
|
|
* Emitted when DevTools is closed.
|
|
*/
|
|
on(event: 'devtools-closed', listener: Function): this;
|
|
once(event: 'devtools-closed', listener: Function): this;
|
|
addListener(event: 'devtools-closed', listener: Function): this;
|
|
removeListener(event: 'devtools-closed', listener: Function): this;
|
|
/**
|
|
* Emitted when DevTools is focused / opened.
|
|
*/
|
|
on(event: 'devtools-focused', listener: Function): this;
|
|
once(event: 'devtools-focused', listener: Function): this;
|
|
addListener(event: 'devtools-focused', listener: Function): this;
|
|
removeListener(event: 'devtools-focused', listener: Function): this;
|
|
/**
|
|
* Emitted when a link is clicked in DevTools or 'Open in new tab' is selected for
|
|
* a link in its context menu.
|
|
*/
|
|
on(event: 'devtools-open-url', listener: (event: Event,
|
|
/**
|
|
* URL of the link that was clicked or selected.
|
|
*/
|
|
url: string) => void): this;
|
|
once(event: 'devtools-open-url', listener: (event: Event,
|
|
/**
|
|
* URL of the link that was clicked or selected.
|
|
*/
|
|
url: string) => void): this;
|
|
addListener(event: 'devtools-open-url', listener: (event: Event,
|
|
/**
|
|
* URL of the link that was clicked or selected.
|
|
*/
|
|
url: string) => void): this;
|
|
removeListener(event: 'devtools-open-url', listener: (event: Event,
|
|
/**
|
|
* URL of the link that was clicked or selected.
|
|
*/
|
|
url: string) => void): this;
|
|
/**
|
|
* Emitted when DevTools is opened.
|
|
*/
|
|
on(event: 'devtools-opened', listener: Function): this;
|
|
once(event: 'devtools-opened', listener: Function): this;
|
|
addListener(event: 'devtools-opened', listener: Function): this;
|
|
removeListener(event: 'devtools-opened', listener: Function): this;
|
|
/**
|
|
* Emitted when the devtools window instructs the webContents to reload
|
|
*/
|
|
on(event: 'devtools-reload-page', listener: Function): this;
|
|
once(event: 'devtools-reload-page', listener: Function): this;
|
|
addListener(event: 'devtools-reload-page', listener: Function): this;
|
|
removeListener(event: 'devtools-reload-page', listener: Function): this;
|
|
/**
|
|
* Emitted when a `<webview>` has been attached to this web contents.
|
|
*/
|
|
on(event: 'did-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The guest web contents that is used by the `<webview>`.
|
|
*/
|
|
webContents: WebContents) => void): this;
|
|
once(event: 'did-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The guest web contents that is used by the `<webview>`.
|
|
*/
|
|
webContents: WebContents) => void): this;
|
|
addListener(event: 'did-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The guest web contents that is used by the `<webview>`.
|
|
*/
|
|
webContents: WebContents) => void): this;
|
|
removeListener(event: 'did-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The guest web contents that is used by the `<webview>`.
|
|
*/
|
|
webContents: WebContents) => void): this;
|
|
/**
|
|
* Emitted when a page's theme color changes. This is usually due to encountering a
|
|
* meta tag:
|
|
*/
|
|
on(event: 'did-change-theme-color', listener: (event: Event,
|
|
/**
|
|
* Theme color is in format of '#rrggbb'. It is `null` when no theme color is set.
|
|
*/
|
|
color: (string) | (null)) => void): this;
|
|
once(event: 'did-change-theme-color', listener: (event: Event,
|
|
/**
|
|
* Theme color is in format of '#rrggbb'. It is `null` when no theme color is set.
|
|
*/
|
|
color: (string) | (null)) => void): this;
|
|
addListener(event: 'did-change-theme-color', listener: (event: Event,
|
|
/**
|
|
* Theme color is in format of '#rrggbb'. It is `null` when no theme color is set.
|
|
*/
|
|
color: (string) | (null)) => void): this;
|
|
removeListener(event: 'did-change-theme-color', listener: (event: Event,
|
|
/**
|
|
* Theme color is in format of '#rrggbb'. It is `null` when no theme color is set.
|
|
*/
|
|
color: (string) | (null)) => void): this;
|
|
/**
|
|
* Emitted _after_ successful creation of a window via `window.open` in the
|
|
* renderer. Not emitted if the creation of the window is canceled from
|
|
* `webContents.setWindowOpenHandler`.
|
|
*
|
|
* See `window.open()` for more details and how to use this in conjunction with
|
|
* `webContents.setWindowOpenHandler`.
|
|
*/
|
|
on(event: 'did-create-window', listener: (window: BrowserWindow,
|
|
details: DidCreateWindowDetails) => void): this;
|
|
once(event: 'did-create-window', listener: (window: BrowserWindow,
|
|
details: DidCreateWindowDetails) => void): this;
|
|
addListener(event: 'did-create-window', listener: (window: BrowserWindow,
|
|
details: DidCreateWindowDetails) => void): this;
|
|
removeListener(event: 'did-create-window', listener: (window: BrowserWindow,
|
|
details: DidCreateWindowDetails) => void): this;
|
|
/**
|
|
* This event is like `did-finish-load` but emitted when the load failed. The full
|
|
* list of error codes and their meaning is available here.
|
|
*/
|
|
on(event: 'did-fail-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-fail-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-fail-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-fail-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* This event is like `did-fail-load` but emitted when the load was cancelled (e.g.
|
|
* `window.stop()` was invoked).
|
|
*/
|
|
on(event: 'did-fail-provisional-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-fail-provisional-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-fail-provisional-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-fail-provisional-load', listener: (event: Event,
|
|
errorCode: number,
|
|
errorDescription: string,
|
|
validatedURL: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Emitted when the navigation is done, i.e. the spinner of the tab has stopped
|
|
* spinning, and the `onload` event was dispatched.
|
|
*/
|
|
on(event: 'did-finish-load', listener: Function): this;
|
|
once(event: 'did-finish-load', listener: Function): this;
|
|
addListener(event: 'did-finish-load', listener: Function): this;
|
|
removeListener(event: 'did-finish-load', listener: Function): this;
|
|
/**
|
|
* Emitted when a frame has done navigation.
|
|
*/
|
|
on(event: 'did-frame-finish-load', listener: (event: Event,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-frame-finish-load', listener: (event: Event,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-frame-finish-load', listener: (event: Event,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-frame-finish-load', listener: (event: Event,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Emitted when any frame navigation is done.
|
|
*
|
|
* This event is not emitted for in-page navigations, such as clicking anchor links
|
|
* or updating the `window.location.hash`. Use `did-navigate-in-page` event for
|
|
* this purpose.
|
|
*/
|
|
on(event: 'did-frame-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations,
|
|
*/
|
|
httpStatusText: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-frame-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations,
|
|
*/
|
|
httpStatusText: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-frame-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations,
|
|
*/
|
|
httpStatusText: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-frame-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations,
|
|
*/
|
|
httpStatusText: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Emitted when a main frame navigation is done.
|
|
*
|
|
* This event is not emitted for in-page navigations, such as clicking anchor links
|
|
* or updating the `window.location.hash`. Use `did-navigate-in-page` event for
|
|
* this purpose.
|
|
*/
|
|
on(event: 'did-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations
|
|
*/
|
|
httpStatusText: string) => void): this;
|
|
once(event: 'did-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations
|
|
*/
|
|
httpStatusText: string) => void): this;
|
|
addListener(event: 'did-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations
|
|
*/
|
|
httpStatusText: string) => void): this;
|
|
removeListener(event: 'did-navigate', listener: (event: Event,
|
|
url: string,
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number,
|
|
/**
|
|
* empty for non HTTP navigations
|
|
*/
|
|
httpStatusText: string) => void): this;
|
|
/**
|
|
* Emitted when an in-page navigation happened in any frame.
|
|
*
|
|
* When in-page navigation happens, the page URL changes but does not cause
|
|
* navigation outside of the page. Examples of this occurring are when anchor links
|
|
* are clicked or when the DOM `hashchange` event is triggered.
|
|
*/
|
|
on(event: 'did-navigate-in-page', listener: (event: Event,
|
|
url: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-navigate-in-page', listener: (event: Event,
|
|
url: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-navigate-in-page', listener: (event: Event,
|
|
url: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-navigate-in-page', listener: (event: Event,
|
|
url: string,
|
|
isMainFrame: boolean,
|
|
frameProcessId: number,
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Emitted after a server side redirect occurs during navigation. For example a
|
|
* 302 redirect.
|
|
*
|
|
* This event cannot be prevented, if you want to prevent redirects you should
|
|
* checkout out the `will-redirect` event above.
|
|
*/
|
|
on(event: 'did-redirect-navigation', listener: (details: Event<WebContentsDidRedirectNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-redirect-navigation', listener: (details: Event<WebContentsDidRedirectNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-redirect-navigation', listener: (details: Event<WebContentsDidRedirectNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-redirect-navigation', listener: (details: Event<WebContentsDidRedirectNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Corresponds to the points in time when the spinner of the tab started spinning.
|
|
*/
|
|
on(event: 'did-start-loading', listener: Function): this;
|
|
once(event: 'did-start-loading', listener: Function): this;
|
|
addListener(event: 'did-start-loading', listener: Function): this;
|
|
removeListener(event: 'did-start-loading', listener: Function): this;
|
|
/**
|
|
* Emitted when any frame (including main) starts navigating.
|
|
*/
|
|
on(event: 'did-start-navigation', listener: (details: Event<WebContentsDidStartNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'did-start-navigation', listener: (details: Event<WebContentsDidStartNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'did-start-navigation', listener: (details: Event<WebContentsDidStartNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'did-start-navigation', listener: (details: Event<WebContentsDidStartNavigationEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Corresponds to the points in time when the spinner of the tab stopped spinning.
|
|
*/
|
|
on(event: 'did-stop-loading', listener: Function): this;
|
|
once(event: 'did-stop-loading', listener: Function): this;
|
|
addListener(event: 'did-stop-loading', listener: Function): this;
|
|
removeListener(event: 'did-stop-loading', listener: Function): this;
|
|
/**
|
|
* Emitted when the document in the top-level frame is loaded.
|
|
*/
|
|
on(event: 'dom-ready', listener: Function): this;
|
|
once(event: 'dom-ready', listener: Function): this;
|
|
addListener(event: 'dom-ready', listener: Function): this;
|
|
removeListener(event: 'dom-ready', listener: Function): this;
|
|
/**
|
|
* Emitted when the window enters a full-screen state triggered by HTML API.
|
|
*/
|
|
on(event: 'enter-html-full-screen', listener: Function): this;
|
|
once(event: 'enter-html-full-screen', listener: Function): this;
|
|
addListener(event: 'enter-html-full-screen', listener: Function): this;
|
|
removeListener(event: 'enter-html-full-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when the `WebContents` gains focus.
|
|
*
|
|
* Note that on macOS, having focus means the `WebContents` is the first responder
|
|
* of window, so switching focus between windows would not trigger the `focus` and
|
|
* `blur` events of `WebContents`, as the first responder of each window is not
|
|
* changed.
|
|
*
|
|
* The `focus` and `blur` events of `WebContents` should only be used to detect
|
|
* focus change between different `WebContents` and `BrowserView` in the same
|
|
* window.
|
|
*/
|
|
on(event: 'focus', listener: Function): this;
|
|
once(event: 'focus', listener: Function): this;
|
|
addListener(event: 'focus', listener: Function): this;
|
|
removeListener(event: 'focus', listener: Function): this;
|
|
/**
|
|
* Emitted when a result is available for `webContents.findInPage` request.
|
|
*/
|
|
on(event: 'found-in-page', listener: (event: Event,
|
|
result: Result) => void): this;
|
|
once(event: 'found-in-page', listener: (event: Event,
|
|
result: Result) => void): this;
|
|
addListener(event: 'found-in-page', listener: (event: Event,
|
|
result: Result) => void): this;
|
|
removeListener(event: 'found-in-page', listener: (event: Event,
|
|
result: Result) => void): this;
|
|
/**
|
|
* Emitted when the mainFrame, an `<iframe>`, or a nested `<iframe>` is loaded
|
|
* within the page.
|
|
*/
|
|
on(event: 'frame-created', listener: (event: Event,
|
|
details: FrameCreatedDetails) => void): this;
|
|
once(event: 'frame-created', listener: (event: Event,
|
|
details: FrameCreatedDetails) => void): this;
|
|
addListener(event: 'frame-created', listener: (event: Event,
|
|
details: FrameCreatedDetails) => void): this;
|
|
removeListener(event: 'frame-created', listener: (event: Event,
|
|
details: FrameCreatedDetails) => void): this;
|
|
/**
|
|
* Emitted when an input event is sent to the WebContents. See InputEvent for
|
|
* details.
|
|
*/
|
|
on(event: 'input-event', listener: (event: Event,
|
|
inputEvent: InputEvent) => void): this;
|
|
once(event: 'input-event', listener: (event: Event,
|
|
inputEvent: InputEvent) => void): this;
|
|
addListener(event: 'input-event', listener: (event: Event,
|
|
inputEvent: InputEvent) => void): this;
|
|
removeListener(event: 'input-event', listener: (event: Event,
|
|
inputEvent: InputEvent) => void): this;
|
|
/**
|
|
* Emitted when the renderer process sends an asynchronous message via
|
|
* `ipcRenderer.send()`.
|
|
*
|
|
* See also `webContents.ipc`, which provides an `IpcMain`-like interface for
|
|
* responding to IPC messages specifically from this WebContents.
|
|
*/
|
|
on(event: 'ipc-message', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
once(event: 'ipc-message', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
addListener(event: 'ipc-message', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
removeListener(event: 'ipc-message', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
/**
|
|
* Emitted when the renderer process sends a synchronous message via
|
|
* `ipcRenderer.sendSync()`.
|
|
*
|
|
* See also `webContents.ipc`, which provides an `IpcMain`-like interface for
|
|
* responding to IPC messages specifically from this WebContents.
|
|
*/
|
|
on(event: 'ipc-message-sync', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
once(event: 'ipc-message-sync', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
addListener(event: 'ipc-message-sync', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
removeListener(event: 'ipc-message-sync', listener: (event: IpcMainEvent,
|
|
channel: string,
|
|
...args: any[]) => void): this;
|
|
/**
|
|
* Emitted when the window leaves a full-screen state triggered by HTML API.
|
|
*/
|
|
on(event: 'leave-html-full-screen', listener: Function): this;
|
|
once(event: 'leave-html-full-screen', listener: Function): this;
|
|
addListener(event: 'leave-html-full-screen', listener: Function): this;
|
|
removeListener(event: 'leave-html-full-screen', listener: Function): this;
|
|
/**
|
|
* Emitted when `webContents` wants to do basic auth.
|
|
*
|
|
* The usage is the same with the `login` event of `app`.
|
|
*/
|
|
on(event: 'login', listener: (event: Event,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
once(event: 'login', listener: (event: Event,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
addListener(event: 'login', listener: (event: Event,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
removeListener(event: 'login', listener: (event: Event,
|
|
authenticationResponseDetails: AuthenticationResponseDetails,
|
|
authInfo: AuthInfo,
|
|
callback: (username?: string, password?: string) => void) => void): this;
|
|
/**
|
|
* Emitted when media is paused or done playing.
|
|
*/
|
|
on(event: 'media-paused', listener: Function): this;
|
|
once(event: 'media-paused', listener: Function): this;
|
|
addListener(event: 'media-paused', listener: Function): this;
|
|
removeListener(event: 'media-paused', listener: Function): this;
|
|
/**
|
|
* Emitted when media starts playing.
|
|
*/
|
|
on(event: 'media-started-playing', listener: Function): this;
|
|
once(event: 'media-started-playing', listener: Function): this;
|
|
addListener(event: 'media-started-playing', listener: Function): this;
|
|
removeListener(event: 'media-started-playing', listener: Function): this;
|
|
/**
|
|
* Emitted when page receives favicon urls.
|
|
*/
|
|
on(event: 'page-favicon-updated', listener: (event: Event,
|
|
/**
|
|
* Array of URLs.
|
|
*/
|
|
favicons: string[]) => void): this;
|
|
once(event: 'page-favicon-updated', listener: (event: Event,
|
|
/**
|
|
* Array of URLs.
|
|
*/
|
|
favicons: string[]) => void): this;
|
|
addListener(event: 'page-favicon-updated', listener: (event: Event,
|
|
/**
|
|
* Array of URLs.
|
|
*/
|
|
favicons: string[]) => void): this;
|
|
removeListener(event: 'page-favicon-updated', listener: (event: Event,
|
|
/**
|
|
* Array of URLs.
|
|
*/
|
|
favicons: string[]) => void): this;
|
|
/**
|
|
* Fired when page title is set during navigation. `explicitSet` is false when
|
|
* title is synthesized from file url.
|
|
*/
|
|
on(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
once(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
addListener(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
removeListener(event: 'page-title-updated', listener: (event: Event,
|
|
title: string,
|
|
explicitSet: boolean) => void): this;
|
|
/**
|
|
* Emitted when a new frame is generated. Only the dirty area is passed in the
|
|
* buffer.
|
|
*/
|
|
on(event: 'paint', listener: (event: Event,
|
|
dirtyRect: Rectangle,
|
|
/**
|
|
* The image data of the whole frame.
|
|
*/
|
|
image: NativeImage) => void): this;
|
|
once(event: 'paint', listener: (event: Event,
|
|
dirtyRect: Rectangle,
|
|
/**
|
|
* The image data of the whole frame.
|
|
*/
|
|
image: NativeImage) => void): this;
|
|
addListener(event: 'paint', listener: (event: Event,
|
|
dirtyRect: Rectangle,
|
|
/**
|
|
* The image data of the whole frame.
|
|
*/
|
|
image: NativeImage) => void): this;
|
|
removeListener(event: 'paint', listener: (event: Event,
|
|
dirtyRect: Rectangle,
|
|
/**
|
|
* The image data of the whole frame.
|
|
*/
|
|
image: NativeImage) => void): this;
|
|
/**
|
|
* Emitted when a plugin process has crashed.
|
|
*/
|
|
on(event: 'plugin-crashed', listener: (event: Event,
|
|
name: string,
|
|
version: string) => void): this;
|
|
once(event: 'plugin-crashed', listener: (event: Event,
|
|
name: string,
|
|
version: string) => void): this;
|
|
addListener(event: 'plugin-crashed', listener: (event: Event,
|
|
name: string,
|
|
version: string) => void): this;
|
|
removeListener(event: 'plugin-crashed', listener: (event: Event,
|
|
name: string,
|
|
version: string) => void): this;
|
|
/**
|
|
* Emitted when the `WebContents` preferred size has changed.
|
|
*
|
|
* This event will only be emitted when `enablePreferredSizeMode` is set to `true`
|
|
* in `webPreferences`.
|
|
*/
|
|
on(event: 'preferred-size-changed', listener: (event: Event,
|
|
/**
|
|
* The minimum size needed to contain the layout of the document—without requiring
|
|
* scrolling.
|
|
*/
|
|
preferredSize: Size) => void): this;
|
|
once(event: 'preferred-size-changed', listener: (event: Event,
|
|
/**
|
|
* The minimum size needed to contain the layout of the document—without requiring
|
|
* scrolling.
|
|
*/
|
|
preferredSize: Size) => void): this;
|
|
addListener(event: 'preferred-size-changed', listener: (event: Event,
|
|
/**
|
|
* The minimum size needed to contain the layout of the document—without requiring
|
|
* scrolling.
|
|
*/
|
|
preferredSize: Size) => void): this;
|
|
removeListener(event: 'preferred-size-changed', listener: (event: Event,
|
|
/**
|
|
* The minimum size needed to contain the layout of the document—without requiring
|
|
* scrolling.
|
|
*/
|
|
preferredSize: Size) => void): this;
|
|
/**
|
|
* Emitted when the preload script `preloadPath` throws an unhandled exception
|
|
* `error`.
|
|
*/
|
|
on(event: 'preload-error', listener: (event: Event,
|
|
preloadPath: string,
|
|
error: Error) => void): this;
|
|
once(event: 'preload-error', listener: (event: Event,
|
|
preloadPath: string,
|
|
error: Error) => void): this;
|
|
addListener(event: 'preload-error', listener: (event: Event,
|
|
preloadPath: string,
|
|
error: Error) => void): this;
|
|
removeListener(event: 'preload-error', listener: (event: Event,
|
|
preloadPath: string,
|
|
error: Error) => void): this;
|
|
/**
|
|
* Emitted when the renderer process unexpectedly disappears. This is normally
|
|
* because it was crashed or killed.
|
|
*/
|
|
on(event: 'render-process-gone', listener: (event: Event,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
once(event: 'render-process-gone', listener: (event: Event,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
addListener(event: 'render-process-gone', listener: (event: Event,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
removeListener(event: 'render-process-gone', listener: (event: Event,
|
|
details: RenderProcessGoneDetails) => void): this;
|
|
/**
|
|
* Emitted when the unresponsive web page becomes responsive again.
|
|
*/
|
|
on(event: 'responsive', listener: Function): this;
|
|
once(event: 'responsive', listener: Function): this;
|
|
addListener(event: 'responsive', listener: Function): this;
|
|
removeListener(event: 'responsive', listener: Function): this;
|
|
/**
|
|
* Emitted when a bluetooth device needs to be selected when a call to
|
|
* `navigator.bluetooth.requestDevice` is made. `callback` should be called with
|
|
* the `deviceId` of the device to be selected. Passing an empty string to
|
|
* `callback` will cancel the request.
|
|
*
|
|
* If an event listener is not added for this event, or if `event.preventDefault`
|
|
* is not called when handling this event, the first available device will be
|
|
* automatically selected.
|
|
*
|
|
* Due to the nature of bluetooth, scanning for devices when
|
|
* `navigator.bluetooth.requestDevice` is called may take time and will cause
|
|
* `select-bluetooth-device` to fire multiple times until `callback` is called with
|
|
* either a device id or an empty string to cancel the request.
|
|
*/
|
|
on(event: 'select-bluetooth-device', listener: (event: Event,
|
|
devices: BluetoothDevice[],
|
|
callback: (deviceId: string) => void) => void): this;
|
|
once(event: 'select-bluetooth-device', listener: (event: Event,
|
|
devices: BluetoothDevice[],
|
|
callback: (deviceId: string) => void) => void): this;
|
|
addListener(event: 'select-bluetooth-device', listener: (event: Event,
|
|
devices: BluetoothDevice[],
|
|
callback: (deviceId: string) => void) => void): this;
|
|
removeListener(event: 'select-bluetooth-device', listener: (event: Event,
|
|
devices: BluetoothDevice[],
|
|
callback: (deviceId: string) => void) => void): this;
|
|
/**
|
|
* Emitted when a client certificate is requested.
|
|
*
|
|
* The usage is the same with the `select-client-certificate` event of `app`.
|
|
*/
|
|
on(event: 'select-client-certificate', listener: (event: Event,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate: Certificate) => void) => void): this;
|
|
once(event: 'select-client-certificate', listener: (event: Event,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate: Certificate) => void) => void): this;
|
|
addListener(event: 'select-client-certificate', listener: (event: Event,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate: Certificate) => void) => void): this;
|
|
removeListener(event: 'select-client-certificate', listener: (event: Event,
|
|
url: string,
|
|
certificateList: Certificate[],
|
|
callback: (certificate: Certificate) => void) => void): this;
|
|
/**
|
|
* Emitted when the web page becomes unresponsive.
|
|
*/
|
|
on(event: 'unresponsive', listener: Function): this;
|
|
once(event: 'unresponsive', listener: Function): this;
|
|
addListener(event: 'unresponsive', listener: Function): this;
|
|
removeListener(event: 'unresponsive', listener: Function): this;
|
|
/**
|
|
* Emitted when mouse moves over a link or the keyboard moves the focus to a link.
|
|
*/
|
|
on(event: 'update-target-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
once(event: 'update-target-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
addListener(event: 'update-target-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
removeListener(event: 'update-target-url', listener: (event: Event,
|
|
url: string) => void): this;
|
|
/**
|
|
* Emitted when a `<webview>`'s web contents is being attached to this web
|
|
* contents. Calling `event.preventDefault()` will destroy the guest page.
|
|
*
|
|
* This event can be used to configure `webPreferences` for the `webContents` of a
|
|
* `<webview>` before it's loaded, and provides the ability to set settings that
|
|
* can't be set via `<webview>` attributes.
|
|
*/
|
|
on(event: 'will-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The web preferences that will be used by the guest page. This object can be
|
|
* modified to adjust the preferences for the guest page.
|
|
*/
|
|
webPreferences: WebPreferences,
|
|
/**
|
|
* The other `<webview>` parameters such as the `src` URL. This object can be
|
|
* modified to adjust the parameters of the guest page.
|
|
*/
|
|
params: Record<string, string>) => void): this;
|
|
once(event: 'will-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The web preferences that will be used by the guest page. This object can be
|
|
* modified to adjust the preferences for the guest page.
|
|
*/
|
|
webPreferences: WebPreferences,
|
|
/**
|
|
* The other `<webview>` parameters such as the `src` URL. This object can be
|
|
* modified to adjust the parameters of the guest page.
|
|
*/
|
|
params: Record<string, string>) => void): this;
|
|
addListener(event: 'will-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The web preferences that will be used by the guest page. This object can be
|
|
* modified to adjust the preferences for the guest page.
|
|
*/
|
|
webPreferences: WebPreferences,
|
|
/**
|
|
* The other `<webview>` parameters such as the `src` URL. This object can be
|
|
* modified to adjust the parameters of the guest page.
|
|
*/
|
|
params: Record<string, string>) => void): this;
|
|
removeListener(event: 'will-attach-webview', listener: (event: Event,
|
|
/**
|
|
* The web preferences that will be used by the guest page. This object can be
|
|
* modified to adjust the preferences for the guest page.
|
|
*/
|
|
webPreferences: WebPreferences,
|
|
/**
|
|
* The other `<webview>` parameters such as the `src` URL. This object can be
|
|
* modified to adjust the parameters of the guest page.
|
|
*/
|
|
params: Record<string, string>) => void): this;
|
|
/**
|
|
* Emitted when a user or the page wants to start navigation in any frame. It can
|
|
* happen when the `window.location` object is changed or a user clicks a link in
|
|
* the page.
|
|
*
|
|
* Unlike `will-navigate`, `will-frame-navigate` is fired when the main frame or
|
|
* any of its subframes attempts to navigate. When the navigation event comes from
|
|
* the main frame, `isMainFrame` will be `true`.
|
|
*
|
|
* This event will not emit when the navigation is started programmatically with
|
|
* APIs like `webContents.loadURL` and `webContents.back`.
|
|
*
|
|
* It is also not emitted for in-page navigations, such as clicking anchor links or
|
|
* updating the `window.location.hash`. Use `did-navigate-in-page` event for this
|
|
* purpose.
|
|
*
|
|
* Calling `event.preventDefault()` will prevent the navigation.
|
|
*/
|
|
on(event: 'will-frame-navigate', listener: (details: Event<WebContentsWillFrameNavigateEventParams>) => void): this;
|
|
once(event: 'will-frame-navigate', listener: (details: Event<WebContentsWillFrameNavigateEventParams>) => void): this;
|
|
addListener(event: 'will-frame-navigate', listener: (details: Event<WebContentsWillFrameNavigateEventParams>) => void): this;
|
|
removeListener(event: 'will-frame-navigate', listener: (details: Event<WebContentsWillFrameNavigateEventParams>) => void): this;
|
|
/**
|
|
* Emitted when a user or the page wants to start navigation on the main frame. It
|
|
* can happen when the `window.location` object is changed or a user clicks a link
|
|
* in the page.
|
|
*
|
|
* This event will not emit when the navigation is started programmatically with
|
|
* APIs like `webContents.loadURL` and `webContents.back`.
|
|
*
|
|
* It is also not emitted for in-page navigations, such as clicking anchor links or
|
|
* updating the `window.location.hash`. Use `did-navigate-in-page` event for this
|
|
* purpose.
|
|
*
|
|
* Calling `event.preventDefault()` will prevent the navigation.
|
|
*/
|
|
on(event: 'will-navigate', listener: (details: Event<WebContentsWillNavigateEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'will-navigate', listener: (details: Event<WebContentsWillNavigateEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'will-navigate', listener: (details: Event<WebContentsWillNavigateEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'will-navigate', listener: (details: Event<WebContentsWillNavigateEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Emitted when a `beforeunload` event handler is attempting to cancel a page
|
|
* unload.
|
|
*
|
|
* Calling `event.preventDefault()` will ignore the `beforeunload` event handler
|
|
* and allow the page to be unloaded.
|
|
*
|
|
* **Note:** This will be emitted for `BrowserViews` but will _not_ be respected -
|
|
* this is because we have chosen not to tie the `BrowserView` lifecycle to its
|
|
* owning BrowserWindow should one exist per the specification.
|
|
*/
|
|
on(event: 'will-prevent-unload', listener: (event: Event) => void): this;
|
|
once(event: 'will-prevent-unload', listener: (event: Event) => void): this;
|
|
addListener(event: 'will-prevent-unload', listener: (event: Event) => void): this;
|
|
removeListener(event: 'will-prevent-unload', listener: (event: Event) => void): this;
|
|
/**
|
|
* Emitted when a server side redirect occurs during navigation. For example a 302
|
|
* redirect.
|
|
*
|
|
* This event will be emitted after `did-start-navigation` and always before the
|
|
* `did-redirect-navigation` event for the same navigation.
|
|
*
|
|
* Calling `event.preventDefault()` will prevent the navigation (not just the
|
|
* redirect).
|
|
*/
|
|
on(event: 'will-redirect', listener: (details: Event<WebContentsWillRedirectEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
once(event: 'will-redirect', listener: (details: Event<WebContentsWillRedirectEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
addListener(event: 'will-redirect', listener: (details: Event<WebContentsWillRedirectEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
removeListener(event: 'will-redirect', listener: (details: Event<WebContentsWillRedirectEventParams>,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
url: string,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isInPlace: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
isMainFrame: boolean,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameProcessId: number,
|
|
/**
|
|
* @deprecated
|
|
*/
|
|
frameRoutingId: number) => void): this;
|
|
/**
|
|
* Emitted when the user is requesting to change the zoom level using the mouse
|
|
* wheel.
|
|
*/
|
|
on(event: 'zoom-changed', listener: (event: Event,
|
|
/**
|
|
* Can be `in` or `out`.
|
|
*/
|
|
zoomDirection: ('in' | 'out')) => void): this;
|
|
once(event: 'zoom-changed', listener: (event: Event,
|
|
/**
|
|
* Can be `in` or `out`.
|
|
*/
|
|
zoomDirection: ('in' | 'out')) => void): this;
|
|
addListener(event: 'zoom-changed', listener: (event: Event,
|
|
/**
|
|
* Can be `in` or `out`.
|
|
*/
|
|
zoomDirection: ('in' | 'out')) => void): this;
|
|
removeListener(event: 'zoom-changed', listener: (event: Event,
|
|
/**
|
|
* Can be `in` or `out`.
|
|
*/
|
|
zoomDirection: ('in' | 'out')) => void): this;
|
|
/**
|
|
* Adds the specified path to DevTools workspace. Must be used after DevTools
|
|
* creation:
|
|
*/
|
|
addWorkSpace(path: string): void;
|
|
/**
|
|
* Adjusts the current text selection starting and ending points in the focused
|
|
* frame by the given amounts. A negative amount moves the selection towards the
|
|
* beginning of the document, and a positive amount moves the selection towards the
|
|
* end of the document.
|
|
*
|
|
* Example:
|
|
*
|
|
* For a call of `win.webContents.adjustSelection({ start: 1, end: 5 })`
|
|
*
|
|
* Before:
|
|
*
|
|
* <img width="487" alt="Image Before Text Selection Adjustment"
|
|
* src="../images/web-contents-text-selection-before.png"/>
|
|
*
|
|
* After:
|
|
*
|
|
* <img width="487" alt="Image After Text Selection Adjustment"
|
|
* src="../images/web-contents-text-selection-after.png"/>
|
|
*/
|
|
adjustSelection(options: AdjustSelectionOptions): void;
|
|
/**
|
|
* Begin subscribing for presentation events and captured frames, the `callback`
|
|
* will be called with `callback(image, dirtyRect)` when there is a presentation
|
|
* event.
|
|
*
|
|
* The `image` is an instance of NativeImage that stores the captured frame.
|
|
*
|
|
* The `dirtyRect` is an object with `x, y, width, height` properties that
|
|
* describes which part of the page was repainted. If `onlyDirty` is set to `true`,
|
|
* `image` will only contain the repainted area. `onlyDirty` defaults to `false`.
|
|
*/
|
|
beginFrameSubscription(onlyDirty: boolean, callback: (image: NativeImage, dirtyRect: Rectangle) => void): void;
|
|
/**
|
|
* Begin subscribing for presentation events and captured frames, the `callback`
|
|
* will be called with `callback(image, dirtyRect)` when there is a presentation
|
|
* event.
|
|
*
|
|
* The `image` is an instance of NativeImage that stores the captured frame.
|
|
*
|
|
* The `dirtyRect` is an object with `x, y, width, height` properties that
|
|
* describes which part of the page was repainted. If `onlyDirty` is set to `true`,
|
|
* `image` will only contain the repainted area. `onlyDirty` defaults to `false`.
|
|
*/
|
|
beginFrameSubscription(callback: (image: NativeImage, dirtyRect: Rectangle) => void): void;
|
|
/**
|
|
* Whether the browser can go back to previous web page.
|
|
*/
|
|
canGoBack(): boolean;
|
|
/**
|
|
* Whether the browser can go forward to next web page.
|
|
*/
|
|
canGoForward(): boolean;
|
|
/**
|
|
* Whether the web page can go to `offset`.
|
|
*/
|
|
canGoToOffset(offset: number): boolean;
|
|
/**
|
|
* Resolves with a NativeImage
|
|
*
|
|
* Captures a snapshot of the page within `rect`. Omitting `rect` will capture the
|
|
* whole visible page. The page is considered visible when its browser window is
|
|
* hidden and the capturer count is non-zero. If you would like the page to stay
|
|
* hidden, you should ensure that `stayHidden` is set to true.
|
|
*/
|
|
capturePage(rect?: Rectangle, opts?: Opts): Promise<Electron.NativeImage>;
|
|
/**
|
|
* Centers the current text selection in web page.
|
|
*/
|
|
centerSelection(): void;
|
|
/**
|
|
* Clears the navigation history.
|
|
*/
|
|
clearHistory(): void;
|
|
/**
|
|
* Closes the page, as if the web content had called `window.close()`.
|
|
*
|
|
* If the page is successfully closed (i.e. the unload is not prevented by the
|
|
* page, or `waitForBeforeUnload` is false or unspecified), the WebContents will be
|
|
* destroyed and no longer usable. The `destroyed` event will be emitted.
|
|
*/
|
|
close(opts?: CloseOpts): void;
|
|
/**
|
|
* Closes the devtools.
|
|
*/
|
|
closeDevTools(): void;
|
|
/**
|
|
* Executes the editing command `copy` in web page.
|
|
*/
|
|
copy(): void;
|
|
/**
|
|
* Copy the image at the given position to the clipboard.
|
|
*/
|
|
copyImageAt(x: number, y: number): void;
|
|
/**
|
|
* Executes the editing command `cut` in web page.
|
|
*/
|
|
cut(): void;
|
|
/**
|
|
* Executes the editing command `delete` in web page.
|
|
*/
|
|
delete(): void;
|
|
/**
|
|
* Disable device emulation enabled by `webContents.enableDeviceEmulation`.
|
|
*/
|
|
disableDeviceEmulation(): void;
|
|
/**
|
|
* Initiates a download of the resource at `url` without navigating. The
|
|
* `will-download` event of `session` will be triggered.
|
|
*/
|
|
downloadURL(url: string, options?: DownloadURLOptions): void;
|
|
/**
|
|
* Enable device emulation with the given parameters.
|
|
*/
|
|
enableDeviceEmulation(parameters: Parameters): void;
|
|
/**
|
|
* End subscribing for frame presentation events.
|
|
*/
|
|
endFrameSubscription(): void;
|
|
/**
|
|
* A promise that resolves with the result of the executed code or is rejected if
|
|
* the result of the code is a rejected promise.
|
|
*
|
|
* Evaluates `code` in page.
|
|
*
|
|
* In the browser window some HTML APIs like `requestFullScreen` can only be
|
|
* invoked by a gesture from the user. Setting `userGesture` to `true` will remove
|
|
* this limitation.
|
|
*
|
|
* Code execution will be suspended until web page stop loading.
|
|
*/
|
|
executeJavaScript(code: string, userGesture?: boolean): Promise<any>;
|
|
/**
|
|
* A promise that resolves with the result of the executed code or is rejected if
|
|
* the result of the code is a rejected promise.
|
|
*
|
|
* Works like `executeJavaScript` but evaluates `scripts` in an isolated context.
|
|
*/
|
|
executeJavaScriptInIsolatedWorld(worldId: number, scripts: WebSource[], userGesture?: boolean): Promise<any>;
|
|
/**
|
|
* The request id used for the request.
|
|
*
|
|
* Starts a request to find all matches for the `text` in the web page. The result
|
|
* of the request can be obtained by subscribing to `found-in-page` event.
|
|
*/
|
|
findInPage(text: string, options?: FindInPageOptions): number;
|
|
/**
|
|
* Focuses the web page.
|
|
*/
|
|
focus(): void;
|
|
/**
|
|
* Forcefully terminates the renderer process that is currently hosting this
|
|
* `webContents`. This will cause the `render-process-gone` event to be emitted
|
|
* with the `reason=killed || reason=crashed`. Please note that some webContents
|
|
* share renderer processes and therefore calling this method may also crash the
|
|
* host process for other webContents as well.
|
|
*
|
|
* Calling `reload()` immediately after calling this method will force the reload
|
|
* to occur in a new process. This should be used when this process is unstable or
|
|
* unusable, for instance in order to recover from the `unresponsive` event.
|
|
*/
|
|
forcefullyCrashRenderer(): void;
|
|
/**
|
|
* Information about all Shared Workers.
|
|
*/
|
|
getAllSharedWorkers(): SharedWorkerInfo[];
|
|
/**
|
|
* whether or not this WebContents will throttle animations and timers when the
|
|
* page becomes backgrounded. This also affects the Page Visibility API.
|
|
*/
|
|
getBackgroundThrottling(): boolean;
|
|
/**
|
|
* the current title of the DevTools window. This will only be visible if DevTools
|
|
* is opened in `undocked` or `detach` mode.
|
|
*/
|
|
getDevToolsTitle(): string;
|
|
/**
|
|
* If _offscreen rendering_ is enabled returns the current frame rate.
|
|
*/
|
|
getFrameRate(): number;
|
|
/**
|
|
* The identifier of a WebContents stream. This identifier can be used with
|
|
* `navigator.mediaDevices.getUserMedia` using a `chromeMediaSource` of `tab`. The
|
|
* identifier is restricted to the web contents that it is registered to and is
|
|
* only valid for 10 seconds.
|
|
*/
|
|
getMediaSourceId(requestWebContents: WebContents): string;
|
|
/**
|
|
* The operating system `pid` of the associated renderer process.
|
|
*/
|
|
getOSProcessId(): number;
|
|
/**
|
|
* Get the system printer list.
|
|
*
|
|
* Resolves with a `PrinterInfo[]`
|
|
*/
|
|
getPrintersAsync(): Promise<Electron.PrinterInfo[]>;
|
|
/**
|
|
* The Chromium internal `pid` of the associated renderer. Can be compared to the
|
|
* `frameProcessId` passed by frame specific navigation events (e.g.
|
|
* `did-frame-navigate`)
|
|
*/
|
|
getProcessId(): number;
|
|
/**
|
|
* The title of the current web page.
|
|
*/
|
|
getTitle(): string;
|
|
/**
|
|
* the type of the webContent. Can be `backgroundPage`, `window`, `browserView`,
|
|
* `remote`, `webview` or `offscreen`.
|
|
*/
|
|
getType(): ('backgroundPage' | 'window' | 'browserView' | 'remote' | 'webview' | 'offscreen');
|
|
/**
|
|
* The URL of the current web page.
|
|
*/
|
|
getURL(): string;
|
|
/**
|
|
* The user agent for this web page.
|
|
*/
|
|
getUserAgent(): string;
|
|
/**
|
|
* Returns the WebRTC IP Handling Policy.
|
|
*/
|
|
getWebRTCIPHandlingPolicy(): string;
|
|
/**
|
|
* the current zoom factor.
|
|
*/
|
|
getZoomFactor(): number;
|
|
/**
|
|
* the current zoom level.
|
|
*/
|
|
getZoomLevel(): number;
|
|
/**
|
|
* Makes the browser go back a web page.
|
|
*/
|
|
goBack(): void;
|
|
/**
|
|
* Makes the browser go forward a web page.
|
|
*/
|
|
goForward(): void;
|
|
/**
|
|
* Navigates browser to the specified absolute web page index.
|
|
*/
|
|
goToIndex(index: number): void;
|
|
/**
|
|
* Navigates to the specified offset from the "current entry".
|
|
*/
|
|
goToOffset(offset: number): void;
|
|
/**
|
|
* A promise that resolves with a key for the inserted CSS that can later be used
|
|
* to remove the CSS via `contents.removeInsertedCSS(key)`.
|
|
*
|
|
* Injects CSS into the current web page and returns a unique key for the inserted
|
|
* stylesheet.
|
|
*/
|
|
insertCSS(css: string, options?: InsertCSSOptions): Promise<string>;
|
|
/**
|
|
* Inserts `text` to the focused element.
|
|
*/
|
|
insertText(text: string): Promise<void>;
|
|
/**
|
|
* Starts inspecting element at position (`x`, `y`).
|
|
*/
|
|
inspectElement(x: number, y: number): void;
|
|
/**
|
|
* Opens the developer tools for the service worker context.
|
|
*/
|
|
inspectServiceWorker(): void;
|
|
/**
|
|
* Opens the developer tools for the shared worker context.
|
|
*/
|
|
inspectSharedWorker(): void;
|
|
/**
|
|
* Inspects the shared worker based on its ID.
|
|
*/
|
|
inspectSharedWorkerById(workerId: string): void;
|
|
/**
|
|
* Schedules a full repaint of the window this web contents is in.
|
|
*
|
|
* If _offscreen rendering_ is enabled invalidates the frame and generates a new
|
|
* one through the `'paint'` event.
|
|
*/
|
|
invalidate(): void;
|
|
/**
|
|
* Whether this page has been muted.
|
|
*/
|
|
isAudioMuted(): boolean;
|
|
/**
|
|
* Whether this page is being captured. It returns true when the capturer count is
|
|
* large then 0.
|
|
*/
|
|
isBeingCaptured(): boolean;
|
|
/**
|
|
* Whether the renderer process has crashed.
|
|
*/
|
|
isCrashed(): boolean;
|
|
/**
|
|
* Whether audio is currently playing.
|
|
*/
|
|
isCurrentlyAudible(): boolean;
|
|
/**
|
|
* Whether the web page is destroyed.
|
|
*/
|
|
isDestroyed(): boolean;
|
|
/**
|
|
* Whether the devtools view is focused .
|
|
*/
|
|
isDevToolsFocused(): boolean;
|
|
/**
|
|
* Whether the devtools is opened.
|
|
*/
|
|
isDevToolsOpened(): boolean;
|
|
/**
|
|
* Whether the web page is focused.
|
|
*/
|
|
isFocused(): boolean;
|
|
/**
|
|
* Whether web page is still loading resources.
|
|
*/
|
|
isLoading(): boolean;
|
|
/**
|
|
* Whether the main frame (and not just iframes or frames within it) is still
|
|
* loading.
|
|
*/
|
|
isLoadingMainFrame(): boolean;
|
|
/**
|
|
* Indicates whether _offscreen rendering_ is enabled.
|
|
*/
|
|
isOffscreen(): boolean;
|
|
/**
|
|
* If _offscreen rendering_ is enabled returns whether it is currently painting.
|
|
*/
|
|
isPainting(): boolean;
|
|
/**
|
|
* Whether the web page is waiting for a first-response from the main resource of
|
|
* the page.
|
|
*/
|
|
isWaitingForResponse(): boolean;
|
|
/**
|
|
* the promise will resolve when the page has finished loading (see
|
|
* `did-finish-load`), and rejects if the page fails to load (see `did-fail-load`).
|
|
*
|
|
* Loads the given file in the window, `filePath` should be a path to an HTML file
|
|
* relative to the root of your application. For instance an app structure like
|
|
* this:
|
|
*
|
|
* Would require code like this
|
|
*/
|
|
loadFile(filePath: string, options?: LoadFileOptions): Promise<void>;
|
|
/**
|
|
* the promise will resolve when the page has finished loading (see
|
|
* `did-finish-load`), and rejects if the page fails to load (see `did-fail-load`).
|
|
* A noop rejection handler is already attached, which avoids unhandled rejection
|
|
* errors.
|
|
*
|
|
* Loads the `url` in the window. The `url` must contain the protocol prefix, e.g.
|
|
* the `http://` or `file://`. If the load should bypass http cache then use the
|
|
* `pragma` header to achieve it.
|
|
*/
|
|
loadURL(url: string, options?: LoadURLOptions): Promise<void>;
|
|
/**
|
|
* Opens the devtools.
|
|
*
|
|
* When `contents` is a `<webview>` tag, the `mode` would be `detach` by default,
|
|
* explicitly passing an empty `mode` can force using last used dock state.
|
|
*
|
|
* On Windows, if Windows Control Overlay is enabled, Devtools will be opened with
|
|
* `mode: 'detach'`.
|
|
*/
|
|
openDevTools(options?: OpenDevToolsOptions): void;
|
|
/**
|
|
* Executes the editing command `paste` in web page.
|
|
*/
|
|
paste(): void;
|
|
/**
|
|
* Executes the editing command `pasteAndMatchStyle` in web page.
|
|
*/
|
|
pasteAndMatchStyle(): void;
|
|
/**
|
|
* Send a message to the renderer process, optionally transferring ownership of
|
|
* zero or more `MessagePortMain` objects.
|
|
*
|
|
* The transferred `MessagePortMain` objects will be available in the renderer
|
|
* process by accessing the `ports` property of the emitted event. When they arrive
|
|
* in the renderer, they will be native DOM `MessagePort` objects.
|
|
*
|
|
* For example:
|
|
*/
|
|
postMessage(channel: string, message: any, transfer?: MessagePortMain[]): void;
|
|
/**
|
|
* When a custom `pageSize` is passed, Chromium attempts to validate platform
|
|
* specific minimum values for `width_microns` and `height_microns`. Width and
|
|
* height must both be minimum 353 microns but may be higher on some operating
|
|
* systems.
|
|
*
|
|
* Prints window's web page. When `silent` is set to `true`, Electron will pick the
|
|
* system's default printer if `deviceName` is empty and the default settings for
|
|
* printing.
|
|
*
|
|
* Use `page-break-before: always;` CSS style to force to print to a new page.
|
|
*
|
|
* Example usage:
|
|
*/
|
|
print(options?: WebContentsPrintOptions, callback?: (success: boolean, failureReason: string) => void): void;
|
|
/**
|
|
* Resolves with the generated PDF data.
|
|
*
|
|
* Prints the window's web page as PDF.
|
|
*
|
|
* The `landscape` will be ignored if `@page` CSS at-rule is used in the web page.
|
|
*
|
|
* An example of `webContents.printToPDF`:
|
|
*
|
|
* See Page.printToPdf for more information.
|
|
*/
|
|
printToPDF(options: PrintToPDFOptions): Promise<Buffer>;
|
|
/**
|
|
* Executes the editing command `redo` in web page.
|
|
*/
|
|
redo(): void;
|
|
/**
|
|
* Reloads the current web page.
|
|
*/
|
|
reload(): void;
|
|
/**
|
|
* Reloads current page and ignores cache.
|
|
*/
|
|
reloadIgnoringCache(): void;
|
|
/**
|
|
* Resolves if the removal was successful.
|
|
*
|
|
* Removes the inserted CSS from the current web page. The stylesheet is identified
|
|
* by its key, which is returned from `contents.insertCSS(css)`.
|
|
*/
|
|
removeInsertedCSS(key: string): Promise<void>;
|
|
/**
|
|
* Removes the specified path from DevTools workspace.
|
|
*/
|
|
removeWorkSpace(path: string): void;
|
|
/**
|
|
* Executes the editing command `replace` in web page.
|
|
*/
|
|
replace(text: string): void;
|
|
/**
|
|
* Executes the editing command `replaceMisspelling` in web page.
|
|
*/
|
|
replaceMisspelling(text: string): void;
|
|
/**
|
|
* resolves if the page is saved.
|
|
*/
|
|
savePage(fullPath: string, saveType: 'HTMLOnly' | 'HTMLComplete' | 'MHTML'): Promise<void>;
|
|
/**
|
|
* Scrolls to the bottom of the current `webContents`.
|
|
*/
|
|
scrollToBottom(): void;
|
|
/**
|
|
* Scrolls to the top of the current `webContents`.
|
|
*/
|
|
scrollToTop(): void;
|
|
/**
|
|
* Executes the editing command `selectAll` in web page.
|
|
*/
|
|
selectAll(): void;
|
|
/**
|
|
* Send an asynchronous message to the renderer process via `channel`, along with
|
|
* arguments. Arguments will be serialized with the Structured Clone Algorithm,
|
|
* just like `postMessage`, so prototype chains will not be included. Sending
|
|
* Functions, Promises, Symbols, WeakMaps, or WeakSets will throw an exception.
|
|
*
|
|
* :::warning
|
|
*
|
|
* Sending non-standard JavaScript types such as DOM objects or special Electron
|
|
* objects will throw an exception.
|
|
*
|
|
* :::
|
|
*
|
|
* For additional reading, refer to Electron's IPC guide.
|
|
*/
|
|
send(channel: string, ...args: any[]): void;
|
|
/**
|
|
* Sends an input `event` to the page. **Note:** The `BrowserWindow` containing the
|
|
* contents needs to be focused for `sendInputEvent()` to work.
|
|
*/
|
|
sendInputEvent(inputEvent: (MouseInputEvent) | (MouseWheelInputEvent) | (KeyboardInputEvent)): void;
|
|
/**
|
|
* Send an asynchronous message to a specific frame in a renderer process via
|
|
* `channel`, along with arguments. Arguments will be serialized with the
|
|
* Structured Clone Algorithm, just like `postMessage`, so prototype chains will
|
|
* not be included. Sending Functions, Promises, Symbols, WeakMaps, or WeakSets
|
|
* will throw an exception.
|
|
*
|
|
* > **NOTE:** Sending non-standard JavaScript types such as DOM objects or special
|
|
* Electron objects will throw an exception.
|
|
*
|
|
* The renderer process can handle the message by listening to `channel` with the
|
|
* `ipcRenderer` module.
|
|
*
|
|
* If you want to get the `frameId` of a given renderer context you should use the
|
|
* `webFrame.routingId` value. E.g.
|
|
*
|
|
* You can also read `frameId` from all incoming IPC messages in the main process.
|
|
*/
|
|
sendToFrame(frameId: (number) | ([number, number]), channel: string, ...args: any[]): void;
|
|
/**
|
|
* Mute the audio on the current web page.
|
|
*/
|
|
setAudioMuted(muted: boolean): void;
|
|
/**
|
|
* Controls whether or not this WebContents will throttle animations and timers
|
|
* when the page becomes backgrounded. This also affects the Page Visibility API.
|
|
*/
|
|
setBackgroundThrottling(allowed: boolean): void;
|
|
/**
|
|
* Changes the title of the DevTools window to `title`. This will only be visible
|
|
* if DevTools is opened in `undocked` or `detach` mode.
|
|
*/
|
|
setDevToolsTitle(title: string): void;
|
|
/**
|
|
* Uses the `devToolsWebContents` as the target `WebContents` to show devtools.
|
|
*
|
|
* The `devToolsWebContents` must not have done any navigation, and it should not
|
|
* be used for other purposes after the call.
|
|
*
|
|
* By default Electron manages the devtools by creating an internal `WebContents`
|
|
* with native view, which developers have very limited control of. With the
|
|
* `setDevToolsWebContents` method, developers can use any `WebContents` to show
|
|
* the devtools in it, including `BrowserWindow`, `BrowserView` and `<webview>`
|
|
* tag.
|
|
*
|
|
* Note that closing the devtools does not destroy the `devToolsWebContents`, it is
|
|
* caller's responsibility to destroy `devToolsWebContents`.
|
|
*
|
|
* An example of showing devtools in a `<webview>` tag:
|
|
*
|
|
* An example of showing devtools in a `BrowserWindow`:
|
|
*/
|
|
setDevToolsWebContents(devToolsWebContents: WebContents): void;
|
|
/**
|
|
* If _offscreen rendering_ is enabled sets the frame rate to the specified number.
|
|
* Only values between 1 and 240 are accepted.
|
|
*/
|
|
setFrameRate(fps: number): void;
|
|
/**
|
|
* Ignore application menu shortcuts while this web contents is focused.
|
|
*/
|
|
setIgnoreMenuShortcuts(ignore: boolean): void;
|
|
/**
|
|
* Sets the image animation policy for this webContents. The policy only affects
|
|
* _new_ images, existing images that are currently being animated are unaffected.
|
|
* This is a known limitation in Chromium, you can force image animation to be
|
|
* recalculated with `img.src = img.src` which will result in no network traffic
|
|
* but will update the animation policy.
|
|
*
|
|
* This corresponds to the animationPolicy accessibility feature in Chromium.
|
|
*/
|
|
setImageAnimationPolicy(policy: 'animate' | 'animateOnce' | 'noAnimation'): void;
|
|
/**
|
|
* Overrides the user agent for this web page.
|
|
*/
|
|
setUserAgent(userAgent: string): void;
|
|
/**
|
|
* Sets the maximum and minimum pinch-to-zoom level.
|
|
*
|
|
* > **NOTE**: Visual zoom is disabled by default in Electron. To re-enable it,
|
|
* call:
|
|
*/
|
|
setVisualZoomLevelLimits(minimumLevel: number, maximumLevel: number): Promise<void>;
|
|
/**
|
|
* Setting the WebRTC IP handling policy allows you to control which IPs are
|
|
* exposed via WebRTC. See BrowserLeaks for more details.
|
|
*/
|
|
setWebRTCIPHandlingPolicy(policy: 'default' | 'default_public_interface_only' | 'default_public_and_private_interfaces' | 'disable_non_proxied_udp'): void;
|
|
/**
|
|
* Called before creating a window a new window is requested by the renderer, e.g.
|
|
* by `window.open()`, a link with `target="_blank"`, shift+clicking on a link, or
|
|
* submitting a form with `<form target="_blank">`. See `window.open()` for more
|
|
* details and how to use this in conjunction with `did-create-window`.
|
|
*/
|
|
setWindowOpenHandler(handler: (details: HandlerDetails) => ({action: 'deny'}) | ({action: 'allow', outlivesOpener?: boolean, overrideBrowserWindowOptions?: BrowserWindowConstructorOptions})): void;
|
|
/**
|
|
* Changes the zoom factor to the specified factor. Zoom factor is zoom percent
|
|
* divided by 100, so 300% = 3.0.
|
|
*
|
|
* The factor must be greater than 0.0.
|
|
*/
|
|
setZoomFactor(factor: number): void;
|
|
/**
|
|
* Changes the zoom level to the specified level. The original size is 0 and each
|
|
* increment above or below represents zooming 20% larger or smaller to default
|
|
* limits of 300% and 50% of original size, respectively. The formula for this is
|
|
* `scale := 1.2 ^ level`.
|
|
*
|
|
* > **NOTE**: The zoom policy at the Chromium level is same-origin, meaning that
|
|
* the zoom level for a specific domain propagates across all instances of windows
|
|
* with the same domain. Differentiating the window URLs will make zoom work
|
|
* per-window.
|
|
*/
|
|
setZoomLevel(level: number): void;
|
|
/**
|
|
* Shows pop-up dictionary that searches the selected word on the page.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
showDefinitionForSelection(): void;
|
|
/**
|
|
* Sets the `item` as dragging item for current drag-drop operation, `file` is the
|
|
* absolute path of the file to be dragged, and `icon` is the image showing under
|
|
* the cursor when dragging.
|
|
*/
|
|
startDrag(item: Item): void;
|
|
/**
|
|
* If _offscreen rendering_ is enabled and not painting, start painting.
|
|
*/
|
|
startPainting(): void;
|
|
/**
|
|
* Stops any pending navigation.
|
|
*/
|
|
stop(): void;
|
|
/**
|
|
* Stops any `findInPage` request for the `webContents` with the provided `action`.
|
|
*/
|
|
stopFindInPage(action: 'clearSelection' | 'keepSelection' | 'activateSelection'): void;
|
|
/**
|
|
* If _offscreen rendering_ is enabled and painting, stop painting.
|
|
*/
|
|
stopPainting(): void;
|
|
/**
|
|
* Indicates whether the snapshot has been created successfully.
|
|
*
|
|
* Takes a V8 heap snapshot and saves it to `filePath`.
|
|
*/
|
|
takeHeapSnapshot(filePath: string): Promise<void>;
|
|
/**
|
|
* Toggles the developer tools.
|
|
*/
|
|
toggleDevTools(): void;
|
|
/**
|
|
* Executes the editing command `undo` in web page.
|
|
*/
|
|
undo(): void;
|
|
/**
|
|
* Executes the editing command `unselect` in web page.
|
|
*/
|
|
unselect(): void;
|
|
/**
|
|
* A `boolean` property that determines whether this page is muted.
|
|
*/
|
|
audioMuted: boolean;
|
|
/**
|
|
* A `boolean` property that determines whether or not this WebContents will
|
|
* throttle animations and timers when the page becomes backgrounded. This also
|
|
* affects the Page Visibility API.
|
|
*/
|
|
backgroundThrottling: boolean;
|
|
/**
|
|
* A `Debugger` instance for this webContents.
|
|
*
|
|
*/
|
|
readonly debugger: Debugger;
|
|
/**
|
|
* A `WebContents | null` property that represents the of DevTools `WebContents`
|
|
* associated with a given `WebContents`.
|
|
*
|
|
* **Note:** Users should never store this object because it may become `null` when
|
|
* the DevTools has been closed.
|
|
*
|
|
*/
|
|
readonly devToolsWebContents: (WebContents) | (null);
|
|
/**
|
|
* An `Integer` property that sets the frame rate of the web contents to the
|
|
* specified number. Only values between 1 and 240 are accepted.
|
|
*
|
|
* Only applicable if _offscreen rendering_ is enabled.
|
|
*/
|
|
frameRate: number;
|
|
/**
|
|
* A `WebContents` instance that might own this `WebContents`.
|
|
*
|
|
*/
|
|
readonly hostWebContents: WebContents;
|
|
/**
|
|
* A `Integer` representing the unique ID of this WebContents. Each ID is unique
|
|
* among all `WebContents` instances of the entire Electron application.
|
|
*
|
|
*/
|
|
readonly id: number;
|
|
/**
|
|
* An `IpcMain` scoped to just IPC messages sent from this WebContents.
|
|
*
|
|
* IPC messages sent with `ipcRenderer.send`, `ipcRenderer.sendSync` or
|
|
* `ipcRenderer.postMessage` will be delivered in the following order:
|
|
*
|
|
* * `contents.on('ipc-message')`
|
|
* * `contents.mainFrame.on(channel)`
|
|
* * `contents.ipc.on(channel)`
|
|
* * `ipcMain.on(channel)`
|
|
*
|
|
* Handlers registered with `invoke` will be checked in the following order. The
|
|
* first one that is defined will be called, the rest will be ignored.
|
|
*
|
|
* * `contents.mainFrame.handle(channel)`
|
|
* * `contents.handle(channel)`
|
|
* * `ipcMain.handle(channel)`
|
|
*
|
|
* A handler or event listener registered on the WebContents will receive IPC
|
|
* messages sent from any frame, including child frames. In most cases, only the
|
|
* main frame can send IPC messages. However, if the `nodeIntegrationInSubFrames`
|
|
* option is enabled, it is possible for child frames to send IPC messages also. In
|
|
* that case, handlers should check the `senderFrame` property of the IPC event to
|
|
* ensure that the message is coming from the expected frame. Alternatively,
|
|
* register handlers on the appropriate frame directly using the `WebFrameMain.ipc`
|
|
* interface.
|
|
*
|
|
*/
|
|
readonly ipc: IpcMain;
|
|
/**
|
|
* A `WebFrameMain` property that represents the top frame of the page's frame
|
|
* hierarchy.
|
|
*
|
|
*/
|
|
readonly mainFrame: WebFrameMain;
|
|
/**
|
|
* A `WebFrameMain` property that represents the frame that opened this
|
|
* WebContents, either with open(), or by navigating a link with a target
|
|
* attribute.
|
|
*
|
|
*/
|
|
readonly opener: WebFrameMain;
|
|
/**
|
|
* A `Session` used by this webContents.
|
|
*
|
|
*/
|
|
readonly session: Session;
|
|
/**
|
|
* A `string` property that determines the user agent for this web page.
|
|
*/
|
|
userAgent: string;
|
|
/**
|
|
* A `number` property that determines the zoom factor for this web contents.
|
|
*
|
|
* The zoom factor is the zoom percent divided by 100, so 300% = 3.0.
|
|
*/
|
|
zoomFactor: number;
|
|
/**
|
|
* A `number` property that determines the zoom level for this web contents.
|
|
*
|
|
* The original size is 0 and each increment above or below represents zooming 20%
|
|
* larger or smaller to default limits of 300% and 50% of original size,
|
|
* respectively. The formula for this is `scale := 1.2 ^ level`.
|
|
*/
|
|
zoomLevel: number;
|
|
}
|
|
|
|
interface WebFrame {
|
|
|
|
// Docs: https://electronjs.org/docs/api/web-frame
|
|
|
|
/**
|
|
* Attempts to free memory that is no longer being used (like images from a
|
|
* previous navigation).
|
|
*
|
|
* Note that blindly calling this method probably makes Electron slower since it
|
|
* will have to refill these emptied caches, you should only call it if an event in
|
|
* your app has occurred that makes you think your page is actually using less
|
|
* memory (i.e. you have navigated from a super heavy page to a mostly empty one,
|
|
* and intend to stay there).
|
|
*/
|
|
clearCache(): void;
|
|
/**
|
|
* A promise that resolves with the result of the executed code or is rejected if
|
|
* execution throws or results in a rejected promise.
|
|
*
|
|
* Evaluates `code` in page.
|
|
*
|
|
* In the browser window some HTML APIs like `requestFullScreen` can only be
|
|
* invoked by a gesture from the user. Setting `userGesture` to `true` will remove
|
|
* this limitation.
|
|
*/
|
|
executeJavaScript(code: string, userGesture?: boolean, callback?: (result: any, error: Error) => void): Promise<any>;
|
|
/**
|
|
* A promise that resolves with the result of the executed code or is rejected if
|
|
* execution could not start.
|
|
*
|
|
* Works like `executeJavaScript` but evaluates `scripts` in an isolated context.
|
|
*
|
|
* Note that when the execution of script fails, the returned promise will not
|
|
* reject and the `result` would be `undefined`. This is because Chromium does not
|
|
* dispatch errors of isolated worlds to foreign worlds.
|
|
*/
|
|
executeJavaScriptInIsolatedWorld(worldId: number, scripts: WebSource[], userGesture?: boolean, callback?: (result: any, error: Error) => void): Promise<any>;
|
|
/**
|
|
* A child of `webFrame` with the supplied `name`, `null` would be returned if
|
|
* there's no such frame or if the frame is not in the current renderer process.
|
|
*/
|
|
findFrameByName(name: string): WebFrame;
|
|
/**
|
|
* that has the supplied `routingId`, `null` if not found.
|
|
*/
|
|
findFrameByRoutingId(routingId: number): WebFrame;
|
|
/**
|
|
* The frame element in `webFrame's` document selected by `selector`, `null` would
|
|
* be returned if `selector` does not select a frame or if the frame is not in the
|
|
* current renderer process.
|
|
*/
|
|
getFrameForSelector(selector: string): WebFrame;
|
|
/**
|
|
* * `images` MemoryUsageDetails
|
|
* * `scripts` MemoryUsageDetails
|
|
* * `cssStyleSheets` MemoryUsageDetails
|
|
* * `xslStyleSheets` MemoryUsageDetails
|
|
* * `fonts` MemoryUsageDetails
|
|
* * `other` MemoryUsageDetails
|
|
*
|
|
* Returns an object describing usage information of Blink's internal memory
|
|
* caches.
|
|
*
|
|
* This will generate:
|
|
*/
|
|
getResourceUsage(): ResourceUsage;
|
|
/**
|
|
* A list of suggested words for a given word. If the word is spelled correctly,
|
|
* the result will be empty.
|
|
*/
|
|
getWordSuggestions(word: string): string[];
|
|
/**
|
|
* The current zoom factor.
|
|
*/
|
|
getZoomFactor(): number;
|
|
/**
|
|
* The current zoom level.
|
|
*/
|
|
getZoomLevel(): number;
|
|
/**
|
|
* A key for the inserted CSS that can later be used to remove the CSS via
|
|
* `webFrame.removeInsertedCSS(key)`.
|
|
*
|
|
* Injects CSS into the current web page and returns a unique key for the inserted
|
|
* stylesheet.
|
|
*/
|
|
insertCSS(css: string, options?: InsertCSSOptions): string;
|
|
/**
|
|
* Inserts `text` to the focused element.
|
|
*/
|
|
insertText(text: string): void;
|
|
/**
|
|
* True if the word is misspelled according to the built in spellchecker, false
|
|
* otherwise. If no dictionary is loaded, always return false.
|
|
*/
|
|
isWordMisspelled(word: string): boolean;
|
|
/**
|
|
* Removes the inserted CSS from the current web page. The stylesheet is identified
|
|
* by its key, which is returned from `webFrame.insertCSS(css)`.
|
|
*/
|
|
removeInsertedCSS(key: string): void;
|
|
/**
|
|
* Set the security origin, content security policy and name of the isolated world.
|
|
* Note: If the `csp` is specified, then the `securityOrigin` also has to be
|
|
* specified.
|
|
*/
|
|
setIsolatedWorldInfo(worldId: number, info: Info): void;
|
|
/**
|
|
* Sets a provider for spell checking in input fields and text areas.
|
|
*
|
|
* If you want to use this method you must disable the builtin spellchecker when
|
|
* you construct the window.
|
|
*
|
|
* The `provider` must be an object that has a `spellCheck` method that accepts an
|
|
* array of individual words for spellchecking. The `spellCheck` function runs
|
|
* asynchronously and calls the `callback` function with an array of misspelt words
|
|
* when complete.
|
|
*
|
|
* An example of using node-spellchecker as provider:
|
|
*/
|
|
setSpellCheckProvider(language: string, provider: Provider): void;
|
|
/**
|
|
* Sets the maximum and minimum pinch-to-zoom level.
|
|
*
|
|
* > **NOTE**: Visual zoom is disabled by default in Electron. To re-enable it,
|
|
* call:
|
|
*
|
|
* > **NOTE**: Visual zoom only applies to pinch-to-zoom behavior. Cmd+/-/0 zoom
|
|
* shortcuts are controlled by the 'zoomIn', 'zoomOut', and 'resetZoom' MenuItem
|
|
* roles in the application Menu. To disable shortcuts, manually define the Menu
|
|
* and omit zoom roles from the definition.
|
|
*/
|
|
setVisualZoomLevelLimits(minimumLevel: number, maximumLevel: number): void;
|
|
/**
|
|
* Changes the zoom factor to the specified factor. Zoom factor is zoom percent
|
|
* divided by 100, so 300% = 3.0.
|
|
*
|
|
* The factor must be greater than 0.0.
|
|
*/
|
|
setZoomFactor(factor: number): void;
|
|
/**
|
|
* Changes the zoom level to the specified level. The original size is 0 and each
|
|
* increment above or below represents zooming 20% larger or smaller to default
|
|
* limits of 300% and 50% of original size, respectively.
|
|
*
|
|
* > **NOTE**: The zoom policy at the Chromium level is same-origin, meaning that
|
|
* the zoom level for a specific domain propagates across all instances of windows
|
|
* with the same domain. Differentiating the window URLs will make zoom work
|
|
* per-window.
|
|
*/
|
|
setZoomLevel(level: number): void;
|
|
/**
|
|
* A `WebFrame | null` representing the first child frame of `webFrame`, the
|
|
* property would be `null` if `webFrame` has no children or if first child is not
|
|
* in the current renderer process.
|
|
*
|
|
*/
|
|
readonly firstChild: (WebFrame) | (null);
|
|
/**
|
|
* A `WebFrame | null` representing next sibling frame, the property would be
|
|
* `null` if `webFrame` is the last frame in its parent or if the next sibling is
|
|
* not in the current renderer process.
|
|
*
|
|
*/
|
|
readonly nextSibling: (WebFrame) | (null);
|
|
/**
|
|
* A `WebFrame | null` representing the frame which opened `webFrame`, the property
|
|
* would be `null` if there's no opener or opener is not in the current renderer
|
|
* process.
|
|
*
|
|
*/
|
|
readonly opener: (WebFrame) | (null);
|
|
/**
|
|
* A `WebFrame | null` representing parent frame of `webFrame`, the property would
|
|
* be `null` if `webFrame` is top or parent is not in the current renderer process.
|
|
*
|
|
*/
|
|
readonly parent: (WebFrame) | (null);
|
|
/**
|
|
* An `Integer` representing the unique frame id in the current renderer process.
|
|
* Distinct WebFrame instances that refer to the same underlying frame will have
|
|
* the same `routingId`.
|
|
*
|
|
*/
|
|
readonly routingId: number;
|
|
/**
|
|
* A `WebFrame | null` representing top frame in frame hierarchy to which
|
|
* `webFrame` belongs, the property would be `null` if top frame is not in the
|
|
* current renderer process.
|
|
*
|
|
*/
|
|
readonly top: (WebFrame) | (null);
|
|
}
|
|
|
|
class WebFrameMain extends NodeEventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/web-frame-main
|
|
|
|
/**
|
|
* A frame with the given process and routing IDs, or `undefined` if there is no
|
|
* WebFrameMain associated with the given IDs.
|
|
*/
|
|
static fromId(processId: number, routingId: number): (WebFrameMain) | (undefined);
|
|
/**
|
|
* Emitted when the document is loaded.
|
|
*/
|
|
on(event: 'dom-ready', listener: Function): this;
|
|
once(event: 'dom-ready', listener: Function): this;
|
|
addListener(event: 'dom-ready', listener: Function): this;
|
|
removeListener(event: 'dom-ready', listener: Function): this;
|
|
/**
|
|
* A promise that resolves with the result of the executed code or is rejected if
|
|
* execution throws or results in a rejected promise.
|
|
*
|
|
* Evaluates `code` in page.
|
|
*
|
|
* In the browser window some HTML APIs like `requestFullScreen` can only be
|
|
* invoked by a gesture from the user. Setting `userGesture` to `true` will remove
|
|
* this limitation.
|
|
*/
|
|
executeJavaScript(code: string, userGesture?: boolean): Promise<unknown>;
|
|
/**
|
|
* Send a message to the renderer process, optionally transferring ownership of
|
|
* zero or more `MessagePortMain` objects.
|
|
*
|
|
* The transferred `MessagePortMain` objects will be available in the renderer
|
|
* process by accessing the `ports` property of the emitted event. When they arrive
|
|
* in the renderer, they will be native DOM `MessagePort` objects.
|
|
*
|
|
* For example:
|
|
*/
|
|
postMessage(channel: string, message: any, transfer?: MessagePortMain[]): void;
|
|
/**
|
|
* Whether the reload was initiated successfully. Only results in `false` when the
|
|
* frame has no history.
|
|
*/
|
|
reload(): boolean;
|
|
/**
|
|
* Send an asynchronous message to the renderer process via `channel`, along with
|
|
* arguments. Arguments will be serialized with the Structured Clone Algorithm,
|
|
* just like `postMessage`, so prototype chains will not be included. Sending
|
|
* Functions, Promises, Symbols, WeakMaps, or WeakSets will throw an exception.
|
|
*
|
|
* The renderer process can handle the message by listening to `channel` with the
|
|
* `ipcRenderer` module.
|
|
*/
|
|
send(channel: string, ...args: any[]): void;
|
|
/**
|
|
* A `WebFrameMain[]` collection containing the direct descendents of `frame`.
|
|
*
|
|
*/
|
|
readonly frames: WebFrameMain[];
|
|
/**
|
|
* A `WebFrameMain[]` collection containing every frame in the subtree of `frame`,
|
|
* including itself. This can be useful when traversing through all frames.
|
|
*
|
|
*/
|
|
readonly framesInSubtree: WebFrameMain[];
|
|
/**
|
|
* An `Integer` representing the id of the frame's internal FrameTreeNode instance.
|
|
* This id is browser-global and uniquely identifies a frame that hosts content.
|
|
* The identifier is fixed at the creation of the frame and stays constant for the
|
|
* lifetime of the frame. When the frame is removed, the id is not used again.
|
|
*
|
|
*/
|
|
readonly frameTreeNodeId: number;
|
|
/**
|
|
* An `IpcMain` instance scoped to the frame.
|
|
*
|
|
* IPC messages sent with `ipcRenderer.send`, `ipcRenderer.sendSync` or
|
|
* `ipcRenderer.postMessage` will be delivered in the following order:
|
|
*
|
|
* * `contents.on('ipc-message')`
|
|
* * `contents.mainFrame.on(channel)`
|
|
* * `contents.ipc.on(channel)`
|
|
* * `ipcMain.on(channel)`
|
|
*
|
|
* Handlers registered with `invoke` will be checked in the following order. The
|
|
* first one that is defined will be called, the rest will be ignored.
|
|
*
|
|
* * `contents.mainFrame.handle(channel)`
|
|
* * `contents.handle(channel)`
|
|
* * `ipcMain.handle(channel)`
|
|
*
|
|
* In most cases, only the main frame of a WebContents can send or receive IPC
|
|
* messages. However, if the `nodeIntegrationInSubFrames` option is enabled, it is
|
|
* possible for child frames to send and receive IPC messages also. The
|
|
* `WebContents.ipc` interface may be more convenient when
|
|
* `nodeIntegrationInSubFrames` is not enabled.
|
|
*
|
|
*/
|
|
readonly ipc: IpcMain;
|
|
/**
|
|
* A `string` representing the frame name.
|
|
*
|
|
*/
|
|
readonly name: string;
|
|
/**
|
|
* A `string` representing the current origin of the frame, serialized according to
|
|
* RFC 6454. This may be different from the URL. For instance, if the frame is a
|
|
* child window opened to `about:blank`, then `frame.origin` will return the parent
|
|
* frame's origin, while `frame.url` will return the empty string. Pages without a
|
|
* scheme/host/port triple origin will have the serialized origin of `"null"` (that
|
|
* is, the string containing the letters n, u, l, l).
|
|
*
|
|
*/
|
|
readonly origin: string;
|
|
/**
|
|
* An `Integer` representing the operating system `pid` of the process which owns
|
|
* this frame.
|
|
*
|
|
*/
|
|
readonly osProcessId: number;
|
|
/**
|
|
* A `WebFrameMain | null` representing parent frame of `frame`, the property would
|
|
* be `null` if `frame` is the top frame in the frame hierarchy.
|
|
*
|
|
*/
|
|
readonly parent: (WebFrameMain) | (null);
|
|
/**
|
|
* An `Integer` representing the Chromium internal `pid` of the process which owns
|
|
* this frame. This is not the same as the OS process ID; to read that use
|
|
* `frame.osProcessId`.
|
|
*
|
|
*/
|
|
readonly processId: number;
|
|
/**
|
|
* An `Integer` representing the unique frame id in the current renderer process.
|
|
* Distinct `WebFrameMain` instances that refer to the same underlying frame will
|
|
* have the same `routingId`.
|
|
*
|
|
*/
|
|
readonly routingId: number;
|
|
/**
|
|
* A `WebFrameMain | null` representing top frame in the frame hierarchy to which
|
|
* `frame` belongs.
|
|
*
|
|
*/
|
|
readonly top: (WebFrameMain) | (null);
|
|
/**
|
|
* A `string` representing the current URL of the frame.
|
|
*
|
|
*/
|
|
readonly url: string;
|
|
/**
|
|
* A `string` representing the visibility state of the frame.
|
|
*
|
|
* See also how the Page Visibility API is affected by other Electron APIs.
|
|
*
|
|
*/
|
|
readonly visibilityState: string;
|
|
}
|
|
|
|
interface WebPreferences {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/web-preferences
|
|
|
|
/**
|
|
* An alternative title string provided only to accessibility tools such as screen
|
|
* readers. This string is not directly visible to users.
|
|
*/
|
|
accessibleTitle?: string;
|
|
/**
|
|
* A list of strings that will be appended to `process.argv` in the renderer
|
|
* process of this app. Useful for passing small bits of data down to renderer
|
|
* process preload scripts.
|
|
*/
|
|
additionalArguments?: string[];
|
|
/**
|
|
* Allow an https page to run JavaScript, CSS or plugins from http URLs. Default is
|
|
* `false`.
|
|
*/
|
|
allowRunningInsecureContent?: boolean;
|
|
/**
|
|
* Autoplay policy to apply to content in the window, can be
|
|
* `no-user-gesture-required`, `user-gesture-required`,
|
|
* `document-user-activation-required`. Defaults to `no-user-gesture-required`.
|
|
*/
|
|
autoplayPolicy?: ('no-user-gesture-required' | 'user-gesture-required' | 'document-user-activation-required');
|
|
/**
|
|
* Whether to throttle animations and timers when the page becomes background. This
|
|
* also affects the Page Visibility API. Defaults to `true`.
|
|
*/
|
|
backgroundThrottling?: boolean;
|
|
/**
|
|
* Whether to run Electron APIs and the specified `preload` script in a separate
|
|
* JavaScript context. Defaults to `true`. The context that the `preload` script
|
|
* runs in will only have access to its own dedicated `document` and `window`
|
|
* globals, as well as its own set of JavaScript builtins (`Array`, `Object`,
|
|
* `JSON`, etc.), which are all invisible to the loaded content. The Electron API
|
|
* will only be available in the `preload` script and not the loaded page. This
|
|
* option should be used when loading potentially untrusted remote content to
|
|
* ensure the loaded content cannot tamper with the `preload` script and any
|
|
* Electron APIs being used. This option uses the same technique used by Chrome
|
|
* Content Scripts. You can access this context in the dev tools by selecting the
|
|
* 'Electron Isolated Context' entry in the combo box at the top of the Console
|
|
* tab.
|
|
*/
|
|
contextIsolation?: boolean;
|
|
/**
|
|
* Defaults to `ISO-8859-1`.
|
|
*/
|
|
defaultEncoding?: string;
|
|
/**
|
|
* Sets the default font for the font-family.
|
|
*/
|
|
defaultFontFamily?: DefaultFontFamily;
|
|
/**
|
|
* Defaults to `16`.
|
|
*/
|
|
defaultFontSize?: number;
|
|
/**
|
|
* Defaults to `13`.
|
|
*/
|
|
defaultMonospaceFontSize?: number;
|
|
/**
|
|
* Whether to enable DevTools. If it is set to `false`, can not use
|
|
* `BrowserWindow.webContents.openDevTools()` to open DevTools. Default is `true`.
|
|
*/
|
|
devTools?: boolean;
|
|
/**
|
|
* A list of feature strings separated by `,`, like `CSSVariables,KeyboardEventKey`
|
|
* to disable. The full list of supported feature strings can be found in the
|
|
* RuntimeEnabledFeatures.json5 file.
|
|
*/
|
|
disableBlinkFeatures?: string;
|
|
/**
|
|
* Whether to disable dialogs completely. Overrides `safeDialogs`. Default is
|
|
* `false`.
|
|
*/
|
|
disableDialogs?: boolean;
|
|
/**
|
|
* Whether to prevent the window from resizing when entering HTML Fullscreen.
|
|
* Default is `false`.
|
|
*/
|
|
disableHtmlFullscreenWindowResize?: boolean;
|
|
/**
|
|
* A list of feature strings separated by `,`, like `CSSVariables,KeyboardEventKey`
|
|
* to enable. The full list of supported feature strings can be found in the
|
|
* RuntimeEnabledFeatures.json5 file.
|
|
*/
|
|
enableBlinkFeatures?: string;
|
|
/**
|
|
* Whether to enable preferred size mode. The preferred size is the minimum size
|
|
* needed to contain the layout of the document—without requiring scrolling.
|
|
* Enabling this will cause the `preferred-size-changed` event to be emitted on the
|
|
* `WebContents` when the preferred size changes. Default is `false`.
|
|
*/
|
|
enablePreferredSizeMode?: boolean;
|
|
/**
|
|
* Whether to enable the WebSQL api. Default is `true`.
|
|
*/
|
|
enableWebSQL?: boolean;
|
|
/**
|
|
* Enables Chromium's experimental features. Default is `false`.
|
|
*/
|
|
experimentalFeatures?: boolean;
|
|
/**
|
|
* Specifies how to run image animations (E.g. GIFs). Can be `animate`,
|
|
* `animateOnce` or `noAnimation`. Default is `animate`.
|
|
*/
|
|
imageAnimationPolicy?: ('animate' | 'animateOnce' | 'noAnimation');
|
|
/**
|
|
* Enables image support. Default is `true`.
|
|
*/
|
|
images?: boolean;
|
|
/**
|
|
* Enables JavaScript support. Default is `true`.
|
|
*/
|
|
javascript?: boolean;
|
|
/**
|
|
* Defaults to `0`.
|
|
*/
|
|
minimumFontSize?: number;
|
|
/**
|
|
* Whether dragging and dropping a file or link onto the page causes a navigation.
|
|
* Default is `false`.
|
|
*/
|
|
navigateOnDragDrop?: boolean;
|
|
/**
|
|
* Whether node integration is enabled. Default is `false`.
|
|
*/
|
|
nodeIntegration?: boolean;
|
|
/**
|
|
* Experimental option for enabling Node.js support in sub-frames such as iframes
|
|
* and child windows. All your preloads will load for every iframe, you can use
|
|
* `process.isMainFrame` to determine if you are in the main frame or not.
|
|
*/
|
|
nodeIntegrationInSubFrames?: boolean;
|
|
/**
|
|
* Whether node integration is enabled in web workers. Default is `false`. More
|
|
* about this can be found in Multithreading.
|
|
*/
|
|
nodeIntegrationInWorker?: boolean;
|
|
/**
|
|
* Whether to enable offscreen rendering for the browser window. Defaults to
|
|
* `false`. See the offscreen rendering tutorial for more details.
|
|
*/
|
|
offscreen?: boolean;
|
|
/**
|
|
* Sets the session used by the page according to the session's partition string.
|
|
* If `partition` starts with `persist:`, the page will use a persistent session
|
|
* available to all pages in the app with the same `partition`. If there is no
|
|
* `persist:` prefix, the page will use an in-memory session. By assigning the same
|
|
* `partition`, multiple pages can share the same session. Default is the default
|
|
* session.
|
|
*/
|
|
partition?: string;
|
|
/**
|
|
* Whether plugins should be enabled. Default is `false`.
|
|
*/
|
|
plugins?: boolean;
|
|
/**
|
|
* Specifies a script that will be loaded before other scripts run in the page.
|
|
* This script will always have access to node APIs no matter whether node
|
|
* integration is turned on or off. The value should be the absolute file path to
|
|
* the script. When node integration is turned off, the preload script can
|
|
* reintroduce Node global symbols back to the global scope. See example here.
|
|
*/
|
|
preload?: string;
|
|
/**
|
|
* Whether to enable browser style consecutive dialog protection. Default is
|
|
* `false`.
|
|
*/
|
|
safeDialogs?: boolean;
|
|
/**
|
|
* The message to display when consecutive dialog protection is triggered. If not
|
|
* defined the default message would be used, note that currently the default
|
|
* message is in English and not localized.
|
|
*/
|
|
safeDialogsMessage?: string;
|
|
/**
|
|
* If set, this will sandbox the renderer associated with the window, making it
|
|
* compatible with the Chromium OS-level sandbox and disabling the Node.js engine.
|
|
* This is not the same as the `nodeIntegration` option and the APIs available to
|
|
* the preload script are more limited. Read more about the option here.
|
|
*/
|
|
sandbox?: boolean;
|
|
/**
|
|
* Enables scroll bounce (rubber banding) effect on macOS. Default is `false`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
scrollBounce?: boolean;
|
|
/**
|
|
* Sets the session used by the page. Instead of passing the Session object
|
|
* directly, you can also choose to use the `partition` option instead, which
|
|
* accepts a partition string. When both `session` and `partition` are provided,
|
|
* `session` will be preferred. Default is the default session.
|
|
*/
|
|
session?: Session;
|
|
/**
|
|
* Whether to enable the builtin spellchecker. Default is `true`.
|
|
*/
|
|
spellcheck?: boolean;
|
|
/**
|
|
* Make TextArea elements resizable. Default is `true`.
|
|
*/
|
|
textAreasAreResizable?: boolean;
|
|
/**
|
|
* Enforces the v8 code caching policy used by blink. Accepted values are
|
|
*/
|
|
v8CacheOptions?: ('none' | 'code' | 'bypassHeatCheck' | 'bypassHeatCheckAndEagerCompile');
|
|
/**
|
|
* Enables WebGL support. Default is `true`.
|
|
*/
|
|
webgl?: boolean;
|
|
/**
|
|
* When `false`, it will disable the same-origin policy (usually using testing
|
|
* websites by people), and set `allowRunningInsecureContent` to `true` if this
|
|
* options has not been set by user. Default is `true`.
|
|
*/
|
|
webSecurity?: boolean;
|
|
/**
|
|
* Whether to enable the `<webview>` tag. Defaults to `false`. **Note:** The
|
|
* `preload` script configured for the `<webview>` will have node integration
|
|
* enabled when it is executed so you should ensure remote/untrusted content is not
|
|
* able to create a `<webview>` tag with a possibly malicious `preload` script. You
|
|
* can use the `will-attach-webview` event on webContents to strip away the
|
|
* `preload` script and to validate or alter the `<webview>`'s initial settings.
|
|
*/
|
|
webviewTag?: boolean;
|
|
/**
|
|
* The default zoom factor of the page, `3.0` represents `300%`. Default is `1.0`.
|
|
*/
|
|
zoomFactor?: number;
|
|
}
|
|
|
|
class WebRequest {
|
|
|
|
// Docs: https://electronjs.org/docs/api/web-request
|
|
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when a server initiated
|
|
* redirect is about to occur.
|
|
*/
|
|
onBeforeRedirect(filter: WebRequestFilter, listener: ((details: OnBeforeRedirectListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when a server initiated
|
|
* redirect is about to occur.
|
|
*/
|
|
onBeforeRedirect(listener: ((details: OnBeforeRedirectListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details, callback)` when a request
|
|
* is about to occur.
|
|
*
|
|
* The `uploadData` is an array of `UploadData` objects.
|
|
*
|
|
* The `callback` has to be called with an `response` object.
|
|
*
|
|
* Some examples of valid `urls`:
|
|
*/
|
|
onBeforeRequest(filter: WebRequestFilter, listener: ((details: OnBeforeRequestListenerDetails, callback: (response: CallbackResponse) => void) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details, callback)` when a request
|
|
* is about to occur.
|
|
*
|
|
* The `uploadData` is an array of `UploadData` objects.
|
|
*
|
|
* The `callback` has to be called with an `response` object.
|
|
*
|
|
* Some examples of valid `urls`:
|
|
*/
|
|
onBeforeRequest(listener: ((details: OnBeforeRequestListenerDetails, callback: (response: CallbackResponse) => void) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details, callback)` before sending
|
|
* an HTTP request, once the request headers are available. This may occur after a
|
|
* TCP connection is made to the server, but before any http data is sent.
|
|
*
|
|
* The `callback` has to be called with a `response` object.
|
|
*/
|
|
onBeforeSendHeaders(filter: WebRequestFilter, listener: ((details: OnBeforeSendHeadersListenerDetails, callback: (beforeSendResponse: BeforeSendResponse) => void) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details, callback)` before sending
|
|
* an HTTP request, once the request headers are available. This may occur after a
|
|
* TCP connection is made to the server, but before any http data is sent.
|
|
*
|
|
* The `callback` has to be called with a `response` object.
|
|
*/
|
|
onBeforeSendHeaders(listener: ((details: OnBeforeSendHeadersListenerDetails, callback: (beforeSendResponse: BeforeSendResponse) => void) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when a request is
|
|
* completed.
|
|
*/
|
|
onCompleted(filter: WebRequestFilter, listener: ((details: OnCompletedListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when a request is
|
|
* completed.
|
|
*/
|
|
onCompleted(listener: ((details: OnCompletedListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when an error occurs.
|
|
*/
|
|
onErrorOccurred(filter: WebRequestFilter, listener: ((details: OnErrorOccurredListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when an error occurs.
|
|
*/
|
|
onErrorOccurred(listener: ((details: OnErrorOccurredListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details, callback)` when HTTP
|
|
* response headers of a request have been received.
|
|
*
|
|
* The `callback` has to be called with a `response` object.
|
|
*/
|
|
onHeadersReceived(filter: WebRequestFilter, listener: ((details: OnHeadersReceivedListenerDetails, callback: (headersReceivedResponse: HeadersReceivedResponse) => void) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details, callback)` when HTTP
|
|
* response headers of a request have been received.
|
|
*
|
|
* The `callback` has to be called with a `response` object.
|
|
*/
|
|
onHeadersReceived(listener: ((details: OnHeadersReceivedListenerDetails, callback: (headersReceivedResponse: HeadersReceivedResponse) => void) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when first byte of the
|
|
* response body is received. For HTTP requests, this means that the status line
|
|
* and response headers are available.
|
|
*/
|
|
onResponseStarted(filter: WebRequestFilter, listener: ((details: OnResponseStartedListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` when first byte of the
|
|
* response body is received. For HTTP requests, this means that the status line
|
|
* and response headers are available.
|
|
*/
|
|
onResponseStarted(listener: ((details: OnResponseStartedListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` just before a request is
|
|
* going to be sent to the server, modifications of previous `onBeforeSendHeaders`
|
|
* response are visible by the time this listener is fired.
|
|
*/
|
|
onSendHeaders(filter: WebRequestFilter, listener: ((details: OnSendHeadersListenerDetails) => void) | (null)): void;
|
|
/**
|
|
* The `listener` will be called with `listener(details)` just before a request is
|
|
* going to be sent to the server, modifications of previous `onBeforeSendHeaders`
|
|
* response are visible by the time this listener is fired.
|
|
*/
|
|
onSendHeaders(listener: ((details: OnSendHeadersListenerDetails) => void) | (null)): void;
|
|
}
|
|
|
|
interface WebRequestFilter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/web-request-filter
|
|
|
|
/**
|
|
* Array of types that will be used to filter out the requests that do not match
|
|
* the types. When not specified, all types will be matched. Can be `mainFrame`,
|
|
* `subFrame`, `stylesheet`, `script`, `image`, `font`, `object`, `xhr`, `ping`,
|
|
* `cspReport`, `media` or `webSocket`.
|
|
*/
|
|
types?: Array<'mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket'>;
|
|
/**
|
|
* Array of URL patterns that will be used to filter out the requests that do not
|
|
* match the URL patterns.
|
|
*/
|
|
urls: string[];
|
|
}
|
|
|
|
interface WebSource {
|
|
|
|
// Docs: https://electronjs.org/docs/api/structures/web-source
|
|
|
|
code: string;
|
|
url?: string;
|
|
}
|
|
|
|
interface WebviewTag extends HTMLElement {
|
|
|
|
// Docs: https://electronjs.org/docs/api/webview-tag
|
|
|
|
/**
|
|
* Fired when a load has committed. This includes navigation within the current
|
|
* document as well as subframe document-level loads, but does not include
|
|
* asynchronous resource loads.
|
|
*/
|
|
addEventListener(event: 'load-commit', listener: (event: LoadCommitEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'load-commit', listener: (event: LoadCommitEvent) => void): this;
|
|
/**
|
|
* Fired when the navigation is done, i.e. the spinner of the tab will stop
|
|
* spinning, and the `onload` event is dispatched.
|
|
*/
|
|
addEventListener(event: 'did-finish-load', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-finish-load', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* This event is like `did-finish-load`, but fired when the load failed or was
|
|
* cancelled, e.g. `window.stop()` is invoked.
|
|
*/
|
|
addEventListener(event: 'did-fail-load', listener: (event: DidFailLoadEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-fail-load', listener: (event: DidFailLoadEvent) => void): this;
|
|
/**
|
|
* Fired when a frame has done navigation.
|
|
*/
|
|
addEventListener(event: 'did-frame-finish-load', listener: (event: DidFrameFinishLoadEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-frame-finish-load', listener: (event: DidFrameFinishLoadEvent) => void): this;
|
|
/**
|
|
* Corresponds to the points in time when the spinner of the tab starts spinning.
|
|
*/
|
|
addEventListener(event: 'did-start-loading', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-start-loading', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Corresponds to the points in time when the spinner of the tab stops spinning.
|
|
*/
|
|
addEventListener(event: 'did-stop-loading', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-stop-loading', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when attached to the embedder web contents.
|
|
*/
|
|
addEventListener(event: 'did-attach', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-attach', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when document in the given frame is loaded.
|
|
*/
|
|
addEventListener(event: 'dom-ready', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'dom-ready', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when page title is set during navigation. `explicitSet` is false when
|
|
* title is synthesized from file url.
|
|
*/
|
|
addEventListener(event: 'page-title-updated', listener: (event: PageTitleUpdatedEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'page-title-updated', listener: (event: PageTitleUpdatedEvent) => void): this;
|
|
/**
|
|
* Fired when page receives favicon urls.
|
|
*/
|
|
addEventListener(event: 'page-favicon-updated', listener: (event: PageFaviconUpdatedEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'page-favicon-updated', listener: (event: PageFaviconUpdatedEvent) => void): this;
|
|
/**
|
|
* Fired when page enters fullscreen triggered by HTML API.
|
|
*/
|
|
addEventListener(event: 'enter-html-full-screen', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'enter-html-full-screen', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when page leaves fullscreen triggered by HTML API.
|
|
*/
|
|
addEventListener(event: 'leave-html-full-screen', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'leave-html-full-screen', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when the guest window logs a console message.
|
|
*
|
|
* The following example code forwards all log messages to the embedder's console
|
|
* without regard for log level or other properties.
|
|
*/
|
|
addEventListener(event: 'console-message', listener: (event: ConsoleMessageEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'console-message', listener: (event: ConsoleMessageEvent) => void): this;
|
|
/**
|
|
* Fired when a result is available for `webview.findInPage` request.
|
|
*/
|
|
addEventListener(event: 'found-in-page', listener: (event: FoundInPageEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'found-in-page', listener: (event: FoundInPageEvent) => void): this;
|
|
/**
|
|
* Emitted when a user or the page wants to start navigation. It can happen when
|
|
* the `window.location` object is changed or a user clicks a link in the page.
|
|
*
|
|
* This event will not emit when the navigation is started programmatically with
|
|
* APIs like `<webview>.loadURL` and `<webview>.back`.
|
|
*
|
|
* It is also not emitted during in-page navigation, such as clicking anchor links
|
|
* or updating the `window.location.hash`. Use `did-navigate-in-page` event for
|
|
* this purpose.
|
|
*
|
|
* Calling `event.preventDefault()` does **NOT** have any effect.
|
|
*/
|
|
addEventListener(event: 'will-navigate', listener: (event: WillNavigateEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'will-navigate', listener: (event: WillNavigateEvent) => void): this;
|
|
/**
|
|
* Emitted when a user or the page wants to start navigation anywhere in the
|
|
* `<webview>` or any frames embedded within. It can happen when the
|
|
* `window.location` object is changed or a user clicks a link in the page.
|
|
*
|
|
* This event will not emit when the navigation is started programmatically with
|
|
* APIs like `<webview>.loadURL` and `<webview>.back`.
|
|
*
|
|
* It is also not emitted during in-page navigation, such as clicking anchor links
|
|
* or updating the `window.location.hash`. Use `did-navigate-in-page` event for
|
|
* this purpose.
|
|
*
|
|
* Calling `event.preventDefault()` does **NOT** have any effect.
|
|
*/
|
|
addEventListener(event: 'will-frame-navigate', listener: (event: WillFrameNavigateEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'will-frame-navigate', listener: (event: WillFrameNavigateEvent) => void): this;
|
|
/**
|
|
* Emitted when any frame (including main) starts navigating. `isInPlace` will be
|
|
* `true` for in-page navigations.
|
|
*/
|
|
addEventListener(event: 'did-start-navigation', listener: (event: DidStartNavigationEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-start-navigation', listener: (event: DidStartNavigationEvent) => void): this;
|
|
/**
|
|
* Emitted after a server side redirect occurs during navigation. For example a 302
|
|
* redirect.
|
|
*/
|
|
addEventListener(event: 'did-redirect-navigation', listener: (event: DidRedirectNavigationEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-redirect-navigation', listener: (event: DidRedirectNavigationEvent) => void): this;
|
|
/**
|
|
* Emitted when a navigation is done.
|
|
*
|
|
* This event is not emitted for in-page navigations, such as clicking anchor links
|
|
* or updating the `window.location.hash`. Use `did-navigate-in-page` event for
|
|
* this purpose.
|
|
*/
|
|
addEventListener(event: 'did-navigate', listener: (event: DidNavigateEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-navigate', listener: (event: DidNavigateEvent) => void): this;
|
|
/**
|
|
* Emitted when any frame navigation is done.
|
|
*
|
|
* This event is not emitted for in-page navigations, such as clicking anchor links
|
|
* or updating the `window.location.hash`. Use `did-navigate-in-page` event for
|
|
* this purpose.
|
|
*/
|
|
addEventListener(event: 'did-frame-navigate', listener: (event: DidFrameNavigateEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-frame-navigate', listener: (event: DidFrameNavigateEvent) => void): this;
|
|
/**
|
|
* Emitted when an in-page navigation happened.
|
|
*
|
|
* When in-page navigation happens, the page URL changes but does not cause
|
|
* navigation outside of the page. Examples of this occurring are when anchor links
|
|
* are clicked or when the DOM `hashchange` event is triggered.
|
|
*/
|
|
addEventListener(event: 'did-navigate-in-page', listener: (event: DidNavigateInPageEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-navigate-in-page', listener: (event: DidNavigateInPageEvent) => void): this;
|
|
/**
|
|
* Fired when the guest page attempts to close itself.
|
|
*
|
|
* The following example code navigates the `webview` to `about:blank` when the
|
|
* guest attempts to close itself.
|
|
*/
|
|
addEventListener(event: 'close', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'close', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when the guest page has sent an asynchronous message to embedder page.
|
|
*
|
|
* With `sendToHost` method and `ipc-message` event you can communicate between
|
|
* guest page and embedder page:
|
|
*/
|
|
addEventListener(event: 'ipc-message', listener: (event: IpcMessageEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'ipc-message', listener: (event: IpcMessageEvent) => void): this;
|
|
/**
|
|
* Fired when the renderer process crashes or is killed.
|
|
*
|
|
* **Deprecated:** This event is superceded by the `render-process-gone` event
|
|
* which contains more information about why the render process disappeared. It
|
|
* isn't always because it crashed.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
addEventListener(event: 'crashed', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'crashed', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Fired when the renderer process unexpectedly disappears. This is normally
|
|
* because it was crashed or killed.
|
|
*/
|
|
addEventListener(event: 'render-process-gone', listener: (event: RenderProcessGoneEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'render-process-gone', listener: (event: RenderProcessGoneEvent) => void): this;
|
|
/**
|
|
* Fired when a plugin process is crashed.
|
|
*/
|
|
addEventListener(event: 'plugin-crashed', listener: (event: PluginCrashedEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'plugin-crashed', listener: (event: PluginCrashedEvent) => void): this;
|
|
/**
|
|
* Fired when the WebContents is destroyed.
|
|
*/
|
|
addEventListener(event: 'destroyed', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'destroyed', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Emitted when media starts playing.
|
|
*/
|
|
addEventListener(event: 'media-started-playing', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'media-started-playing', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Emitted when media is paused or done playing.
|
|
*/
|
|
addEventListener(event: 'media-paused', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'media-paused', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Emitted when a page's theme color changes. This is usually due to encountering a
|
|
* meta tag:
|
|
*/
|
|
addEventListener(event: 'did-change-theme-color', listener: (event: DidChangeThemeColorEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'did-change-theme-color', listener: (event: DidChangeThemeColorEvent) => void): this;
|
|
/**
|
|
* Emitted when mouse moves over a link or the keyboard moves the focus to a link.
|
|
*/
|
|
addEventListener(event: 'update-target-url', listener: (event: UpdateTargetUrlEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'update-target-url', listener: (event: UpdateTargetUrlEvent) => void): this;
|
|
/**
|
|
* Emitted when a link is clicked in DevTools or 'Open in new tab' is selected for
|
|
* a link in its context menu.
|
|
*/
|
|
addEventListener(event: 'devtools-open-url', listener: (event: DevtoolsOpenUrlEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'devtools-open-url', listener: (event: DevtoolsOpenUrlEvent) => void): this;
|
|
/**
|
|
* Emitted when DevTools is opened.
|
|
*/
|
|
addEventListener(event: 'devtools-opened', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'devtools-opened', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Emitted when DevTools is closed.
|
|
*/
|
|
addEventListener(event: 'devtools-closed', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'devtools-closed', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Emitted when DevTools is focused / opened.
|
|
*/
|
|
addEventListener(event: 'devtools-focused', listener: (event: DOMEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'devtools-focused', listener: (event: DOMEvent) => void): this;
|
|
/**
|
|
* Emitted when there is a new context menu that needs to be handled.
|
|
*/
|
|
addEventListener(event: 'context-menu', listener: (event: ContextMenuEvent) => void, useCapture?: boolean): this;
|
|
removeEventListener(event: 'context-menu', listener: (event: ContextMenuEvent) => void): this;
|
|
addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, useCapture?: boolean): void;
|
|
addEventListener(type: string, listener: EventListenerOrEventListenerObject, useCapture?: boolean): void;
|
|
removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, useCapture?: boolean): void;
|
|
removeEventListener(type: string, listener: EventListenerOrEventListenerObject, useCapture?: boolean): void;
|
|
/**
|
|
* Adjusts the current text selection starting and ending points in the focused
|
|
* frame by the given amounts. A negative amount moves the selection towards the
|
|
* beginning of the document, and a positive amount moves the selection towards the
|
|
* end of the document.
|
|
*
|
|
* See `webContents.adjustSelection` for examples.
|
|
*/
|
|
adjustSelection(options: AdjustSelectionOptions): void;
|
|
/**
|
|
* Whether the guest page can go back.
|
|
*/
|
|
canGoBack(): boolean;
|
|
/**
|
|
* Whether the guest page can go forward.
|
|
*/
|
|
canGoForward(): boolean;
|
|
/**
|
|
* Whether the guest page can go to `offset`.
|
|
*/
|
|
canGoToOffset(offset: number): boolean;
|
|
/**
|
|
* Resolves with a NativeImage
|
|
*
|
|
* Captures a snapshot of the page within `rect`. Omitting `rect` will capture the
|
|
* whole visible page.
|
|
*/
|
|
capturePage(rect?: Rectangle): Promise<Electron.NativeImage>;
|
|
/**
|
|
* Centers the current text selection in page.
|
|
*/
|
|
centerSelection(): void;
|
|
/**
|
|
* Clears the navigation history.
|
|
*/
|
|
clearHistory(): void;
|
|
/**
|
|
* Closes the DevTools window of guest page.
|
|
*/
|
|
closeDevTools(): void;
|
|
/**
|
|
* Executes editing command `copy` in page.
|
|
*/
|
|
copy(): void;
|
|
/**
|
|
* Executes editing command `cut` in page.
|
|
*/
|
|
cut(): void;
|
|
/**
|
|
* Executes editing command `delete` in page.
|
|
*/
|
|
delete(): void;
|
|
/**
|
|
* Initiates a download of the resource at `url` without navigating.
|
|
*/
|
|
downloadURL(url: string, options?: DownloadURLOptions): void;
|
|
/**
|
|
* A promise that resolves with the result of the executed code or is rejected if
|
|
* the result of the code is a rejected promise.
|
|
*
|
|
* Evaluates `code` in page. If `userGesture` is set, it will create the user
|
|
* gesture context in the page. HTML APIs like `requestFullScreen`, which require
|
|
* user action, can take advantage of this option for automation.
|
|
*/
|
|
executeJavaScript(code: string, userGesture?: boolean): Promise<any>;
|
|
/**
|
|
* The request id used for the request.
|
|
*
|
|
* Starts a request to find all matches for the `text` in the web page. The result
|
|
* of the request can be obtained by subscribing to `found-in-page` event.
|
|
*/
|
|
findInPage(text: string, options?: FindInPageOptions): number;
|
|
/**
|
|
* The title of guest page.
|
|
*/
|
|
getTitle(): string;
|
|
/**
|
|
* The URL of guest page.
|
|
*/
|
|
getURL(): string;
|
|
/**
|
|
* The user agent for guest page.
|
|
*/
|
|
getUserAgent(): string;
|
|
/**
|
|
* The WebContents ID of this `webview`.
|
|
*/
|
|
getWebContentsId(): number;
|
|
/**
|
|
* the current zoom factor.
|
|
*/
|
|
getZoomFactor(): number;
|
|
/**
|
|
* the current zoom level.
|
|
*/
|
|
getZoomLevel(): number;
|
|
/**
|
|
* Makes the guest page go back.
|
|
*/
|
|
goBack(): void;
|
|
/**
|
|
* Makes the guest page go forward.
|
|
*/
|
|
goForward(): void;
|
|
/**
|
|
* Navigates to the specified absolute index.
|
|
*/
|
|
goToIndex(index: number): void;
|
|
/**
|
|
* Navigates to the specified offset from the "current entry".
|
|
*/
|
|
goToOffset(offset: number): void;
|
|
/**
|
|
* A promise that resolves with a key for the inserted CSS that can later be used
|
|
* to remove the CSS via `<webview>.removeInsertedCSS(key)`.
|
|
*
|
|
* Injects CSS into the current web page and returns a unique key for the inserted
|
|
* stylesheet.
|
|
*/
|
|
insertCSS(css: string): Promise<string>;
|
|
/**
|
|
* Inserts `text` to the focused element.
|
|
*/
|
|
insertText(text: string): Promise<void>;
|
|
/**
|
|
* Starts inspecting element at position (`x`, `y`) of guest page.
|
|
*/
|
|
inspectElement(x: number, y: number): void;
|
|
/**
|
|
* Opens the DevTools for the service worker context present in the guest page.
|
|
*/
|
|
inspectServiceWorker(): void;
|
|
/**
|
|
* Opens the DevTools for the shared worker context present in the guest page.
|
|
*/
|
|
inspectSharedWorker(): void;
|
|
/**
|
|
* Whether guest page has been muted.
|
|
*/
|
|
isAudioMuted(): boolean;
|
|
/**
|
|
* Whether the renderer process has crashed.
|
|
*/
|
|
isCrashed(): boolean;
|
|
/**
|
|
* Whether audio is currently playing.
|
|
*/
|
|
isCurrentlyAudible(): boolean;
|
|
/**
|
|
* Whether DevTools window of guest page is focused.
|
|
*/
|
|
isDevToolsFocused(): boolean;
|
|
/**
|
|
* Whether guest page has a DevTools window attached.
|
|
*/
|
|
isDevToolsOpened(): boolean;
|
|
/**
|
|
* Whether guest page is still loading resources.
|
|
*/
|
|
isLoading(): boolean;
|
|
/**
|
|
* Whether the main frame (and not just iframes or frames within it) is still
|
|
* loading.
|
|
*/
|
|
isLoadingMainFrame(): boolean;
|
|
/**
|
|
* Whether the guest page is waiting for a first-response for the main resource of
|
|
* the page.
|
|
*/
|
|
isWaitingForResponse(): boolean;
|
|
/**
|
|
* The promise will resolve when the page has finished loading (see
|
|
* `did-finish-load`), and rejects if the page fails to load (see `did-fail-load`).
|
|
*
|
|
* Loads the `url` in the webview, the `url` must contain the protocol prefix, e.g.
|
|
* the `http://` or `file://`.
|
|
*/
|
|
loadURL(url: string, options?: LoadURLOptions): Promise<void>;
|
|
/**
|
|
* Opens a DevTools window for guest page.
|
|
*/
|
|
openDevTools(): void;
|
|
/**
|
|
* Executes editing command `paste` in page.
|
|
*/
|
|
paste(): void;
|
|
/**
|
|
* Executes editing command `pasteAndMatchStyle` in page.
|
|
*/
|
|
pasteAndMatchStyle(): void;
|
|
/**
|
|
* Prints `webview`'s web page. Same as `webContents.print([options])`.
|
|
*/
|
|
print(options?: WebviewTagPrintOptions): Promise<void>;
|
|
/**
|
|
* Resolves with the generated PDF data.
|
|
*
|
|
* Prints `webview`'s web page as PDF, Same as `webContents.printToPDF(options)`.
|
|
*/
|
|
printToPDF(options: PrintToPDFOptions): Promise<Uint8Array>;
|
|
/**
|
|
* Executes editing command `redo` in page.
|
|
*/
|
|
redo(): void;
|
|
/**
|
|
* Reloads the guest page.
|
|
*/
|
|
reload(): void;
|
|
/**
|
|
* Reloads the guest page and ignores cache.
|
|
*/
|
|
reloadIgnoringCache(): void;
|
|
/**
|
|
* Resolves if the removal was successful.
|
|
*
|
|
* Removes the inserted CSS from the current web page. The stylesheet is identified
|
|
* by its key, which is returned from `<webview>.insertCSS(css)`.
|
|
*/
|
|
removeInsertedCSS(key: string): Promise<void>;
|
|
/**
|
|
* Executes editing command `replace` in page.
|
|
*/
|
|
replace(text: string): void;
|
|
/**
|
|
* Executes editing command `replaceMisspelling` in page.
|
|
*/
|
|
replaceMisspelling(text: string): void;
|
|
/**
|
|
* Scrolls to the bottom of the current `<webview>`.
|
|
*/
|
|
scrollToBottom(): void;
|
|
/**
|
|
* Scrolls to the top of the current `<webview>`.
|
|
*/
|
|
scrollToTop(): void;
|
|
/**
|
|
* Executes editing command `selectAll` in page.
|
|
*/
|
|
selectAll(): void;
|
|
/**
|
|
* Send an asynchronous message to renderer process via `channel`, you can also
|
|
* send arbitrary arguments. The renderer process can handle the message by
|
|
* listening to the `channel` event with the `ipcRenderer` module.
|
|
*
|
|
* See webContents.send for examples.
|
|
*/
|
|
send(channel: string, ...args: any[]): Promise<void>;
|
|
/**
|
|
* Sends an input `event` to the page.
|
|
*
|
|
* See webContents.sendInputEvent for detailed description of `event` object.
|
|
*/
|
|
sendInputEvent(event: (MouseInputEvent) | (MouseWheelInputEvent) | (KeyboardInputEvent)): Promise<void>;
|
|
/**
|
|
* Send an asynchronous message to renderer process via `channel`, you can also
|
|
* send arbitrary arguments. The renderer process can handle the message by
|
|
* listening to the `channel` event with the `ipcRenderer` module.
|
|
*
|
|
* See webContents.sendToFrame for examples.
|
|
*/
|
|
sendToFrame(frameId: [number, number], channel: string, ...args: any[]): Promise<void>;
|
|
/**
|
|
* Set guest page muted.
|
|
*/
|
|
setAudioMuted(muted: boolean): void;
|
|
/**
|
|
* Overrides the user agent for the guest page.
|
|
*/
|
|
setUserAgent(userAgent: string): void;
|
|
/**
|
|
* Sets the maximum and minimum pinch-to-zoom level.
|
|
*/
|
|
setVisualZoomLevelLimits(minimumLevel: number, maximumLevel: number): Promise<void>;
|
|
/**
|
|
* Changes the zoom factor to the specified factor. Zoom factor is zoom percent
|
|
* divided by 100, so 300% = 3.0.
|
|
*/
|
|
setZoomFactor(factor: number): void;
|
|
/**
|
|
* Changes the zoom level to the specified level. The original size is 0 and each
|
|
* increment above or below represents zooming 20% larger or smaller to default
|
|
* limits of 300% and 50% of original size, respectively. The formula for this is
|
|
* `scale := 1.2 ^ level`.
|
|
*
|
|
* > **NOTE**: The zoom policy at the Chromium level is same-origin, meaning that
|
|
* the zoom level for a specific domain propagates across all instances of windows
|
|
* with the same domain. Differentiating the window URLs will make zoom work
|
|
* per-window.
|
|
*/
|
|
setZoomLevel(level: number): void;
|
|
/**
|
|
* Shows pop-up dictionary that searches the selected word on the page.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
showDefinitionForSelection(): void;
|
|
/**
|
|
* Stops any pending navigation.
|
|
*/
|
|
stop(): void;
|
|
/**
|
|
* Stops any `findInPage` request for the `webview` with the provided `action`.
|
|
*/
|
|
stopFindInPage(action: 'clearSelection' | 'keepSelection' | 'activateSelection'): void;
|
|
/**
|
|
* Executes editing command `undo` in page.
|
|
*/
|
|
undo(): void;
|
|
/**
|
|
* Executes editing command `unselect` in page.
|
|
*/
|
|
unselect(): void;
|
|
/**
|
|
* A `boolean`. When this attribute is present the guest page will be allowed to
|
|
* open new windows. Popups are disabled by default.
|
|
*/
|
|
allowpopups: boolean;
|
|
/**
|
|
* A `string` which is a list of strings which specifies the blink features to be
|
|
* disabled separated by `,`. The full list of supported feature strings can be
|
|
* found in the RuntimeEnabledFeatures.json5 file.
|
|
*/
|
|
disableblinkfeatures: string;
|
|
/**
|
|
* A `boolean`. When this attribute is present the guest page will have web
|
|
* security disabled. Web security is enabled by default.
|
|
*
|
|
* This value can only be modified before the first navigation.
|
|
*/
|
|
disablewebsecurity: boolean;
|
|
/**
|
|
* A `string` which is a list of strings which specifies the blink features to be
|
|
* enabled separated by `,`. The full list of supported feature strings can be
|
|
* found in the RuntimeEnabledFeatures.json5 file.
|
|
*/
|
|
enableblinkfeatures: string;
|
|
/**
|
|
* A `string` that sets the referrer URL for the guest page.
|
|
*/
|
|
httpreferrer: string;
|
|
/**
|
|
* A `boolean`. When this attribute is present the guest page in `webview` will
|
|
* have node integration and can use node APIs like `require` and `process` to
|
|
* access low level system resources. Node integration is disabled by default in
|
|
* the guest page.
|
|
*/
|
|
nodeintegration: boolean;
|
|
/**
|
|
* A `boolean` for the experimental option for enabling NodeJS support in
|
|
* sub-frames such as iframes inside the `webview`. All your preloads will load for
|
|
* every iframe, you can use `process.isMainFrame` to determine if you are in the
|
|
* main frame or not. This option is disabled by default in the guest page.
|
|
*/
|
|
nodeintegrationinsubframes: boolean;
|
|
/**
|
|
* A `string` that sets the session used by the page. If `partition` starts with
|
|
* `persist:`, the page will use a persistent session available to all pages in the
|
|
* app with the same `partition`. if there is no `persist:` prefix, the page will
|
|
* use an in-memory session. By assigning the same `partition`, multiple pages can
|
|
* share the same session. If the `partition` is unset then default session of the
|
|
* app will be used.
|
|
*
|
|
* This value can only be modified before the first navigation, since the session
|
|
* of an active renderer process cannot change. Subsequent attempts to modify the
|
|
* value will fail with a DOM exception.
|
|
*/
|
|
partition: string;
|
|
/**
|
|
* A `boolean`. When this attribute is present the guest page in `webview` will be
|
|
* able to use browser plugins. Plugins are disabled by default.
|
|
*/
|
|
plugins: boolean;
|
|
/**
|
|
* A `string` that specifies a script that will be loaded before other scripts run
|
|
* in the guest page. The protocol of script's URL must be `file:` (even when using
|
|
* `asar:` archives) because it will be loaded by Node's `require` under the hood,
|
|
* which treats `asar:` archives as virtual directories.
|
|
*
|
|
* When the guest page doesn't have node integration this script will still have
|
|
* access to all Node APIs, but global objects injected by Node will be deleted
|
|
* after this script has finished executing.
|
|
*/
|
|
preload: string;
|
|
/**
|
|
* A `string` representing the visible URL. Writing to this attribute initiates
|
|
* top-level navigation.
|
|
*
|
|
* Assigning `src` its own value will reload the current page.
|
|
*
|
|
* The `src` attribute can also accept data URLs, such as `data:text/plain,Hello,
|
|
* world!`.
|
|
*/
|
|
src: string;
|
|
/**
|
|
* A `string` that sets the user agent for the guest page before the page is
|
|
* navigated to. Once the page is loaded, use the `setUserAgent` method to change
|
|
* the user agent.
|
|
*/
|
|
useragent: string;
|
|
/**
|
|
* A `string` which is a comma separated list of strings which specifies the web
|
|
* preferences to be set on the webview. The full list of supported preference
|
|
* strings can be found in BrowserWindow.
|
|
*
|
|
* The string follows the same format as the features string in `window.open`. A
|
|
* name by itself is given a `true` boolean value. A preference can be set to
|
|
* another value by including an `=`, followed by the value. Special values `yes`
|
|
* and `1` are interpreted as `true`, while `no` and `0` are interpreted as
|
|
* `false`.
|
|
*/
|
|
webpreferences: string;
|
|
}
|
|
|
|
interface AboutPanelOptionsOptions {
|
|
/**
|
|
* The app's name.
|
|
*/
|
|
applicationName?: string;
|
|
/**
|
|
* The app's version.
|
|
*/
|
|
applicationVersion?: string;
|
|
/**
|
|
* Copyright information.
|
|
*/
|
|
copyright?: string;
|
|
/**
|
|
* The app's build version number.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
version?: string;
|
|
/**
|
|
* Credit information.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
credits?: string;
|
|
/**
|
|
* List of app authors.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
authors?: string[];
|
|
/**
|
|
* The app's website.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
website?: string;
|
|
/**
|
|
* Path to the app's icon in a JPEG or PNG file format. On Linux, will be shown as
|
|
* 64x64 pixels while retaining aspect ratio.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
iconPath?: string;
|
|
}
|
|
|
|
interface AddRepresentationOptions {
|
|
/**
|
|
* The scale factor to add the image representation for.
|
|
*/
|
|
scaleFactor?: number;
|
|
/**
|
|
* Defaults to 0. Required if a bitmap buffer is specified as `buffer`.
|
|
*/
|
|
width?: number;
|
|
/**
|
|
* Defaults to 0. Required if a bitmap buffer is specified as `buffer`.
|
|
*/
|
|
height?: number;
|
|
/**
|
|
* The buffer containing the raw image data.
|
|
*/
|
|
buffer?: Buffer;
|
|
/**
|
|
* The data URL containing either a base 64 encoded PNG or JPEG image.
|
|
*/
|
|
dataURL?: string;
|
|
}
|
|
|
|
interface AdjustSelectionOptions {
|
|
/**
|
|
* Amount to shift the start index of the current selection.
|
|
*/
|
|
start?: number;
|
|
/**
|
|
* Amount to shift the end index of the current selection.
|
|
*/
|
|
end?: number;
|
|
}
|
|
|
|
interface AnimationSettings {
|
|
/**
|
|
* Returns true if rich animations should be rendered. Looks at session type (e.g.
|
|
* remote desktop) and accessibility settings to give guidance for heavy
|
|
* animations.
|
|
*/
|
|
shouldRenderRichAnimation: boolean;
|
|
/**
|
|
* Determines on a per-platform basis whether scroll animations (e.g. produced by
|
|
* home/end key) should be enabled.
|
|
*/
|
|
scrollAnimationsEnabledBySystem: boolean;
|
|
/**
|
|
* Determines whether the user desires reduced motion based on platform APIs.
|
|
*/
|
|
prefersReducedMotion: boolean;
|
|
}
|
|
|
|
interface AppDetailsOptions {
|
|
/**
|
|
* Window's App User Model ID. It has to be set, otherwise the other options will
|
|
* have no effect.
|
|
*/
|
|
appId?: string;
|
|
/**
|
|
* Window's Relaunch Icon.
|
|
*/
|
|
appIconPath?: string;
|
|
/**
|
|
* Index of the icon in `appIconPath`. Ignored when `appIconPath` is not set.
|
|
* Default is `0`.
|
|
*/
|
|
appIconIndex?: number;
|
|
/**
|
|
* Window's Relaunch Command.
|
|
*/
|
|
relaunchCommand?: string;
|
|
/**
|
|
* Window's Relaunch Display Name.
|
|
*/
|
|
relaunchDisplayName?: string;
|
|
}
|
|
|
|
interface ApplicationInfoForProtocolReturnValue {
|
|
/**
|
|
* the display icon of the app handling the protocol.
|
|
*/
|
|
icon: NativeImage;
|
|
/**
|
|
* installation path of the app handling the protocol.
|
|
*/
|
|
path: string;
|
|
/**
|
|
* display name of the app handling the protocol.
|
|
*/
|
|
name: string;
|
|
}
|
|
|
|
interface AuthenticationResponseDetails {
|
|
url: string;
|
|
}
|
|
|
|
interface AuthInfo {
|
|
isProxy: boolean;
|
|
scheme: string;
|
|
host: string;
|
|
port: number;
|
|
realm: string;
|
|
}
|
|
|
|
interface AutoResizeOptions {
|
|
/**
|
|
* If `true`, the view's width will grow and shrink together with the window.
|
|
* `false` by default.
|
|
*/
|
|
width?: boolean;
|
|
/**
|
|
* If `true`, the view's height will grow and shrink together with the window.
|
|
* `false` by default.
|
|
*/
|
|
height?: boolean;
|
|
/**
|
|
* If `true`, the view's x position and width will grow and shrink proportionally
|
|
* with the window. `false` by default.
|
|
*/
|
|
horizontal?: boolean;
|
|
/**
|
|
* If `true`, the view's y position and height will grow and shrink proportionally
|
|
* with the window. `false` by default.
|
|
*/
|
|
vertical?: boolean;
|
|
}
|
|
|
|
interface BeforeSendResponse {
|
|
cancel?: boolean;
|
|
/**
|
|
* When provided, request will be made with these headers.
|
|
*/
|
|
requestHeaders?: Record<string, (string) | (string[])>;
|
|
}
|
|
|
|
interface BitmapOptions {
|
|
/**
|
|
* Defaults to 1.0.
|
|
*/
|
|
scaleFactor?: number;
|
|
}
|
|
|
|
interface BlinkMemoryInfo {
|
|
/**
|
|
* Size of all allocated objects in Kilobytes.
|
|
*/
|
|
allocated: number;
|
|
/**
|
|
* Total allocated space in Kilobytes.
|
|
*/
|
|
total: number;
|
|
}
|
|
|
|
interface BluetoothPairingHandlerHandlerDetails {
|
|
deviceId: string;
|
|
/**
|
|
* The type of pairing prompt being requested. One of the following values:
|
|
*/
|
|
pairingKind: ('confirm' | 'confirmPin' | 'providePin');
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The pin value to verify if `pairingKind` is `confirmPin`.
|
|
*/
|
|
pin?: string;
|
|
}
|
|
|
|
interface BrowserViewConstructorOptions {
|
|
/**
|
|
* Settings of web page's features.
|
|
*/
|
|
webPreferences?: WebPreferences;
|
|
}
|
|
|
|
interface CallbackResponse {
|
|
cancel?: boolean;
|
|
/**
|
|
* The original request is prevented from being sent or completed and is instead
|
|
* redirected to the given URL.
|
|
*/
|
|
redirectURL?: string;
|
|
}
|
|
|
|
interface CertificateTrustDialogOptions {
|
|
/**
|
|
* The certificate to trust/import.
|
|
*/
|
|
certificate: Certificate;
|
|
/**
|
|
* The message to display to the user.
|
|
*/
|
|
message: string;
|
|
}
|
|
|
|
interface ClearCodeCachesOptions {
|
|
/**
|
|
* An array of url corresponding to the resource whose generated code cache needs
|
|
* to be removed. If the list is empty then all entries in the cache directory will
|
|
* be removed.
|
|
*/
|
|
urls?: string[];
|
|
}
|
|
|
|
interface ClearStorageDataOptions {
|
|
/**
|
|
* Should follow `window.location.origin`’s representation `scheme://host:port`.
|
|
*/
|
|
origin?: string;
|
|
/**
|
|
* The types of storages to clear, can be `cookies`, `filesystem`, `indexdb`,
|
|
* `localstorage`, `shadercache`, `websql`, `serviceworkers`, `cachestorage`. If
|
|
* not specified, clear all storage types.
|
|
*/
|
|
storages?: Array<'cookies' | 'filesystem' | 'indexdb' | 'localstorage' | 'shadercache' | 'websql' | 'serviceworkers' | 'cachestorage'>;
|
|
/**
|
|
* The types of quotas to clear, can be `temporary`, `syncable`. If not specified,
|
|
* clear all quotas.
|
|
*/
|
|
quotas?: Array<'temporary' | 'syncable'>;
|
|
}
|
|
|
|
interface ClientRequestConstructorOptions {
|
|
/**
|
|
* The HTTP request method. Defaults to the GET method.
|
|
*/
|
|
method?: string;
|
|
/**
|
|
* The request URL. Must be provided in the absolute form with the protocol scheme
|
|
* specified as http or https.
|
|
*/
|
|
url?: string;
|
|
/**
|
|
* The `Session` instance with which the request is associated.
|
|
*/
|
|
session?: Session;
|
|
/**
|
|
* The name of the `partition` with which the request is associated. Defaults to
|
|
* the empty string. The `session` option supersedes `partition`. Thus if a
|
|
* `session` is explicitly specified, `partition` is ignored.
|
|
*/
|
|
partition?: string;
|
|
/**
|
|
* Can be `include`, `omit` or `same-origin`. Whether to send credentials with this
|
|
* request. If set to `include`, credentials from the session associated with the
|
|
* request will be used. If set to `omit`, credentials will not be sent with the
|
|
* request (and the `'login'` event will not be triggered in the event of a 401).
|
|
* If set to `same-origin`, `origin` must also be specified. This matches the
|
|
* behavior of the fetch option of the same name. If this option is not specified,
|
|
* authentication data from the session will be sent, and cookies will not be sent
|
|
* (unless `useSessionCookies` is set).
|
|
*/
|
|
credentials?: ('include' | 'omit' | 'same-origin');
|
|
/**
|
|
* Whether to send cookies with this request from the provided session. If
|
|
* `credentials` is specified, this option has no effect. Default is `false`.
|
|
*/
|
|
useSessionCookies?: boolean;
|
|
/**
|
|
* Can be `http:` or `https:`. The protocol scheme in the form 'scheme:'. Defaults
|
|
* to 'http:'.
|
|
*/
|
|
protocol?: ('http:' | 'https:');
|
|
/**
|
|
* The server host provided as a concatenation of the hostname and the port number
|
|
* 'hostname:port'.
|
|
*/
|
|
host?: string;
|
|
/**
|
|
* The server host name.
|
|
*/
|
|
hostname?: string;
|
|
/**
|
|
* The server's listening port number.
|
|
*/
|
|
port?: number;
|
|
/**
|
|
* The path part of the request URL.
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* Can be `follow`, `error` or `manual`. The redirect mode for this request. When
|
|
* mode is `error`, any redirection will be aborted. When mode is `manual` the
|
|
* redirection will be cancelled unless `request.followRedirect` is invoked
|
|
* synchronously during the `redirect` event. Defaults to `follow`.
|
|
*/
|
|
redirect?: ('follow' | 'error' | 'manual');
|
|
/**
|
|
* The origin URL of the request.
|
|
*/
|
|
origin?: string;
|
|
/**
|
|
* can be `""`, `no-referrer`, `no-referrer-when-downgrade`, `origin`,
|
|
* `origin-when-cross-origin`, `unsafe-url`, `same-origin`, `strict-origin`, or
|
|
* `strict-origin-when-cross-origin`. Defaults to
|
|
* `strict-origin-when-cross-origin`.
|
|
*/
|
|
referrerPolicy?: string;
|
|
/**
|
|
* can be `default`, `no-store`, `reload`, `no-cache`, `force-cache` or
|
|
* `only-if-cached`.
|
|
*/
|
|
cache?: ('default' | 'no-store' | 'reload' | 'no-cache' | 'force-cache' | 'only-if-cached');
|
|
}
|
|
|
|
interface CloseOpts {
|
|
/**
|
|
* if true, fire the `beforeunload` event before closing the page. If the page
|
|
* prevents the unload, the WebContents will not be closed. The
|
|
* `will-prevent-unload` will be fired if the page requests prevention of unload.
|
|
*/
|
|
waitForBeforeUnload: boolean;
|
|
}
|
|
|
|
interface Config {
|
|
/**
|
|
* The proxy mode. Should be one of `direct`, `auto_detect`, `pac_script`,
|
|
* `fixed_servers` or `system`. If it's unspecified, it will be automatically
|
|
* determined based on other specified options.
|
|
*/
|
|
mode?: ('direct' | 'auto_detect' | 'pac_script' | 'fixed_servers' | 'system');
|
|
/**
|
|
* The URL associated with the PAC file.
|
|
*/
|
|
pacScript?: string;
|
|
/**
|
|
* Rules indicating which proxies to use.
|
|
*/
|
|
proxyRules?: string;
|
|
/**
|
|
* Rules indicating which URLs should bypass the proxy settings.
|
|
*/
|
|
proxyBypassRules?: string;
|
|
}
|
|
|
|
interface ConfigureHostResolverOptions {
|
|
/**
|
|
* Whether the built-in host resolver is used in preference to getaddrinfo. When
|
|
* enabled, the built-in resolver will attempt to use the system's DNS settings to
|
|
* do DNS lookups itself. Enabled by default on macOS, disabled by default on
|
|
* Windows and Linux.
|
|
*/
|
|
enableBuiltInResolver?: boolean;
|
|
/**
|
|
* Can be 'off', 'automatic' or 'secure'. Configures the DNS-over-HTTP mode. When
|
|
* 'off', no DoH lookups will be performed. When 'automatic', DoH lookups will be
|
|
* performed first if DoH is available, and insecure DNS lookups will be performed
|
|
* as a fallback. When 'secure', only DoH lookups will be performed. Defaults to
|
|
* 'automatic'.
|
|
*/
|
|
secureDnsMode?: ('off' | 'automatic' | 'secure');
|
|
/**
|
|
* A list of DNS-over-HTTP server templates. See RFC8484 § 3 for details on the
|
|
* template format. Most servers support the POST method; the template for such
|
|
* servers is simply a URI. Note that for some DNS providers, the resolver will
|
|
* automatically upgrade to DoH unless DoH is explicitly disabled, even if there
|
|
* are no DoH servers provided in this list.
|
|
*/
|
|
secureDnsServers?: string[];
|
|
/**
|
|
* Controls whether additional DNS query types, e.g. HTTPS (DNS type 65) will be
|
|
* allowed besides the traditional A and AAAA queries when a request is being made
|
|
* via insecure DNS. Has no effect on Secure DNS which always allows additional
|
|
* types. Defaults to true.
|
|
*/
|
|
enableAdditionalDnsQueryTypes?: boolean;
|
|
}
|
|
|
|
interface ConsoleMessageEvent extends DOMEvent {
|
|
/**
|
|
* The log level, from 0 to 3. In order it matches `verbose`, `info`, `warning` and
|
|
* `error`.
|
|
*/
|
|
level: number;
|
|
/**
|
|
* The actual console message
|
|
*/
|
|
message: string;
|
|
/**
|
|
* The line number of the source that triggered this console message
|
|
*/
|
|
line: number;
|
|
sourceId: string;
|
|
}
|
|
|
|
interface ContextMenuEvent extends DOMEvent {
|
|
params: Params;
|
|
}
|
|
|
|
interface ContextMenuParams {
|
|
/**
|
|
* x coordinate.
|
|
*/
|
|
x: number;
|
|
/**
|
|
* y coordinate.
|
|
*/
|
|
y: number;
|
|
/**
|
|
* Frame from which the context menu was invoked.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* URL of the link that encloses the node the context menu was invoked on.
|
|
*/
|
|
linkURL: string;
|
|
/**
|
|
* Text associated with the link. May be an empty string if the contents of the
|
|
* link are an image.
|
|
*/
|
|
linkText: string;
|
|
/**
|
|
* URL of the top level page that the context menu was invoked on.
|
|
*/
|
|
pageURL: string;
|
|
/**
|
|
* URL of the subframe that the context menu was invoked on.
|
|
*/
|
|
frameURL: string;
|
|
/**
|
|
* Source URL for the element that the context menu was invoked on. Elements with
|
|
* source URLs are images, audio and video.
|
|
*/
|
|
srcURL: string;
|
|
/**
|
|
* Type of the node the context menu was invoked on. Can be `none`, `image`,
|
|
* `audio`, `video`, `canvas`, `file` or `plugin`.
|
|
*/
|
|
mediaType: ('none' | 'image' | 'audio' | 'video' | 'canvas' | 'file' | 'plugin');
|
|
/**
|
|
* Whether the context menu was invoked on an image which has non-empty contents.
|
|
*/
|
|
hasImageContents: boolean;
|
|
/**
|
|
* Whether the context is editable.
|
|
*/
|
|
isEditable: boolean;
|
|
/**
|
|
* Text of the selection that the context menu was invoked on.
|
|
*/
|
|
selectionText: string;
|
|
/**
|
|
* Title text of the selection that the context menu was invoked on.
|
|
*/
|
|
titleText: string;
|
|
/**
|
|
* Alt text of the selection that the context menu was invoked on.
|
|
*/
|
|
altText: string;
|
|
/**
|
|
* Suggested filename to be used when saving file through 'Save Link As' option of
|
|
* context menu.
|
|
*/
|
|
suggestedFilename: string;
|
|
/**
|
|
* Rect representing the coordinates in the document space of the selection.
|
|
*/
|
|
selectionRect: Rectangle;
|
|
/**
|
|
* Start position of the selection text.
|
|
*/
|
|
selectionStartOffset: number;
|
|
/**
|
|
* The referrer policy of the frame on which the menu is invoked.
|
|
*/
|
|
referrerPolicy: Referrer;
|
|
/**
|
|
* The misspelled word under the cursor, if any.
|
|
*/
|
|
misspelledWord: string;
|
|
/**
|
|
* An array of suggested words to show the user to replace the `misspelledWord`.
|
|
* Only available if there is a misspelled word and spellchecker is enabled.
|
|
*/
|
|
dictionarySuggestions: string[];
|
|
/**
|
|
* The character encoding of the frame on which the menu was invoked.
|
|
*/
|
|
frameCharset: string;
|
|
/**
|
|
* If the context menu was invoked on an input field, the type of that field.
|
|
* Possible values include `none`, `plainText`, `password`, `other`.
|
|
*/
|
|
inputFieldType: ('none' | 'plainText' | 'password' | 'other');
|
|
/**
|
|
* If the context is editable, whether or not spellchecking is enabled.
|
|
*/
|
|
spellcheckEnabled: boolean;
|
|
/**
|
|
* Input source that invoked the context menu. Can be `none`, `mouse`, `keyboard`,
|
|
* `touch`, `touchMenu`, `longPress`, `longTap`, `touchHandle`, `stylus`,
|
|
* `adjustSelection`, or `adjustSelectionReset`.
|
|
*/
|
|
menuSourceType: ('none' | 'mouse' | 'keyboard' | 'touch' | 'touchMenu' | 'longPress' | 'longTap' | 'touchHandle' | 'stylus' | 'adjustSelection' | 'adjustSelectionReset');
|
|
/**
|
|
* The flags for the media element the context menu was invoked on.
|
|
*/
|
|
mediaFlags: MediaFlags;
|
|
/**
|
|
* These flags indicate whether the renderer believes it is able to perform the
|
|
* corresponding action.
|
|
*/
|
|
editFlags: EditFlags;
|
|
}
|
|
|
|
interface ContinueActivityDetails {
|
|
/**
|
|
* A string identifying the URL of the webpage accessed by the activity on another
|
|
* device, if available.
|
|
*/
|
|
webpageURL?: string;
|
|
}
|
|
|
|
interface CookiesGetFilter {
|
|
/**
|
|
* Retrieves cookies which are associated with `url`. Empty implies retrieving
|
|
* cookies of all URLs.
|
|
*/
|
|
url?: string;
|
|
/**
|
|
* Filters cookies by name.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* Retrieves cookies whose domains match or are subdomains of `domains`.
|
|
*/
|
|
domain?: string;
|
|
/**
|
|
* Retrieves cookies whose path matches `path`.
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* Filters cookies by their Secure property.
|
|
*/
|
|
secure?: boolean;
|
|
/**
|
|
* Filters out session or persistent cookies.
|
|
*/
|
|
session?: boolean;
|
|
/**
|
|
* Filters cookies by httpOnly.
|
|
*/
|
|
httpOnly?: boolean;
|
|
}
|
|
|
|
interface CookiesSetDetails {
|
|
/**
|
|
* The URL to associate the cookie with. The promise will be rejected if the URL is
|
|
* invalid.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* The name of the cookie. Empty by default if omitted.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* The value of the cookie. Empty by default if omitted.
|
|
*/
|
|
value?: string;
|
|
/**
|
|
* The domain of the cookie; this will be normalized with a preceding dot so that
|
|
* it's also valid for subdomains. Empty by default if omitted.
|
|
*/
|
|
domain?: string;
|
|
/**
|
|
* The path of the cookie. Empty by default if omitted.
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* Whether the cookie should be marked as Secure. Defaults to false unless Same
|
|
* Site=None attribute is used.
|
|
*/
|
|
secure?: boolean;
|
|
/**
|
|
* Whether the cookie should be marked as HTTP only. Defaults to false.
|
|
*/
|
|
httpOnly?: boolean;
|
|
/**
|
|
* The expiration date of the cookie as the number of seconds since the UNIX epoch.
|
|
* If omitted then the cookie becomes a session cookie and will not be retained
|
|
* between sessions.
|
|
*/
|
|
expirationDate?: number;
|
|
/**
|
|
* The Same Site policy to apply to this cookie. Can be `unspecified`,
|
|
* `no_restriction`, `lax` or `strict`. Default is `lax`.
|
|
*/
|
|
sameSite?: ('unspecified' | 'no_restriction' | 'lax' | 'strict');
|
|
}
|
|
|
|
interface CrashReporterStartOptions {
|
|
/**
|
|
* URL that crash reports will be sent to as POST. Required unless `uploadToServer`
|
|
* is `false`.
|
|
*/
|
|
submitURL?: string;
|
|
/**
|
|
* Defaults to `app.name`.
|
|
*/
|
|
productName?: string;
|
|
/**
|
|
* Deprecated alias for `{ globalExtra: { _companyName: ... } }`.
|
|
*
|
|
* @deprecated
|
|
*/
|
|
companyName?: string;
|
|
/**
|
|
* Whether crash reports should be sent to the server. If false, crash reports will
|
|
* be collected and stored in the crashes directory, but not uploaded. Default is
|
|
* `true`.
|
|
*/
|
|
uploadToServer?: boolean;
|
|
/**
|
|
* If true, crashes generated in the main process will not be forwarded to the
|
|
* system crash handler. Default is `false`.
|
|
*/
|
|
ignoreSystemCrashHandler?: boolean;
|
|
/**
|
|
* If true, limit the number of crashes uploaded to 1/hour. Default is `false`.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
rateLimit?: boolean;
|
|
/**
|
|
* If true, crash reports will be compressed and uploaded with `Content-Encoding:
|
|
* gzip`. Default is `true`.
|
|
*/
|
|
compress?: boolean;
|
|
/**
|
|
* Extra string key/value annotations that will be sent along with crash reports
|
|
* that are generated in the main process. Only string values are supported.
|
|
* Crashes generated in child processes will not contain these extra parameters to
|
|
* crash reports generated from child processes, call `addExtraParameter` from the
|
|
* child process.
|
|
*/
|
|
extra?: Record<string, string>;
|
|
/**
|
|
* Extra string key/value annotations that will be sent along with any crash
|
|
* reports generated in any process. These annotations cannot be changed once the
|
|
* crash reporter has been started. If a key is present in both the global extra
|
|
* parameters and the process-specific extra parameters, then the global one will
|
|
* take precedence. By default, `productName` and the app version are included, as
|
|
* well as the Electron version.
|
|
*/
|
|
globalExtra?: Record<string, string>;
|
|
}
|
|
|
|
interface CreateFromBitmapOptions {
|
|
width: number;
|
|
height: number;
|
|
/**
|
|
* Defaults to 1.0.
|
|
*/
|
|
scaleFactor?: number;
|
|
}
|
|
|
|
interface CreateFromBufferOptions {
|
|
/**
|
|
* Required for bitmap buffers.
|
|
*/
|
|
width?: number;
|
|
/**
|
|
* Required for bitmap buffers.
|
|
*/
|
|
height?: number;
|
|
/**
|
|
* Defaults to 1.0.
|
|
*/
|
|
scaleFactor?: number;
|
|
}
|
|
|
|
interface CreateInterruptedDownloadOptions {
|
|
/**
|
|
* Absolute path of the download.
|
|
*/
|
|
path: string;
|
|
/**
|
|
* Complete URL chain for the download.
|
|
*/
|
|
urlChain: string[];
|
|
mimeType?: string;
|
|
/**
|
|
* Start range for the download.
|
|
*/
|
|
offset: number;
|
|
/**
|
|
* Total length of the download.
|
|
*/
|
|
length: number;
|
|
/**
|
|
* Last-Modified header value.
|
|
*/
|
|
lastModified?: string;
|
|
/**
|
|
* ETag header value.
|
|
*/
|
|
eTag?: string;
|
|
/**
|
|
* Time when download was started in number of seconds since UNIX epoch.
|
|
*/
|
|
startTime?: number;
|
|
}
|
|
|
|
interface Data {
|
|
text?: string;
|
|
html?: string;
|
|
image?: NativeImage;
|
|
rtf?: string;
|
|
/**
|
|
* The title of the URL at `text`.
|
|
*/
|
|
bookmark?: string;
|
|
}
|
|
|
|
interface DefaultFontFamily {
|
|
/**
|
|
* Defaults to `Times New Roman`.
|
|
*/
|
|
standard?: string;
|
|
/**
|
|
* Defaults to `Times New Roman`.
|
|
*/
|
|
serif?: string;
|
|
/**
|
|
* Defaults to `Arial`.
|
|
*/
|
|
sansSerif?: string;
|
|
/**
|
|
* Defaults to `Courier New`.
|
|
*/
|
|
monospace?: string;
|
|
/**
|
|
* Defaults to `Script`.
|
|
*/
|
|
cursive?: string;
|
|
/**
|
|
* Defaults to `Impact`.
|
|
*/
|
|
fantasy?: string;
|
|
/**
|
|
* Defaults to `Latin Modern Math`.
|
|
*/
|
|
math?: string;
|
|
}
|
|
|
|
interface Details {
|
|
/**
|
|
* Process type. One of the following values:
|
|
*/
|
|
type: ('Utility' | 'Zygote' | 'Sandbox helper' | 'GPU' | 'Pepper Plugin' | 'Pepper Plugin Broker' | 'Unknown');
|
|
/**
|
|
* The reason the child process is gone. Possible values:
|
|
*/
|
|
reason: ('clean-exit' | 'abnormal-exit' | 'killed' | 'crashed' | 'oom' | 'launch-failed' | 'integrity-failure');
|
|
/**
|
|
* The exit code for the process (e.g. status from waitpid if on posix, from
|
|
* GetExitCodeProcess on Windows).
|
|
*/
|
|
exitCode: number;
|
|
/**
|
|
* The non-localized name of the process.
|
|
*/
|
|
serviceName?: string;
|
|
/**
|
|
* The name of the process. Examples for utility: `Audio Service`, `Content
|
|
* Decryption Module Service`, `Network Service`, `Video Capture`, etc.
|
|
*/
|
|
name?: string;
|
|
}
|
|
|
|
interface DevicePermissionHandlerHandlerDetails {
|
|
/**
|
|
* The type of device that permission is being requested on, can be `hid`,
|
|
* `serial`, or `usb`.
|
|
*/
|
|
deviceType: ('hid' | 'serial' | 'usb');
|
|
/**
|
|
* The origin URL of the device permission check.
|
|
*/
|
|
origin: string;
|
|
/**
|
|
* the device that permission is being requested for.
|
|
*/
|
|
device: (HIDDevice) | (SerialPort) | (USBDevice);
|
|
}
|
|
|
|
interface DevtoolsOpenUrlEvent extends DOMEvent {
|
|
/**
|
|
* URL of the link that was clicked or selected.
|
|
*/
|
|
url: string;
|
|
}
|
|
|
|
interface DidChangeThemeColorEvent extends DOMEvent {
|
|
themeColor: string;
|
|
}
|
|
|
|
interface DidCreateWindowDetails {
|
|
/**
|
|
* URL for the created window.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* Name given to the created window in the `window.open()` call.
|
|
*/
|
|
frameName: string;
|
|
/**
|
|
* The options used to create the BrowserWindow. They are merged in increasing
|
|
* precedence: parsed options from the `features` string from `window.open()`,
|
|
* security-related webPreferences inherited from the parent, and options given by
|
|
* `webContents.setWindowOpenHandler`. Unrecognized options are not filtered out.
|
|
*/
|
|
options: BrowserWindowConstructorOptions;
|
|
/**
|
|
* The referrer that will be passed to the new window. May or may not result in the
|
|
* `Referer` header being sent, depending on the referrer policy.
|
|
*/
|
|
referrer: Referrer;
|
|
/**
|
|
* The post data that will be sent to the new window, along with the appropriate
|
|
* headers that will be set. If no post data is to be sent, the value will be
|
|
* `null`. Only defined when the window is being created by a form that set
|
|
* `target=_blank`.
|
|
*/
|
|
postBody?: PostBody;
|
|
/**
|
|
* Can be `default`, `foreground-tab`, `background-tab`, `new-window` or `other`.
|
|
*/
|
|
disposition: ('default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'other');
|
|
}
|
|
|
|
interface DidFailLoadEvent extends DOMEvent {
|
|
errorCode: number;
|
|
errorDescription: string;
|
|
validatedURL: string;
|
|
isMainFrame: boolean;
|
|
}
|
|
|
|
interface DidFrameFinishLoadEvent extends DOMEvent {
|
|
isMainFrame: boolean;
|
|
}
|
|
|
|
interface DidFrameNavigateEvent extends DOMEvent {
|
|
url: string;
|
|
/**
|
|
* -1 for non HTTP navigations
|
|
*/
|
|
httpResponseCode: number;
|
|
/**
|
|
* empty for non HTTP navigations,
|
|
*/
|
|
httpStatusText: string;
|
|
isMainFrame: boolean;
|
|
frameProcessId: number;
|
|
frameRoutingId: number;
|
|
}
|
|
|
|
interface DidNavigateEvent extends DOMEvent {
|
|
url: string;
|
|
}
|
|
|
|
interface DidNavigateInPageEvent extends DOMEvent {
|
|
isMainFrame: boolean;
|
|
url: string;
|
|
}
|
|
|
|
interface DidRedirectNavigationEvent extends DOMEvent {
|
|
url: string;
|
|
isInPlace: boolean;
|
|
isMainFrame: boolean;
|
|
frameProcessId: number;
|
|
frameRoutingId: number;
|
|
}
|
|
|
|
interface DidStartNavigationEvent extends DOMEvent {
|
|
url: string;
|
|
isInPlace: boolean;
|
|
isMainFrame: boolean;
|
|
frameProcessId: number;
|
|
frameRoutingId: number;
|
|
}
|
|
|
|
interface DisplayBalloonOptions {
|
|
/**
|
|
* Icon to use when `iconType` is `custom`.
|
|
*/
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* Can be `none`, `info`, `warning`, `error` or `custom`. Default is `custom`.
|
|
*/
|
|
iconType?: ('none' | 'info' | 'warning' | 'error' | 'custom');
|
|
title: string;
|
|
content: string;
|
|
/**
|
|
* The large version of the icon should be used. Default is `true`. Maps to
|
|
* `NIIF_LARGE_ICON`.
|
|
*/
|
|
largeIcon?: boolean;
|
|
/**
|
|
* Do not play the associated sound. Default is `false`. Maps to `NIIF_NOSOUND`.
|
|
*/
|
|
noSound?: boolean;
|
|
/**
|
|
* Do not display the balloon notification if the current user is in "quiet time".
|
|
* Default is `false`. Maps to `NIIF_RESPECT_QUIET_TIME`.
|
|
*/
|
|
respectQuietTime?: boolean;
|
|
}
|
|
|
|
interface DisplayMediaRequestHandlerHandlerRequest {
|
|
/**
|
|
* Frame that is requesting access to media.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* Origin of the page making the request.
|
|
*/
|
|
securityOrigin: string;
|
|
/**
|
|
* true if the web content requested a video stream.
|
|
*/
|
|
videoRequested: boolean;
|
|
/**
|
|
* true if the web content requested an audio stream.
|
|
*/
|
|
audioRequested: boolean;
|
|
/**
|
|
* Whether a user gesture was active when this request was triggered.
|
|
*/
|
|
userGesture: boolean;
|
|
}
|
|
|
|
interface DownloadURLOptions {
|
|
/**
|
|
* HTTP request headers.
|
|
*/
|
|
headers?: Record<string, string>;
|
|
}
|
|
|
|
interface EnableNetworkEmulationOptions {
|
|
/**
|
|
* Whether to emulate network outage. Defaults to false.
|
|
*/
|
|
offline?: boolean;
|
|
/**
|
|
* RTT in ms. Defaults to 0 which will disable latency throttling.
|
|
*/
|
|
latency?: number;
|
|
/**
|
|
* Download rate in Bps. Defaults to 0 which will disable download throttling.
|
|
*/
|
|
downloadThroughput?: number;
|
|
/**
|
|
* Upload rate in Bps. Defaults to 0 which will disable upload throttling.
|
|
*/
|
|
uploadThroughput?: number;
|
|
}
|
|
|
|
interface FeedURLOptions {
|
|
url: string;
|
|
/**
|
|
* HTTP request headers.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
headers?: Record<string, string>;
|
|
/**
|
|
* Can be `json` or `default`, see the Squirrel.Mac README for more information.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
serverType?: ('json' | 'default');
|
|
}
|
|
|
|
interface FileIconOptions {
|
|
size: ('small' | 'normal' | 'large');
|
|
}
|
|
|
|
interface FindInPageOptions {
|
|
/**
|
|
* Whether to search forward or backward, defaults to `true`.
|
|
*/
|
|
forward?: boolean;
|
|
/**
|
|
* Whether to begin a new text finding session with this request. Should be `true`
|
|
* for initial requests, and `false` for follow-up requests. Defaults to `false`.
|
|
*/
|
|
findNext?: boolean;
|
|
/**
|
|
* Whether search should be case-sensitive, defaults to `false`.
|
|
*/
|
|
matchCase?: boolean;
|
|
}
|
|
|
|
interface FocusOptions {
|
|
/**
|
|
* Make the receiver the active app even if another app is currently active.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
steal: boolean;
|
|
}
|
|
|
|
interface ForkOptions {
|
|
/**
|
|
* Environment key-value pairs. Default is `process.env`.
|
|
*/
|
|
env?: Env;
|
|
/**
|
|
* List of string arguments passed to the executable.
|
|
*/
|
|
execArgv?: string[];
|
|
/**
|
|
* Current working directory of the child process.
|
|
*/
|
|
cwd?: string;
|
|
/**
|
|
* Allows configuring the mode for `stdout` and `stderr` of the child process.
|
|
* Default is `inherit`. String value can be one of `pipe`, `ignore`, `inherit`,
|
|
* for more details on these values you can refer to stdio documentation from
|
|
* Node.js. Currently this option only supports configuring `stdout` and `stderr`
|
|
* to either `pipe`, `inherit` or `ignore`. Configuring `stdin` is not supported;
|
|
* `stdin` will always be ignored. For example, the supported values will be
|
|
* processed as following:
|
|
*/
|
|
stdio?: (Array<'pipe' | 'ignore' | 'inherit'>) | (string);
|
|
/**
|
|
* Name of the process that will appear in `name` property of `child-process-gone`
|
|
* event of `app`. Default is `node.mojom.NodeService`.
|
|
*/
|
|
serviceName?: string;
|
|
/**
|
|
* With this flag, the utility process will be launched via the `Electron Helper
|
|
* (Plugin).app` helper executable on macOS, which can be codesigned with
|
|
* `com.apple.security.cs.disable-library-validation` and
|
|
* `com.apple.security.cs.allow-unsigned-executable-memory` entitlements. This will
|
|
* allow the utility process to load unsigned libraries. Unless you specifically
|
|
* need this capability, it is best to leave this disabled. Default is `false`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
allowLoadingUnsignedLibraries?: boolean;
|
|
}
|
|
|
|
interface FoundInPageEvent extends DOMEvent {
|
|
result: FoundInPageResult;
|
|
}
|
|
|
|
interface FrameCreatedDetails {
|
|
frame: WebFrameMain;
|
|
}
|
|
|
|
interface FromPartitionOptions {
|
|
/**
|
|
* Whether to enable cache.
|
|
*/
|
|
cache: boolean;
|
|
}
|
|
|
|
interface FromPathOptions {
|
|
/**
|
|
* Whether to enable cache.
|
|
*/
|
|
cache: boolean;
|
|
}
|
|
|
|
interface HandlerDetails {
|
|
/**
|
|
* The _resolved_ version of the URL passed to `window.open()`. e.g. opening a
|
|
* window with `window.open('foo')` will yield something like
|
|
* `https://the-origin/the/current/path/foo`.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* Name of the window provided in `window.open()`
|
|
*/
|
|
frameName: string;
|
|
/**
|
|
* Comma separated list of window features provided to `window.open()`.
|
|
*/
|
|
features: string;
|
|
/**
|
|
* Can be `default`, `foreground-tab`, `background-tab`, `new-window` or `other`.
|
|
*/
|
|
disposition: ('default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'other');
|
|
/**
|
|
* The referrer that will be passed to the new window. May or may not result in the
|
|
* `Referer` header being sent, depending on the referrer policy.
|
|
*/
|
|
referrer: Referrer;
|
|
/**
|
|
* The post data that will be sent to the new window, along with the appropriate
|
|
* headers that will be set. If no post data is to be sent, the value will be
|
|
* `null`. Only defined when the window is being created by a form that set
|
|
* `target=_blank`.
|
|
*/
|
|
postBody?: PostBody;
|
|
}
|
|
|
|
interface HeadersReceivedResponse {
|
|
cancel?: boolean;
|
|
/**
|
|
* When provided, the server is assumed to have responded with these headers.
|
|
*/
|
|
responseHeaders?: Record<string, (string) | (string[])>;
|
|
/**
|
|
* Should be provided when overriding `responseHeaders` to change header status
|
|
* otherwise original response header's status will be used.
|
|
*/
|
|
statusLine?: string;
|
|
}
|
|
|
|
interface HeapStatistics {
|
|
totalHeapSize: number;
|
|
totalHeapSizeExecutable: number;
|
|
totalPhysicalSize: number;
|
|
totalAvailableSize: number;
|
|
usedHeapSize: number;
|
|
heapSizeLimit: number;
|
|
mallocedMemory: number;
|
|
peakMallocedMemory: number;
|
|
doesZapGarbage: boolean;
|
|
}
|
|
|
|
interface HidDeviceAddedDetails {
|
|
device: HIDDevice[];
|
|
frame: WebFrameMain;
|
|
}
|
|
|
|
interface HidDeviceRemovedDetails {
|
|
device: HIDDevice[];
|
|
frame: WebFrameMain;
|
|
}
|
|
|
|
interface HidDeviceRevokedDetails {
|
|
device: HIDDevice[];
|
|
/**
|
|
* The origin that the device has been revoked from.
|
|
*/
|
|
origin?: string;
|
|
}
|
|
|
|
interface IgnoreMouseEventsOptions {
|
|
/**
|
|
* If true, forwards mouse move messages to Chromium, enabling mouse related events
|
|
* such as `mouseleave`. Only used when `ignore` is true. If `ignore` is false,
|
|
* forwarding is always disabled regardless of this value.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
forward?: boolean;
|
|
}
|
|
|
|
interface ImportCertificateOptions {
|
|
/**
|
|
* Path for the pkcs12 file.
|
|
*/
|
|
certificate: string;
|
|
/**
|
|
* Passphrase for the certificate.
|
|
*/
|
|
password: string;
|
|
}
|
|
|
|
interface Info {
|
|
/**
|
|
* Security origin for the isolated world.
|
|
*/
|
|
securityOrigin?: string;
|
|
/**
|
|
* Content Security Policy for the isolated world.
|
|
*/
|
|
csp?: string;
|
|
/**
|
|
* Name for isolated world. Useful in devtools.
|
|
*/
|
|
name?: string;
|
|
}
|
|
|
|
interface Input {
|
|
/**
|
|
* Either `keyUp` or `keyDown`.
|
|
*/
|
|
type: string;
|
|
/**
|
|
* Equivalent to KeyboardEvent.key.
|
|
*/
|
|
key: string;
|
|
/**
|
|
* Equivalent to KeyboardEvent.code.
|
|
*/
|
|
code: string;
|
|
/**
|
|
* Equivalent to KeyboardEvent.repeat.
|
|
*/
|
|
isAutoRepeat: boolean;
|
|
/**
|
|
* Equivalent to KeyboardEvent.isComposing.
|
|
*/
|
|
isComposing: boolean;
|
|
/**
|
|
* Equivalent to KeyboardEvent.shiftKey.
|
|
*/
|
|
shift: boolean;
|
|
/**
|
|
* Equivalent to KeyboardEvent.controlKey.
|
|
*/
|
|
control: boolean;
|
|
/**
|
|
* Equivalent to KeyboardEvent.altKey.
|
|
*/
|
|
alt: boolean;
|
|
/**
|
|
* Equivalent to KeyboardEvent.metaKey.
|
|
*/
|
|
meta: boolean;
|
|
/**
|
|
* Equivalent to KeyboardEvent.location.
|
|
*/
|
|
location: number;
|
|
/**
|
|
* See InputEvent.modifiers.
|
|
*/
|
|
modifiers: string[];
|
|
}
|
|
|
|
interface InsertCSSOptions {
|
|
/**
|
|
* Can be 'user' or 'author'. Sets the cascade origin of the inserted stylesheet.
|
|
* Default is 'author'.
|
|
*/
|
|
cssOrigin?: ('user' | 'author');
|
|
}
|
|
|
|
interface IpcMessageEvent extends DOMEvent {
|
|
/**
|
|
* pair of `[processId, frameId]`.
|
|
*/
|
|
frameId: [number, number];
|
|
channel: string;
|
|
args: any[];
|
|
}
|
|
|
|
interface Item {
|
|
/**
|
|
* The path to the file being dragged.
|
|
*/
|
|
file: string;
|
|
/**
|
|
* The paths to the files being dragged. (`files` will override `file` field)
|
|
*/
|
|
files?: string[];
|
|
/**
|
|
* The image must be non-empty on macOS.
|
|
*/
|
|
icon: (NativeImage) | (string);
|
|
}
|
|
|
|
interface JumpListSettings {
|
|
/**
|
|
* The minimum number of items that will be shown in the Jump List (for a more
|
|
* detailed description of this value see the MSDN docs).
|
|
*/
|
|
minItems: number;
|
|
/**
|
|
* Array of `JumpListItem` objects that correspond to items that the user has
|
|
* explicitly removed from custom categories in the Jump List. These items must not
|
|
* be re-added to the Jump List in the **next** call to `app.setJumpList()`,
|
|
* Windows will not display any custom category that contains any of the removed
|
|
* items.
|
|
*/
|
|
removedItems: JumpListItem[];
|
|
}
|
|
|
|
interface LoadCommitEvent extends DOMEvent {
|
|
url: string;
|
|
isMainFrame: boolean;
|
|
}
|
|
|
|
interface LoadExtensionOptions {
|
|
/**
|
|
* Whether to allow the extension to read local files over `file://` protocol and
|
|
* inject content scripts into `file://` pages. This is required e.g. for loading
|
|
* devtools extensions on `file://` URLs. Defaults to false.
|
|
*/
|
|
allowFileAccess: boolean;
|
|
}
|
|
|
|
interface LoadFileOptions {
|
|
/**
|
|
* Passed to `url.format()`.
|
|
*/
|
|
query?: Record<string, string>;
|
|
/**
|
|
* Passed to `url.format()`.
|
|
*/
|
|
search?: string;
|
|
/**
|
|
* Passed to `url.format()`.
|
|
*/
|
|
hash?: string;
|
|
}
|
|
|
|
interface LoadURLOptions {
|
|
/**
|
|
* An HTTP Referrer url.
|
|
*/
|
|
httpReferrer?: (string) | (Referrer);
|
|
/**
|
|
* A user agent originating the request.
|
|
*/
|
|
userAgent?: string;
|
|
/**
|
|
* Extra headers separated by "\n"
|
|
*/
|
|
extraHeaders?: string;
|
|
postData?: Array<(UploadRawData) | (UploadFile)>;
|
|
/**
|
|
* Base url (with trailing path separator) for files to be loaded by the data url.
|
|
* This is needed only if the specified `url` is a data url and needs to load other
|
|
* files.
|
|
*/
|
|
baseURLForDataURL?: string;
|
|
}
|
|
|
|
interface LoginItemSettings {
|
|
/**
|
|
* `true` if the app is set to open at login.
|
|
*/
|
|
openAtLogin: boolean;
|
|
/**
|
|
* `true` if the app is set to open as hidden at login. This setting is not
|
|
* available on MAS builds.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
openAsHidden: boolean;
|
|
/**
|
|
* `true` if the app was opened at login automatically. This setting is not
|
|
* available on MAS builds.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
wasOpenedAtLogin: boolean;
|
|
/**
|
|
* `true` if the app was opened as a hidden login item. This indicates that the app
|
|
* should not open any windows at startup. This setting is not available on MAS
|
|
* builds.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
wasOpenedAsHidden: boolean;
|
|
/**
|
|
* `true` if the app was opened as a login item that should restore the state from
|
|
* the previous session. This indicates that the app should restore the windows
|
|
* that were open the last time the app was closed. This setting is not available
|
|
* on MAS builds.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
restoreState: boolean;
|
|
/**
|
|
* `true` if app is set to open at login and its run key is not deactivated. This
|
|
* differs from `openAtLogin` as it ignores the `args` option, this property will
|
|
* be true if the given executable would be launched at login with **any**
|
|
* arguments.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
executableWillLaunchAtLogin: boolean;
|
|
launchItems: LaunchItems[];
|
|
}
|
|
|
|
interface LoginItemSettingsOptions {
|
|
/**
|
|
* The executable path to compare against. Defaults to `process.execPath`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* The command-line arguments to compare against. Defaults to an empty array.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
args?: string[];
|
|
}
|
|
|
|
interface MenuItemConstructorOptions {
|
|
/**
|
|
* Will be called with `click(menuItem, browserWindow, event)` when the menu item
|
|
* is clicked.
|
|
*/
|
|
click?: (menuItem: MenuItem, browserWindow: (BrowserWindow) | (undefined), event: KeyboardEvent) => void;
|
|
/**
|
|
* Can be `undo`, `redo`, `cut`, `copy`, `paste`, `pasteAndMatchStyle`, `delete`,
|
|
* `selectAll`, `reload`, `forceReload`, `toggleDevTools`, `resetZoom`, `zoomIn`,
|
|
* `zoomOut`, `toggleSpellChecker`, `togglefullscreen`, `window`, `minimize`,
|
|
* `close`, `help`, `about`, `services`, `hide`, `hideOthers`, `unhide`, `quit`,
|
|
* `showSubstitutions`, `toggleSmartQuotes`, `toggleSmartDashes`,
|
|
* `toggleTextReplacement`, `startSpeaking`, `stopSpeaking`, `zoom`, `front`,
|
|
* `appMenu`, `fileMenu`, `editMenu`, `viewMenu`, `shareMenu`, `recentDocuments`,
|
|
* `toggleTabBar`, `selectNextTab`, `selectPreviousTab`, `showAllTabs`,
|
|
* `mergeAllWindows`, `clearRecentDocuments`, `moveTabToNewWindow` or `windowMenu`
|
|
* - Define the action of the menu item, when specified the `click` property will
|
|
* be ignored. See roles.
|
|
*/
|
|
role?: ('undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'pasteAndMatchStyle' | 'delete' | 'selectAll' | 'reload' | 'forceReload' | 'toggleDevTools' | 'resetZoom' | 'zoomIn' | 'zoomOut' | 'toggleSpellChecker' | 'togglefullscreen' | 'window' | 'minimize' | 'close' | 'help' | 'about' | 'services' | 'hide' | 'hideOthers' | 'unhide' | 'quit' | 'showSubstitutions' | 'toggleSmartQuotes' | 'toggleSmartDashes' | 'toggleTextReplacement' | 'startSpeaking' | 'stopSpeaking' | 'zoom' | 'front' | 'appMenu' | 'fileMenu' | 'editMenu' | 'viewMenu' | 'shareMenu' | 'recentDocuments' | 'toggleTabBar' | 'selectNextTab' | 'selectPreviousTab' | 'showAllTabs' | 'mergeAllWindows' | 'clearRecentDocuments' | 'moveTabToNewWindow' | 'windowMenu');
|
|
/**
|
|
* Can be `normal`, `separator`, `submenu`, `checkbox` or `radio`.
|
|
*/
|
|
type?: ('normal' | 'separator' | 'submenu' | 'checkbox' | 'radio');
|
|
label?: string;
|
|
sublabel?: string;
|
|
/**
|
|
* Hover text for this menu item.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
toolTip?: string;
|
|
accelerator?: Accelerator;
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* If false, the menu item will be greyed out and unclickable.
|
|
*/
|
|
enabled?: boolean;
|
|
/**
|
|
* default is `true`, and when `false` will prevent the accelerator from triggering
|
|
* the item if the item is not visible.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
acceleratorWorksWhenHidden?: boolean;
|
|
/**
|
|
* If false, the menu item will be entirely hidden.
|
|
*/
|
|
visible?: boolean;
|
|
/**
|
|
* Should only be specified for `checkbox` or `radio` type menu items.
|
|
*/
|
|
checked?: boolean;
|
|
/**
|
|
* If false, the accelerator won't be registered with the system, but it will still
|
|
* be displayed. Defaults to true.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
registerAccelerator?: boolean;
|
|
/**
|
|
* The item to share when the `role` is `shareMenu`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
sharingItem?: SharingItem;
|
|
/**
|
|
* Should be specified for `submenu` type menu items. If `submenu` is specified,
|
|
* the `type: 'submenu'` can be omitted. If the value is not a `Menu` then it will
|
|
* be automatically converted to one using `Menu.buildFromTemplate`.
|
|
*/
|
|
submenu?: (MenuItemConstructorOptions[]) | (Menu);
|
|
/**
|
|
* Unique within a single menu. If defined then it can be used as a reference to
|
|
* this item by the position attribute.
|
|
*/
|
|
id?: string;
|
|
/**
|
|
* Inserts this item before the item with the specified label. If the referenced
|
|
* item doesn't exist the item will be inserted at the end of the menu. Also
|
|
* implies that the menu item in question should be placed in the same “group” as
|
|
* the item.
|
|
*/
|
|
before?: string[];
|
|
/**
|
|
* Inserts this item after the item with the specified label. If the referenced
|
|
* item doesn't exist the item will be inserted at the end of the menu.
|
|
*/
|
|
after?: string[];
|
|
/**
|
|
* Provides a means for a single context menu to declare the placement of their
|
|
* containing group before the containing group of the item with the specified
|
|
* label.
|
|
*/
|
|
beforeGroupContaining?: string[];
|
|
/**
|
|
* Provides a means for a single context menu to declare the placement of their
|
|
* containing group after the containing group of the item with the specified
|
|
* label.
|
|
*/
|
|
afterGroupContaining?: string[];
|
|
}
|
|
|
|
interface MessageBoxOptions {
|
|
/**
|
|
* Content of the message box.
|
|
*/
|
|
message: string;
|
|
/**
|
|
* Can be `none`, `info`, `error`, `question` or `warning`. On Windows, `question`
|
|
* displays the same icon as `info`, unless you set an icon using the `icon`
|
|
* option. On macOS, both `warning` and `error` display the same warning icon.
|
|
*/
|
|
type?: ('none' | 'info' | 'error' | 'question' | 'warning');
|
|
/**
|
|
* Array of texts for buttons. On Windows, an empty array will result in one button
|
|
* labeled "OK".
|
|
*/
|
|
buttons?: string[];
|
|
/**
|
|
* Index of the button in the buttons array which will be selected by default when
|
|
* the message box opens.
|
|
*/
|
|
defaultId?: number;
|
|
/**
|
|
* Pass an instance of AbortSignal to optionally close the message box, the message
|
|
* box will behave as if it was cancelled by the user. On macOS, `signal` does not
|
|
* work with message boxes that do not have a parent window, since those message
|
|
* boxes run synchronously due to platform limitations.
|
|
*/
|
|
signal?: AbortSignal;
|
|
/**
|
|
* Title of the message box, some platforms will not show it.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* Extra information of the message.
|
|
*/
|
|
detail?: string;
|
|
/**
|
|
* If provided, the message box will include a checkbox with the given label.
|
|
*/
|
|
checkboxLabel?: string;
|
|
/**
|
|
* Initial checked state of the checkbox. `false` by default.
|
|
*/
|
|
checkboxChecked?: boolean;
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* Custom width of the text in the message box.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
textWidth?: number;
|
|
/**
|
|
* The index of the button to be used to cancel the dialog, via the `Esc` key. By
|
|
* default this is assigned to the first button with "cancel" or "no" as the label.
|
|
* If no such labeled buttons exist and this option is not set, `0` will be used as
|
|
* the return value.
|
|
*/
|
|
cancelId?: number;
|
|
/**
|
|
* On Windows Electron will try to figure out which one of the `buttons` are common
|
|
* buttons (like "Cancel" or "Yes"), and show the others as command links in the
|
|
* dialog. This can make the dialog appear in the style of modern Windows apps. If
|
|
* you don't like this behavior, you can set `noLink` to `true`.
|
|
*/
|
|
noLink?: boolean;
|
|
/**
|
|
* Normalize the keyboard access keys across platforms. Default is `false`.
|
|
* Enabling this assumes `&` is used in the button labels for the placement of the
|
|
* keyboard shortcut access key and labels will be converted so they work correctly
|
|
* on each platform, `&` characters are removed on macOS, converted to `_` on
|
|
* Linux, and left untouched on Windows. For example, a button label of `Vie&w`
|
|
* will be converted to `Vie_w` on Linux and `View` on macOS and can be selected
|
|
* via `Alt-W` on Windows and Linux.
|
|
*/
|
|
normalizeAccessKeys?: boolean;
|
|
}
|
|
|
|
interface MessageBoxReturnValue {
|
|
/**
|
|
* The index of the clicked button.
|
|
*/
|
|
response: number;
|
|
/**
|
|
* The checked state of the checkbox if `checkboxLabel` was set. Otherwise `false`.
|
|
*/
|
|
checkboxChecked: boolean;
|
|
}
|
|
|
|
interface MessageBoxSyncOptions {
|
|
/**
|
|
* Content of the message box.
|
|
*/
|
|
message: string;
|
|
/**
|
|
* Can be `none`, `info`, `error`, `question` or `warning`. On Windows, `question`
|
|
* displays the same icon as `info`, unless you set an icon using the `icon`
|
|
* option. On macOS, both `warning` and `error` display the same warning icon.
|
|
*/
|
|
type?: ('none' | 'info' | 'error' | 'question' | 'warning');
|
|
/**
|
|
* Array of texts for buttons. On Windows, an empty array will result in one button
|
|
* labeled "OK".
|
|
*/
|
|
buttons?: string[];
|
|
/**
|
|
* Index of the button in the buttons array which will be selected by default when
|
|
* the message box opens.
|
|
*/
|
|
defaultId?: number;
|
|
/**
|
|
* Title of the message box, some platforms will not show it.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* Extra information of the message.
|
|
*/
|
|
detail?: string;
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* Custom width of the text in the message box.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
textWidth?: number;
|
|
/**
|
|
* The index of the button to be used to cancel the dialog, via the `Esc` key. By
|
|
* default this is assigned to the first button with "cancel" or "no" as the label.
|
|
* If no such labeled buttons exist and this option is not set, `0` will be used as
|
|
* the return value.
|
|
*/
|
|
cancelId?: number;
|
|
/**
|
|
* On Windows Electron will try to figure out which one of the `buttons` are common
|
|
* buttons (like "Cancel" or "Yes"), and show the others as command links in the
|
|
* dialog. This can make the dialog appear in the style of modern Windows apps. If
|
|
* you don't like this behavior, you can set `noLink` to `true`.
|
|
*/
|
|
noLink?: boolean;
|
|
/**
|
|
* Normalize the keyboard access keys across platforms. Default is `false`.
|
|
* Enabling this assumes `&` is used in the button labels for the placement of the
|
|
* keyboard shortcut access key and labels will be converted so they work correctly
|
|
* on each platform, `&` characters are removed on macOS, converted to `_` on
|
|
* Linux, and left untouched on Windows. For example, a button label of `Vie&w`
|
|
* will be converted to `Vie_w` on Linux and `View` on macOS and can be selected
|
|
* via `Alt-W` on Windows and Linux.
|
|
*/
|
|
normalizeAccessKeys?: boolean;
|
|
}
|
|
|
|
interface MessageDetails {
|
|
/**
|
|
* The actual console message
|
|
*/
|
|
message: string;
|
|
/**
|
|
* The version ID of the service worker that sent the log message
|
|
*/
|
|
versionId: number;
|
|
/**
|
|
* The type of source for this message. Can be `javascript`, `xml`, `network`,
|
|
* `console-api`, `storage`, `rendering`, `security`, `deprecation`, `worker`,
|
|
* `violation`, `intervention`, `recommendation` or `other`.
|
|
*/
|
|
source: ('javascript' | 'xml' | 'network' | 'console-api' | 'storage' | 'rendering' | 'security' | 'deprecation' | 'worker' | 'violation' | 'intervention' | 'recommendation' | 'other');
|
|
/**
|
|
* The log level, from 0 to 3. In order it matches `verbose`, `info`, `warning` and
|
|
* `error`.
|
|
*/
|
|
level: number;
|
|
/**
|
|
* The URL the message came from
|
|
*/
|
|
sourceUrl: string;
|
|
/**
|
|
* The line number of the source that triggered this console message
|
|
*/
|
|
lineNumber: number;
|
|
}
|
|
|
|
interface MessageEvent {
|
|
data: any;
|
|
ports: MessagePortMain[];
|
|
}
|
|
|
|
interface MoveToApplicationsFolderOptions {
|
|
/**
|
|
* A handler for potential conflict in move failure.
|
|
*/
|
|
conflictHandler?: (conflictType: 'exists' | 'existsAndRunning') => boolean;
|
|
}
|
|
|
|
interface NotificationConstructorOptions {
|
|
/**
|
|
* A title for the notification, which will be displayed at the top of the
|
|
* notification window when it is shown.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* A subtitle for the notification, which will be displayed below the title.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
subtitle?: string;
|
|
/**
|
|
* The body text of the notification, which will be displayed below the title or
|
|
* subtitle.
|
|
*/
|
|
body?: string;
|
|
/**
|
|
* Whether or not to suppress the OS notification noise when showing the
|
|
* notification.
|
|
*/
|
|
silent?: boolean;
|
|
/**
|
|
* An icon to use in the notification.
|
|
*/
|
|
icon?: (string) | (NativeImage);
|
|
/**
|
|
* Whether or not to add an inline reply option to the notification.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
hasReply?: boolean;
|
|
/**
|
|
* The timeout duration of the notification. Can be 'default' or 'never'.
|
|
*
|
|
* @platform linux,win32
|
|
*/
|
|
timeoutType?: ('default' | 'never');
|
|
/**
|
|
* The placeholder to write in the inline reply input field.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
replyPlaceholder?: string;
|
|
/**
|
|
* The name of the sound file to play when the notification is shown.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
sound?: string;
|
|
/**
|
|
* The urgency level of the notification. Can be 'normal', 'critical', or 'low'.
|
|
*
|
|
* @platform linux
|
|
*/
|
|
urgency?: ('normal' | 'critical' | 'low');
|
|
/**
|
|
* Actions to add to the notification. Please read the available actions and
|
|
* limitations in the `NotificationAction` documentation.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
actions?: NotificationAction[];
|
|
/**
|
|
* A custom title for the close button of an alert. An empty string will cause the
|
|
* default localized text to be used.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
closeButtonText?: string;
|
|
/**
|
|
* A custom description of the Notification on Windows superseding all properties
|
|
* above. Provides full customization of design and behavior of the notification.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
toastXml?: string;
|
|
}
|
|
|
|
interface OnBeforeRedirectListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
redirectURL: string;
|
|
statusCode: number;
|
|
statusLine: string;
|
|
/**
|
|
* The server IP address that the request was actually sent to.
|
|
*/
|
|
ip?: string;
|
|
fromCache: boolean;
|
|
responseHeaders?: Record<string, string[]>;
|
|
}
|
|
|
|
interface OnBeforeRequestListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
uploadData: UploadData[];
|
|
}
|
|
|
|
interface OnBeforeSendHeadersListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
uploadData?: UploadData[];
|
|
requestHeaders: Record<string, string>;
|
|
}
|
|
|
|
interface OnCompletedListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
responseHeaders?: Record<string, string[]>;
|
|
fromCache: boolean;
|
|
statusCode: number;
|
|
statusLine: string;
|
|
error: string;
|
|
}
|
|
|
|
interface OnErrorOccurredListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
fromCache: boolean;
|
|
/**
|
|
* The error description.
|
|
*/
|
|
error: string;
|
|
}
|
|
|
|
interface OnHeadersReceivedListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
statusLine: string;
|
|
statusCode: number;
|
|
responseHeaders?: Record<string, string[]>;
|
|
}
|
|
|
|
interface OnResponseStartedListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
responseHeaders?: Record<string, string[]>;
|
|
/**
|
|
* Indicates whether the response was fetched from disk cache.
|
|
*/
|
|
fromCache: boolean;
|
|
statusCode: number;
|
|
statusLine: string;
|
|
}
|
|
|
|
interface OnSendHeadersListenerDetails {
|
|
id: number;
|
|
url: string;
|
|
method: string;
|
|
webContentsId?: number;
|
|
webContents?: WebContents;
|
|
frame?: WebFrameMain;
|
|
/**
|
|
* Can be `mainFrame`, `subFrame`, `stylesheet`, `script`, `image`, `font`,
|
|
* `object`, `xhr`, `ping`, `cspReport`, `media`, `webSocket` or `other`.
|
|
*/
|
|
resourceType: ('mainFrame' | 'subFrame' | 'stylesheet' | 'script' | 'image' | 'font' | 'object' | 'xhr' | 'ping' | 'cspReport' | 'media' | 'webSocket' | 'other');
|
|
referrer: string;
|
|
timestamp: number;
|
|
requestHeaders: Record<string, string>;
|
|
}
|
|
|
|
interface OpenDevToolsOptions {
|
|
/**
|
|
* Opens the devtools with specified dock state, can be `left`, `right`, `bottom`,
|
|
* `undocked`, `detach`. Defaults to last used dock state. In `undocked` mode it's
|
|
* possible to dock back. In `detach` mode it's not.
|
|
*/
|
|
mode: ('left' | 'right' | 'bottom' | 'undocked' | 'detach');
|
|
/**
|
|
* Whether to bring the opened devtools window to the foreground. The default is
|
|
* `true`.
|
|
*/
|
|
activate?: boolean;
|
|
/**
|
|
* A title for the DevTools window (only in `undocked` or `detach` mode).
|
|
*/
|
|
title?: string;
|
|
}
|
|
|
|
interface OpenDialogOptions {
|
|
title?: string;
|
|
defaultPath?: string;
|
|
/**
|
|
* Custom label for the confirmation button, when left empty the default label will
|
|
* be used.
|
|
*/
|
|
buttonLabel?: string;
|
|
filters?: FileFilter[];
|
|
/**
|
|
* Contains which features the dialog should use. The following values are
|
|
* supported:
|
|
*/
|
|
properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles' | 'createDirectory' | 'promptToCreate' | 'noResolveAliases' | 'treatPackageAsDirectory' | 'dontAddToRecent'>;
|
|
/**
|
|
* Message to display above input boxes.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
message?: string;
|
|
/**
|
|
* Create security scoped bookmarks when packaged for the Mac App Store.
|
|
*
|
|
* @platform darwin,mas
|
|
*/
|
|
securityScopedBookmarks?: boolean;
|
|
}
|
|
|
|
interface OpenDialogReturnValue {
|
|
/**
|
|
* whether or not the dialog was canceled.
|
|
*/
|
|
canceled: boolean;
|
|
/**
|
|
* An array of file paths chosen by the user. If the dialog is cancelled this will
|
|
* be an empty array.
|
|
*/
|
|
filePaths: string[];
|
|
/**
|
|
* An array matching the `filePaths` array of base64 encoded strings which contains
|
|
* security scoped bookmark data. `securityScopedBookmarks` must be enabled for
|
|
* this to be populated. (For return values, see table here.)
|
|
*
|
|
* @platform darwin,mas
|
|
*/
|
|
bookmarks?: string[];
|
|
}
|
|
|
|
interface OpenDialogSyncOptions {
|
|
title?: string;
|
|
defaultPath?: string;
|
|
/**
|
|
* Custom label for the confirmation button, when left empty the default label will
|
|
* be used.
|
|
*/
|
|
buttonLabel?: string;
|
|
filters?: FileFilter[];
|
|
/**
|
|
* Contains which features the dialog should use. The following values are
|
|
* supported:
|
|
*/
|
|
properties?: Array<'openFile' | 'openDirectory' | 'multiSelections' | 'showHiddenFiles' | 'createDirectory' | 'promptToCreate' | 'noResolveAliases' | 'treatPackageAsDirectory' | 'dontAddToRecent'>;
|
|
/**
|
|
* Message to display above input boxes.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
message?: string;
|
|
/**
|
|
* Create security scoped bookmarks when packaged for the Mac App Store.
|
|
*
|
|
* @platform darwin,mas
|
|
*/
|
|
securityScopedBookmarks?: boolean;
|
|
}
|
|
|
|
interface OpenExternalOptions {
|
|
/**
|
|
* `true` to bring the opened application to the foreground. The default is `true`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
activate?: boolean;
|
|
/**
|
|
* The working directory.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
workingDirectory?: string;
|
|
/**
|
|
* Indicates a user initiated launch that enables tracking of frequently used
|
|
* programs and other behaviors. The default is `false`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
logUsage?: boolean;
|
|
}
|
|
|
|
interface Options {
|
|
}
|
|
|
|
interface Opts {
|
|
/**
|
|
* Keep the page hidden instead of visible. Default is `false`.
|
|
*/
|
|
stayHidden?: boolean;
|
|
/**
|
|
* Keep the system awake instead of allowing it to sleep. Default is `false`.
|
|
*/
|
|
stayAwake?: boolean;
|
|
}
|
|
|
|
interface PageFaviconUpdatedEvent extends DOMEvent {
|
|
/**
|
|
* Array of URLs.
|
|
*/
|
|
favicons: string[];
|
|
}
|
|
|
|
interface PageTitleUpdatedEvent extends DOMEvent {
|
|
title: string;
|
|
explicitSet: boolean;
|
|
}
|
|
|
|
interface Parameters {
|
|
/**
|
|
* Specify the screen type to emulate (default: `desktop`):
|
|
*/
|
|
screenPosition: ('desktop' | 'mobile');
|
|
/**
|
|
* Set the emulated screen size (screenPosition == mobile).
|
|
*/
|
|
screenSize: Size;
|
|
/**
|
|
* Position the view on the screen (screenPosition == mobile) (default: `{ x: 0, y:
|
|
* 0 }`).
|
|
*/
|
|
viewPosition: Point;
|
|
/**
|
|
* Set the device scale factor (if zero defaults to original device scale factor)
|
|
* (default: `0`).
|
|
*/
|
|
deviceScaleFactor: number;
|
|
/**
|
|
* Set the emulated view size (empty means no override)
|
|
*/
|
|
viewSize: Size;
|
|
/**
|
|
* Scale of emulated view inside available space (not in fit to view mode)
|
|
* (default: `1`).
|
|
*/
|
|
scale: number;
|
|
}
|
|
|
|
interface Payment {
|
|
/**
|
|
* The identifier of the purchased product.
|
|
*/
|
|
productIdentifier: string;
|
|
/**
|
|
* The quantity purchased.
|
|
*/
|
|
quantity: number;
|
|
/**
|
|
* An opaque identifier for the user’s account on your system.
|
|
*/
|
|
applicationUsername: string;
|
|
/**
|
|
* The details of the discount offer to apply to the payment.
|
|
*/
|
|
paymentDiscount?: PaymentDiscount;
|
|
}
|
|
|
|
interface PermissionCheckHandlerHandlerDetails {
|
|
/**
|
|
* The origin of the frame embedding the frame that made the permission check.
|
|
* Only set for cross-origin sub frames making permission checks.
|
|
*/
|
|
embeddingOrigin?: string;
|
|
/**
|
|
* The security origin of the `media` check.
|
|
*/
|
|
securityOrigin?: string;
|
|
/**
|
|
* The type of media access being requested, can be `video`, `audio` or `unknown`
|
|
*/
|
|
mediaType?: ('video' | 'audio' | 'unknown');
|
|
/**
|
|
* The last URL the requesting frame loaded. This is not provided for cross-origin
|
|
* sub frames making permission checks.
|
|
*/
|
|
requestingUrl?: string;
|
|
/**
|
|
* Whether the frame making the request is the main frame
|
|
*/
|
|
isMainFrame: boolean;
|
|
}
|
|
|
|
interface PermissionRequestHandlerHandlerDetails {
|
|
/**
|
|
* The url of the `openExternal` request.
|
|
*/
|
|
externalURL?: string;
|
|
/**
|
|
* The security origin of the `media` request.
|
|
*/
|
|
securityOrigin?: string;
|
|
/**
|
|
* The types of media access being requested, elements can be `video` or `audio`
|
|
*/
|
|
mediaTypes?: Array<'video' | 'audio'>;
|
|
/**
|
|
* The last URL the requesting frame loaded
|
|
*/
|
|
requestingUrl: string;
|
|
/**
|
|
* Whether the frame making the request is the main frame
|
|
*/
|
|
isMainFrame: boolean;
|
|
}
|
|
|
|
interface PluginCrashedEvent extends DOMEvent {
|
|
name: string;
|
|
version: string;
|
|
}
|
|
|
|
interface PopupOptions {
|
|
/**
|
|
* Default is the focused window.
|
|
*/
|
|
window?: BrowserWindow;
|
|
/**
|
|
* Default is the current mouse cursor position. Must be declared if `y` is
|
|
* declared.
|
|
*/
|
|
x?: number;
|
|
/**
|
|
* Default is the current mouse cursor position. Must be declared if `x` is
|
|
* declared.
|
|
*/
|
|
y?: number;
|
|
/**
|
|
* The index of the menu item to be positioned under the mouse cursor at the
|
|
* specified coordinates. Default is -1.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
positioningItem?: number;
|
|
/**
|
|
* This should map to the `menuSourceType` provided by the `context-menu` event. It
|
|
* is not recommended to set this value manually, only provide values you receive
|
|
* from other APIs or leave it `undefined`. Can be `none`, `mouse`, `keyboard`,
|
|
* `touch`, `touchMenu`, `longPress`, `longTap`, `touchHandle`, `stylus`,
|
|
* `adjustSelection`, or `adjustSelectionReset`.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
sourceType?: ('none' | 'mouse' | 'keyboard' | 'touch' | 'touchMenu' | 'longPress' | 'longTap' | 'touchHandle' | 'stylus' | 'adjustSelection' | 'adjustSelectionReset');
|
|
/**
|
|
* Called when menu is closed.
|
|
*/
|
|
callback?: () => void;
|
|
}
|
|
|
|
interface PreconnectOptions {
|
|
/**
|
|
* URL for preconnect. Only the origin is relevant for opening the socket.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* number of sockets to preconnect. Must be between 1 and 6. Defaults to 1.
|
|
*/
|
|
numSockets?: number;
|
|
}
|
|
|
|
interface PrintToPDFOptions {
|
|
/**
|
|
* Paper orientation.`true` for landscape, `false` for portrait. Defaults to false.
|
|
*/
|
|
landscape?: boolean;
|
|
/**
|
|
* Whether to display header and footer. Defaults to false.
|
|
*/
|
|
displayHeaderFooter?: boolean;
|
|
/**
|
|
* Whether to print background graphics. Defaults to false.
|
|
*/
|
|
printBackground?: boolean;
|
|
/**
|
|
* Scale of the webpage rendering. Defaults to 1.
|
|
*/
|
|
scale?: number;
|
|
/**
|
|
* Specify page size of the generated PDF. Can be `A0`, `A1`, `A2`, `A3`, `A4`,
|
|
* `A5`, `A6`, `Legal`, `Letter`, `Tabloid`, `Ledger`, or an Object containing
|
|
* `height` and `width` in inches. Defaults to `Letter`.
|
|
*/
|
|
pageSize?: (('A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'Legal' | 'Letter' | 'Tabloid' | 'Ledger')) | (Size);
|
|
margins?: Margins;
|
|
/**
|
|
* Page ranges to print, e.g., '1-5, 8, 11-13'. Defaults to the empty string, which
|
|
* means print all pages.
|
|
*/
|
|
pageRanges?: string;
|
|
/**
|
|
* HTML template for the print header. Should be valid HTML markup with following
|
|
* classes used to inject printing values into them: `date` (formatted print date),
|
|
* `title` (document title), `url` (document location), `pageNumber` (current page
|
|
* number) and `totalPages` (total pages in the document). For example, `<span
|
|
* class=title></span>` would generate span containing the title.
|
|
*/
|
|
headerTemplate?: string;
|
|
/**
|
|
* HTML template for the print footer. Should use the same format as the
|
|
* `headerTemplate`.
|
|
*/
|
|
footerTemplate?: string;
|
|
/**
|
|
* Whether or not to prefer page size as defined by css. Defaults to false, in
|
|
* which case the content will be scaled to fit the paper size.
|
|
*/
|
|
preferCSSPageSize?: boolean;
|
|
}
|
|
|
|
interface Privileges {
|
|
/**
|
|
* Default false.
|
|
*/
|
|
standard?: boolean;
|
|
/**
|
|
* Default false.
|
|
*/
|
|
secure?: boolean;
|
|
/**
|
|
* Default false.
|
|
*/
|
|
bypassCSP?: boolean;
|
|
/**
|
|
* Default false.
|
|
*/
|
|
allowServiceWorkers?: boolean;
|
|
/**
|
|
* Default false.
|
|
*/
|
|
supportFetchAPI?: boolean;
|
|
/**
|
|
* Default false.
|
|
*/
|
|
corsEnabled?: boolean;
|
|
/**
|
|
* Default false.
|
|
*/
|
|
stream?: boolean;
|
|
}
|
|
|
|
interface ProgressBarOptions {
|
|
/**
|
|
* Mode for the progress bar. Can be `none`, `normal`, `indeterminate`, `error` or
|
|
* `paused`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
mode: ('none' | 'normal' | 'indeterminate' | 'error' | 'paused');
|
|
}
|
|
|
|
interface Provider {
|
|
spellCheck: (words: string[], callback: (misspeltWords: string[]) => void) => void;
|
|
}
|
|
|
|
interface PurchaseProductOpts {
|
|
/**
|
|
* The number of items the user wants to purchase.
|
|
*/
|
|
quantity?: number;
|
|
/**
|
|
* The string that associates the transaction with a user account on your service
|
|
* (applicationUsername).
|
|
*/
|
|
username?: string;
|
|
}
|
|
|
|
interface ReadBookmark {
|
|
title: string;
|
|
url: string;
|
|
}
|
|
|
|
interface RegistrationCompletedDetails {
|
|
/**
|
|
* The base URL that a service worker is registered for
|
|
*/
|
|
scope: string;
|
|
}
|
|
|
|
interface RelaunchOptions {
|
|
args?: string[];
|
|
execPath?: string;
|
|
}
|
|
|
|
interface RenderProcessGoneEvent extends DOMEvent {
|
|
details: RenderProcessGoneDetails;
|
|
}
|
|
|
|
interface Request {
|
|
hostname: string;
|
|
certificate: Certificate;
|
|
validatedCertificate: Certificate;
|
|
/**
|
|
* `true` if Chromium recognises the root CA as a standard root. If it isn't then
|
|
* it's probably the case that this certificate was generated by a MITM proxy whose
|
|
* root has been installed locally (for example, by a corporate proxy). This should
|
|
* not be trusted if the `verificationResult` is not `OK`.
|
|
*/
|
|
isIssuedByKnownRoot: boolean;
|
|
/**
|
|
* `OK` if the certificate is trusted, otherwise an error like `CERT_REVOKED`.
|
|
*/
|
|
verificationResult: string;
|
|
/**
|
|
* Error code.
|
|
*/
|
|
errorCode: number;
|
|
}
|
|
|
|
interface ResizeOptions {
|
|
/**
|
|
* Defaults to the image's width.
|
|
*/
|
|
width?: number;
|
|
/**
|
|
* Defaults to the image's height.
|
|
*/
|
|
height?: number;
|
|
/**
|
|
* The desired quality of the resize image. Possible values include `good`,
|
|
* `better`, or `best`. The default is `best`. These values express a desired
|
|
* quality/speed tradeoff. They are translated into an algorithm-specific method
|
|
* that depends on the capabilities (CPU, GPU) of the underlying platform. It is
|
|
* possible for all three methods to be mapped to the same algorithm on a given
|
|
* platform.
|
|
*/
|
|
quality?: ('good' | 'better' | 'best');
|
|
}
|
|
|
|
interface ResolveHostOptions {
|
|
/**
|
|
* Requested DNS query type. If unspecified, resolver will pick A or AAAA (or both)
|
|
* based on IPv4/IPv6 settings:
|
|
*/
|
|
queryType?: ('A' | 'AAAA');
|
|
/**
|
|
* The source to use for resolved addresses. Default allows the resolver to pick an
|
|
* appropriate source. Only affects use of big external sources (e.g. calling the
|
|
* system for resolution or using DNS). Even if a source is specified, results can
|
|
* still come from cache, resolving "localhost" or IP literals, etc. One of the
|
|
* following values:
|
|
*/
|
|
source?: ('any' | 'system' | 'dns' | 'mdns' | 'localOnly');
|
|
/**
|
|
* Indicates what DNS cache entries, if any, can be used to provide a response. One
|
|
* of the following values:
|
|
*/
|
|
cacheUsage?: ('allowed' | 'staleAllowed' | 'disallowed');
|
|
/**
|
|
* Controls the resolver's Secure DNS behavior for this request. One of the
|
|
* following values:
|
|
*/
|
|
secureDnsPolicy?: ('allow' | 'disable');
|
|
}
|
|
|
|
interface ResourceUsage {
|
|
images: MemoryUsageDetails;
|
|
scripts: MemoryUsageDetails;
|
|
cssStyleSheets: MemoryUsageDetails;
|
|
xslStyleSheets: MemoryUsageDetails;
|
|
fonts: MemoryUsageDetails;
|
|
other: MemoryUsageDetails;
|
|
}
|
|
|
|
interface Response {
|
|
/**
|
|
* `false` should be passed in if the dialog is canceled. If the `pairingKind` is
|
|
* `confirm` or `confirmPin`, this value should indicate if the pairing is
|
|
* confirmed. If the `pairingKind` is `providePin` the value should be `true` when
|
|
* a value is provided.
|
|
*/
|
|
confirmed: boolean;
|
|
/**
|
|
* When the `pairingKind` is `providePin` this value should be the required pin for
|
|
* the Bluetooth device.
|
|
*/
|
|
pin?: (string) | (null);
|
|
}
|
|
|
|
interface Result {
|
|
requestId: number;
|
|
/**
|
|
* Position of the active match.
|
|
*/
|
|
activeMatchOrdinal: number;
|
|
/**
|
|
* Number of Matches.
|
|
*/
|
|
matches: number;
|
|
/**
|
|
* Coordinates of first match region.
|
|
*/
|
|
selectionArea: Rectangle;
|
|
finalUpdate: boolean;
|
|
}
|
|
|
|
interface SaveDialogOptions {
|
|
/**
|
|
* The dialog title. Cannot be displayed on some _Linux_ desktop environments.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* Absolute directory path, absolute file path, or file name to use by default.
|
|
*/
|
|
defaultPath?: string;
|
|
/**
|
|
* Custom label for the confirmation button, when left empty the default label will
|
|
* be used.
|
|
*/
|
|
buttonLabel?: string;
|
|
filters?: FileFilter[];
|
|
/**
|
|
* Message to display above text fields.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
message?: string;
|
|
/**
|
|
* Custom label for the text displayed in front of the filename text field.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
nameFieldLabel?: string;
|
|
/**
|
|
* Show the tags input box, defaults to `true`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
showsTagField?: boolean;
|
|
properties?: Array<'showHiddenFiles' | 'createDirectory' | 'treatPackageAsDirectory' | 'showOverwriteConfirmation' | 'dontAddToRecent'>;
|
|
/**
|
|
* Create a security scoped bookmark when packaged for the Mac App Store. If this
|
|
* option is enabled and the file doesn't already exist a blank file will be
|
|
* created at the chosen path.
|
|
*
|
|
* @platform darwin,mas
|
|
*/
|
|
securityScopedBookmarks?: boolean;
|
|
}
|
|
|
|
interface SaveDialogReturnValue {
|
|
/**
|
|
* whether or not the dialog was canceled.
|
|
*/
|
|
canceled: boolean;
|
|
/**
|
|
* If the dialog is canceled, this will be `undefined`.
|
|
*/
|
|
filePath?: string;
|
|
/**
|
|
* Base64 encoded string which contains the security scoped bookmark data for the
|
|
* saved file. `securityScopedBookmarks` must be enabled for this to be present.
|
|
* (For return values, see table here.)
|
|
*
|
|
* @platform darwin,mas
|
|
*/
|
|
bookmark?: string;
|
|
}
|
|
|
|
interface SaveDialogSyncOptions {
|
|
/**
|
|
* The dialog title. Cannot be displayed on some _Linux_ desktop environments.
|
|
*/
|
|
title?: string;
|
|
/**
|
|
* Absolute directory path, absolute file path, or file name to use by default.
|
|
*/
|
|
defaultPath?: string;
|
|
/**
|
|
* Custom label for the confirmation button, when left empty the default label will
|
|
* be used.
|
|
*/
|
|
buttonLabel?: string;
|
|
filters?: FileFilter[];
|
|
/**
|
|
* Message to display above text fields.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
message?: string;
|
|
/**
|
|
* Custom label for the text displayed in front of the filename text field.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
nameFieldLabel?: string;
|
|
/**
|
|
* Show the tags input box, defaults to `true`.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
showsTagField?: boolean;
|
|
properties?: Array<'showHiddenFiles' | 'createDirectory' | 'treatPackageAsDirectory' | 'showOverwriteConfirmation' | 'dontAddToRecent'>;
|
|
/**
|
|
* Create a security scoped bookmark when packaged for the Mac App Store. If this
|
|
* option is enabled and the file doesn't already exist a blank file will be
|
|
* created at the chosen path.
|
|
*
|
|
* @platform darwin,mas
|
|
*/
|
|
securityScopedBookmarks?: boolean;
|
|
}
|
|
|
|
interface SelectHidDeviceDetails {
|
|
deviceList: HIDDevice[];
|
|
frame: WebFrameMain;
|
|
}
|
|
|
|
interface SelectUsbDeviceDetails {
|
|
deviceList: USBDevice[];
|
|
frame: WebFrameMain;
|
|
}
|
|
|
|
interface SerialPortRevokedDetails {
|
|
port: SerialPort;
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The origin that the device has been revoked from.
|
|
*/
|
|
origin: string;
|
|
}
|
|
|
|
interface Settings {
|
|
/**
|
|
* `true` to open the app at login, `false` to remove the app as a login item.
|
|
* Defaults to `false`.
|
|
*/
|
|
openAtLogin?: boolean;
|
|
/**
|
|
* `true` to open the app as hidden. Defaults to `false`. The user can edit this
|
|
* setting from the System Preferences so
|
|
* `app.getLoginItemSettings().wasOpenedAsHidden` should be checked when the app is
|
|
* opened to know the current value. This setting is not available on MAS builds.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
openAsHidden?: boolean;
|
|
/**
|
|
* The executable to launch at login. Defaults to `process.execPath`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
path?: string;
|
|
/**
|
|
* The command-line arguments to pass to the executable. Defaults to an empty
|
|
* array. Take care to wrap paths in quotes.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
args?: string[];
|
|
/**
|
|
* `true` will change the startup approved registry key and `enable / disable` the
|
|
* App in Task Manager and Windows Settings. Defaults to `true`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
enabled?: boolean;
|
|
/**
|
|
* value name to write into registry. Defaults to the app's AppUserModelId(). Set
|
|
* the app's login item settings.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
name?: string;
|
|
}
|
|
|
|
interface SourcesOptions {
|
|
/**
|
|
* An array of strings that lists the types of desktop sources to be captured,
|
|
* available types can be `screen` and `window`.
|
|
*/
|
|
types: Array<'screen' | 'window'>;
|
|
/**
|
|
* The size that the media source thumbnail should be scaled to. Default is `150` x
|
|
* `150`. Set width or height to 0 when you do not need the thumbnails. This will
|
|
* save the processing time required for capturing the content of each window and
|
|
* screen.
|
|
*/
|
|
thumbnailSize?: Size;
|
|
/**
|
|
* Set to true to enable fetching window icons. The default value is false. When
|
|
* false the appIcon property of the sources return null. Same if a source has the
|
|
* type screen.
|
|
*/
|
|
fetchWindowIcons?: boolean;
|
|
}
|
|
|
|
interface SSLConfigConfig {
|
|
/**
|
|
* Can be `tls1`, `tls1.1`, `tls1.2` or `tls1.3`. The minimum SSL version to allow
|
|
* when connecting to remote servers. Defaults to `tls1`.
|
|
*/
|
|
minVersion?: ('tls1' | 'tls1.1' | 'tls1.2' | 'tls1.3');
|
|
/**
|
|
* Can be `tls1.2` or `tls1.3`. The maximum SSL version to allow when connecting to
|
|
* remote servers. Defaults to `tls1.3`.
|
|
*/
|
|
maxVersion?: ('tls1.2' | 'tls1.3');
|
|
/**
|
|
* List of cipher suites which should be explicitly prevented from being used in
|
|
* addition to those disabled by the net built-in policy. Supported literal forms:
|
|
* 0xAABB, where AA is `cipher_suite[0]` and BB is `cipher_suite[1]`, as defined in
|
|
* RFC 2246, Section 7.4.1.2. Unrecognized but parsable cipher suites in this form
|
|
* will not return an error. Ex: To disable TLS_RSA_WITH_RC4_128_MD5, specify
|
|
* 0x0004, while to disable TLS_ECDH_ECDSA_WITH_RC4_128_SHA, specify 0xC002. Note
|
|
* that TLSv1.3 ciphers cannot be disabled using this mechanism.
|
|
*/
|
|
disabledCipherSuites?: number[];
|
|
}
|
|
|
|
interface StartLoggingOptions {
|
|
/**
|
|
* What kinds of data should be captured. By default, only metadata about requests
|
|
* will be captured. Setting this to `includeSensitive` will include cookies and
|
|
* authentication data. Setting it to `everything` will include all bytes
|
|
* transferred on sockets. Can be `default`, `includeSensitive` or `everything`.
|
|
*/
|
|
captureMode?: ('default' | 'includeSensitive' | 'everything');
|
|
/**
|
|
* When the log grows beyond this size, logging will automatically stop. Defaults
|
|
* to unlimited.
|
|
*/
|
|
maxFileSize?: number;
|
|
}
|
|
|
|
interface Streams {
|
|
video?: (Video) | (WebFrameMain);
|
|
/**
|
|
* If a string is specified, can be `loopback` or `loopbackWithMute`. Specifying a
|
|
* loopback device will capture system audio, and is currently only supported on
|
|
* Windows. If a WebFrameMain is specified, will capture audio from that frame.
|
|
*/
|
|
audio?: (('loopback' | 'loopbackWithMute')) | (WebFrameMain);
|
|
/**
|
|
* If `audio` is a WebFrameMain and this is set to `true`, then local playback of
|
|
* audio will not be muted (e.g. using `MediaRecorder` to record `WebFrameMain`
|
|
* with this flag set to `true` will allow audio to pass through to the speakers
|
|
* while recording). Default is `false`.
|
|
*/
|
|
enableLocalEcho?: boolean;
|
|
}
|
|
|
|
interface SystemMemoryInfo {
|
|
/**
|
|
* The total amount of physical memory in Kilobytes available to the system.
|
|
*/
|
|
total: number;
|
|
/**
|
|
* The total amount of memory not being used by applications or disk cache.
|
|
*/
|
|
free: number;
|
|
/**
|
|
* The total amount of swap memory in Kilobytes available to the system.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
swapTotal: number;
|
|
/**
|
|
* The free amount of swap memory in Kilobytes available to the system.
|
|
*
|
|
* @platform win32,linux
|
|
*/
|
|
swapFree: number;
|
|
}
|
|
|
|
interface TitleBarOverlay {
|
|
/**
|
|
* The CSS color of the Window Controls Overlay when enabled. Default is the system
|
|
* color.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
color?: string;
|
|
/**
|
|
* The CSS color of the symbols on the Window Controls Overlay when enabled.
|
|
* Default is the system color.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
symbolColor?: string;
|
|
/**
|
|
* The height of the title bar and Window Controls Overlay in pixels. Default is
|
|
* system height.
|
|
*
|
|
* @platform darwin,win32
|
|
*/
|
|
height?: number;
|
|
}
|
|
|
|
interface TitleBarOverlayOptions {
|
|
/**
|
|
* The CSS color of the Window Controls Overlay when enabled.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
color?: string;
|
|
/**
|
|
* The CSS color of the symbols on the Window Controls Overlay when enabled.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
symbolColor?: string;
|
|
/**
|
|
* The height of the title bar and Window Controls Overlay in pixels.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
height?: number;
|
|
}
|
|
|
|
interface TitleOptions {
|
|
/**
|
|
* The font family variant to display, can be `monospaced` or `monospacedDigit`.
|
|
* `monospaced` is available in macOS 10.15+ When left blank, the title uses the
|
|
* default system font.
|
|
*/
|
|
fontType?: ('monospaced' | 'monospacedDigit');
|
|
}
|
|
|
|
interface ToBitmapOptions {
|
|
/**
|
|
* Defaults to 1.0.
|
|
*/
|
|
scaleFactor?: number;
|
|
}
|
|
|
|
interface ToDataURLOptions {
|
|
/**
|
|
* Defaults to 1.0.
|
|
*/
|
|
scaleFactor?: number;
|
|
}
|
|
|
|
interface ToPNGOptions {
|
|
/**
|
|
* Defaults to 1.0.
|
|
*/
|
|
scaleFactor?: number;
|
|
}
|
|
|
|
interface TouchBarButtonConstructorOptions {
|
|
/**
|
|
* Button text.
|
|
*/
|
|
label?: string;
|
|
/**
|
|
* A short description of the button for use by screenreaders like VoiceOver.
|
|
*/
|
|
accessibilityLabel?: string;
|
|
/**
|
|
* Button background color in hex format, i.e `#ABCDEF`.
|
|
*/
|
|
backgroundColor?: string;
|
|
/**
|
|
* Button icon.
|
|
*/
|
|
icon?: (NativeImage) | (string);
|
|
/**
|
|
* Can be `left`, `right` or `overlay`. Defaults to `overlay`.
|
|
*/
|
|
iconPosition?: ('left' | 'right' | 'overlay');
|
|
/**
|
|
* Function to call when the button is clicked.
|
|
*/
|
|
click?: () => void;
|
|
/**
|
|
* Whether the button is in an enabled state. Default is `true`.
|
|
*/
|
|
enabled?: boolean;
|
|
}
|
|
|
|
interface TouchBarColorPickerConstructorOptions {
|
|
/**
|
|
* Array of hex color strings to appear as possible colors to select.
|
|
*/
|
|
availableColors?: string[];
|
|
/**
|
|
* The selected hex color in the picker, i.e `#ABCDEF`.
|
|
*/
|
|
selectedColor?: string;
|
|
/**
|
|
* Function to call when a color is selected.
|
|
*/
|
|
change?: (color: string) => void;
|
|
}
|
|
|
|
interface TouchBarConstructorOptions {
|
|
items?: Array<(TouchBarButton) | (TouchBarColorPicker) | (TouchBarGroup) | (TouchBarLabel) | (TouchBarPopover) | (TouchBarScrubber) | (TouchBarSegmentedControl) | (TouchBarSlider) | (TouchBarSpacer)>;
|
|
escapeItem?: (TouchBarButton) | (TouchBarColorPicker) | (TouchBarGroup) | (TouchBarLabel) | (TouchBarPopover) | (TouchBarScrubber) | (TouchBarSegmentedControl) | (TouchBarSlider) | (TouchBarSpacer) | (null);
|
|
}
|
|
|
|
interface TouchBarGroupConstructorOptions {
|
|
/**
|
|
* Items to display as a group.
|
|
*/
|
|
items: TouchBar;
|
|
}
|
|
|
|
interface TouchBarLabelConstructorOptions {
|
|
/**
|
|
* Text to display.
|
|
*/
|
|
label?: string;
|
|
/**
|
|
* A short description of the button for use by screenreaders like VoiceOver.
|
|
*/
|
|
accessibilityLabel?: string;
|
|
/**
|
|
* Hex color of text, i.e `#ABCDEF`.
|
|
*/
|
|
textColor?: string;
|
|
}
|
|
|
|
interface TouchBarPopoverConstructorOptions {
|
|
/**
|
|
* Popover button text.
|
|
*/
|
|
label?: string;
|
|
/**
|
|
* Popover button icon.
|
|
*/
|
|
icon?: NativeImage;
|
|
/**
|
|
* Items to display in the popover.
|
|
*/
|
|
items: TouchBar;
|
|
/**
|
|
* `true` to display a close button on the left of the popover, `false` to not show
|
|
* it. Default is `true`.
|
|
*/
|
|
showCloseButton?: boolean;
|
|
}
|
|
|
|
interface TouchBarScrubberConstructorOptions {
|
|
/**
|
|
* An array of items to place in this scrubber.
|
|
*/
|
|
items: ScrubberItem[];
|
|
/**
|
|
* Called when the user taps an item that was not the last tapped item.
|
|
*/
|
|
select?: (selectedIndex: number) => void;
|
|
/**
|
|
* Called when the user taps any item.
|
|
*/
|
|
highlight?: (highlightedIndex: number) => void;
|
|
/**
|
|
* Selected item style. Can be `background`, `outline` or `none`. Defaults to
|
|
* `none`.
|
|
*/
|
|
selectedStyle?: ('background' | 'outline' | 'none');
|
|
/**
|
|
* Selected overlay item style. Can be `background`, `outline` or `none`. Defaults
|
|
* to `none`.
|
|
*/
|
|
overlayStyle?: ('background' | 'outline' | 'none');
|
|
/**
|
|
* Whether to show arrow buttons. Defaults to `false` and is only shown if `items`
|
|
* is non-empty.
|
|
*/
|
|
showArrowButtons?: boolean;
|
|
/**
|
|
* Can be `fixed` or `free`. The default is `free`.
|
|
*/
|
|
mode?: ('fixed' | 'free');
|
|
/**
|
|
* Defaults to `true`.
|
|
*/
|
|
continuous?: boolean;
|
|
}
|
|
|
|
interface TouchBarSegmentedControlConstructorOptions {
|
|
/**
|
|
* Style of the segments:
|
|
*/
|
|
segmentStyle?: ('automatic' | 'rounded' | 'textured-rounded' | 'round-rect' | 'textured-square' | 'capsule' | 'small-square' | 'separated');
|
|
/**
|
|
* The selection mode of the control:
|
|
*/
|
|
mode?: ('single' | 'multiple' | 'buttons');
|
|
/**
|
|
* An array of segments to place in this control.
|
|
*/
|
|
segments: SegmentedControlSegment[];
|
|
/**
|
|
* The index of the currently selected segment, will update automatically with user
|
|
* interaction. When the mode is `multiple` it will be the last selected item.
|
|
*/
|
|
selectedIndex?: number;
|
|
/**
|
|
* Called when the user selects a new segment.
|
|
*/
|
|
change?: (selectedIndex: number, isSelected: boolean) => void;
|
|
}
|
|
|
|
interface TouchBarSliderConstructorOptions {
|
|
/**
|
|
* Label text.
|
|
*/
|
|
label?: string;
|
|
/**
|
|
* Selected value.
|
|
*/
|
|
value?: number;
|
|
/**
|
|
* Minimum value.
|
|
*/
|
|
minValue?: number;
|
|
/**
|
|
* Maximum value.
|
|
*/
|
|
maxValue?: number;
|
|
/**
|
|
* Function to call when the slider is changed.
|
|
*/
|
|
change?: (newValue: number) => void;
|
|
}
|
|
|
|
interface TouchBarSpacerConstructorOptions {
|
|
/**
|
|
* Size of spacer, possible values are:
|
|
*/
|
|
size?: ('small' | 'large' | 'flexible');
|
|
}
|
|
|
|
interface TraceBufferUsageReturnValue {
|
|
value: number;
|
|
percentage: number;
|
|
}
|
|
|
|
interface UpdateTargetUrlEvent extends DOMEvent {
|
|
url: string;
|
|
}
|
|
|
|
interface UploadProgress {
|
|
/**
|
|
* Whether the request is currently active. If this is false no other properties
|
|
* will be set
|
|
*/
|
|
active: boolean;
|
|
/**
|
|
* Whether the upload has started. If this is false both `current` and `total` will
|
|
* be set to 0.
|
|
*/
|
|
started: boolean;
|
|
/**
|
|
* The number of bytes that have been uploaded so far
|
|
*/
|
|
current: number;
|
|
/**
|
|
* The number of bytes that will be uploaded this request
|
|
*/
|
|
total: number;
|
|
}
|
|
|
|
interface UsbDeviceRevokedDetails {
|
|
device: USBDevice;
|
|
/**
|
|
* The origin that the device has been revoked from.
|
|
*/
|
|
origin?: string;
|
|
}
|
|
|
|
interface USBProtectedClassesHandlerHandlerDetails {
|
|
/**
|
|
* The current list of protected USB classes. Possible class values include:
|
|
*/
|
|
protectedClasses: Array<'audio' | 'audio-video' | 'hid' | 'mass-storage' | 'smart-card' | 'video' | 'wireless'>;
|
|
}
|
|
|
|
interface VisibleOnAllWorkspacesOptions {
|
|
/**
|
|
* Sets whether the window should be visible above fullscreen windows.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
visibleOnFullScreen?: boolean;
|
|
/**
|
|
* Calling setVisibleOnAllWorkspaces will by default transform the process type
|
|
* between UIElementApplication and ForegroundApplication to ensure the correct
|
|
* behavior. However, this will hide the window and dock for a short time every
|
|
* time it is called. If your window is already of type UIElementApplication, you
|
|
* can bypass this transformation by passing true to skipTransformProcessType.
|
|
*
|
|
* @platform darwin
|
|
*/
|
|
skipTransformProcessType?: boolean;
|
|
}
|
|
|
|
interface WebContentsAudioStateChangedEventParams {
|
|
/**
|
|
* True if one or more frames or child `webContents` are emitting audio.
|
|
*/
|
|
audible: boolean;
|
|
}
|
|
|
|
interface WebContentsDidRedirectNavigationEventParams {
|
|
/**
|
|
* The URL the frame is navigating to.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* Whether the navigation happened without changing document. Examples of same
|
|
* document navigations are reference fragment navigations, pushState/replaceState,
|
|
* and same page history navigation.
|
|
*/
|
|
isSameDocument: boolean;
|
|
/**
|
|
* True if the navigation is taking place in a main frame.
|
|
*/
|
|
isMainFrame: boolean;
|
|
/**
|
|
* The frame to be navigated.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The frame which initiated the navigation, which can be a parent frame (e.g. via
|
|
* `window.open` with a frame's name), or null if the navigation was not initiated
|
|
* by a frame. This can also be null if the initiating frame was deleted before the
|
|
* event was emitted.
|
|
*/
|
|
initiator?: WebFrameMain;
|
|
}
|
|
|
|
interface WebContentsDidStartNavigationEventParams {
|
|
/**
|
|
* The URL the frame is navigating to.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* Whether the navigation happened without changing document. Examples of same
|
|
* document navigations are reference fragment navigations, pushState/replaceState,
|
|
* and same page history navigation.
|
|
*/
|
|
isSameDocument: boolean;
|
|
/**
|
|
* True if the navigation is taking place in a main frame.
|
|
*/
|
|
isMainFrame: boolean;
|
|
/**
|
|
* The frame to be navigated.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The frame which initiated the navigation, which can be a parent frame (e.g. via
|
|
* `window.open` with a frame's name), or null if the navigation was not initiated
|
|
* by a frame. This can also be null if the initiating frame was deleted before the
|
|
* event was emitted.
|
|
*/
|
|
initiator?: WebFrameMain;
|
|
}
|
|
|
|
interface WebContentsPrintOptions {
|
|
/**
|
|
* Don't ask user for print settings. Default is `false`.
|
|
*/
|
|
silent?: boolean;
|
|
/**
|
|
* Prints the background color and image of the web page. Default is `false`.
|
|
*/
|
|
printBackground?: boolean;
|
|
/**
|
|
* Set the printer device name to use. Must be the system-defined name and not the
|
|
* 'friendly' name, e.g 'Brother_QL_820NWB' and not 'Brother QL-820NWB'.
|
|
*/
|
|
deviceName?: string;
|
|
/**
|
|
* Set whether the printed web page will be in color or grayscale. Default is
|
|
* `true`.
|
|
*/
|
|
color?: boolean;
|
|
margins?: Margins;
|
|
/**
|
|
* Whether the web page should be printed in landscape mode. Default is `false`.
|
|
*/
|
|
landscape?: boolean;
|
|
/**
|
|
* The scale factor of the web page.
|
|
*/
|
|
scaleFactor?: number;
|
|
/**
|
|
* The number of pages to print per page sheet.
|
|
*/
|
|
pagesPerSheet?: number;
|
|
/**
|
|
* Whether the web page should be collated.
|
|
*/
|
|
collate?: boolean;
|
|
/**
|
|
* The number of copies of the web page to print.
|
|
*/
|
|
copies?: number;
|
|
/**
|
|
* The page range to print. On macOS, only one range is honored.
|
|
*/
|
|
pageRanges?: PageRanges[];
|
|
/**
|
|
* Set the duplex mode of the printed web page. Can be `simplex`, `shortEdge`, or
|
|
* `longEdge`.
|
|
*/
|
|
duplexMode?: ('simplex' | 'shortEdge' | 'longEdge');
|
|
dpi?: Record<string, number>;
|
|
/**
|
|
* string to be printed as page header.
|
|
*/
|
|
header?: string;
|
|
/**
|
|
* string to be printed as page footer.
|
|
*/
|
|
footer?: string;
|
|
/**
|
|
* Specify page size of the printed document. Can be `A0`, `A1`, `A2`, `A3`, `A4`,
|
|
* `A5`, `A6`, `Legal`, `Letter`, `Tabloid` or an Object containing `height` and
|
|
* `width`.
|
|
*/
|
|
pageSize?: (('A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | 'Legal' | 'Letter' | 'Tabloid')) | (Size);
|
|
}
|
|
|
|
interface WebContentsWillFrameNavigateEventParams {
|
|
/**
|
|
* The URL the frame is navigating to.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* This event does not fire for same document navigations using window.history api
|
|
* and reference fragment navigations. This property is always set to `false` for
|
|
* this event.
|
|
*/
|
|
isSameDocument: boolean;
|
|
/**
|
|
* True if the navigation is taking place in a main frame.
|
|
*/
|
|
isMainFrame: boolean;
|
|
/**
|
|
* The frame to be navigated.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The frame which initiated the navigation, which can be a parent frame (e.g. via
|
|
* `window.open` with a frame's name), or null if the navigation was not initiated
|
|
* by a frame. This can also be null if the initiating frame was deleted before the
|
|
* event was emitted.
|
|
*/
|
|
initiator?: WebFrameMain;
|
|
}
|
|
|
|
interface WebContentsWillNavigateEventParams {
|
|
/**
|
|
* The URL the frame is navigating to.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* This event does not fire for same document navigations using window.history api
|
|
* and reference fragment navigations. This property is always set to `false` for
|
|
* this event.
|
|
*/
|
|
isSameDocument: boolean;
|
|
/**
|
|
* True if the navigation is taking place in a main frame.
|
|
*/
|
|
isMainFrame: boolean;
|
|
/**
|
|
* The frame to be navigated.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The frame which initiated the navigation, which can be a parent frame (e.g. via
|
|
* `window.open` with a frame's name), or null if the navigation was not initiated
|
|
* by a frame. This can also be null if the initiating frame was deleted before the
|
|
* event was emitted.
|
|
*/
|
|
initiator?: WebFrameMain;
|
|
}
|
|
|
|
interface WebContentsWillRedirectEventParams {
|
|
/**
|
|
* The URL the frame is navigating to.
|
|
*/
|
|
url: string;
|
|
/**
|
|
* Whether the navigation happened without changing document. Examples of same
|
|
* document navigations are reference fragment navigations, pushState/replaceState,
|
|
* and same page history navigation.
|
|
*/
|
|
isSameDocument: boolean;
|
|
/**
|
|
* True if the navigation is taking place in a main frame.
|
|
*/
|
|
isMainFrame: boolean;
|
|
/**
|
|
* The frame to be navigated.
|
|
*/
|
|
frame: WebFrameMain;
|
|
/**
|
|
* The frame which initiated the navigation, which can be a parent frame (e.g. via
|
|
* `window.open` with a frame's name), or null if the navigation was not initiated
|
|
* by a frame. This can also be null if the initiating frame was deleted before the
|
|
* event was emitted.
|
|
*/
|
|
initiator?: WebFrameMain;
|
|
}
|
|
|
|
interface WebviewTagPrintOptions {
|
|
/**
|
|
* Don't ask user for print settings. Default is `false`.
|
|
*/
|
|
silent?: boolean;
|
|
/**
|
|
* Prints the background color and image of the web page. Default is `false`.
|
|
*/
|
|
printBackground?: boolean;
|
|
/**
|
|
* Set the printer device name to use. Must be the system-defined name and not the
|
|
* 'friendly' name, e.g 'Brother_QL_820NWB' and not 'Brother QL-820NWB'.
|
|
*/
|
|
deviceName?: string;
|
|
/**
|
|
* Set whether the printed web page will be in color or grayscale. Default is
|
|
* `true`.
|
|
*/
|
|
color?: boolean;
|
|
margins?: Margins;
|
|
/**
|
|
* Whether the web page should be printed in landscape mode. Default is `false`.
|
|
*/
|
|
landscape?: boolean;
|
|
/**
|
|
* The scale factor of the web page.
|
|
*/
|
|
scaleFactor?: number;
|
|
/**
|
|
* The number of pages to print per page sheet.
|
|
*/
|
|
pagesPerSheet?: number;
|
|
/**
|
|
* Whether the web page should be collated.
|
|
*/
|
|
collate?: boolean;
|
|
/**
|
|
* The number of copies of the web page to print.
|
|
*/
|
|
copies?: number;
|
|
/**
|
|
* The page range to print.
|
|
*/
|
|
pageRanges?: PageRanges[];
|
|
/**
|
|
* Set the duplex mode of the printed web page. Can be `simplex`, `shortEdge`, or
|
|
* `longEdge`.
|
|
*/
|
|
duplexMode?: ('simplex' | 'shortEdge' | 'longEdge');
|
|
dpi?: Record<string, number>;
|
|
/**
|
|
* string to be printed as page header.
|
|
*/
|
|
header?: string;
|
|
/**
|
|
* string to be printed as page footer.
|
|
*/
|
|
footer?: string;
|
|
/**
|
|
* Specify page size of the printed document. Can be `A3`, `A4`, `A5`, `Legal`,
|
|
* `Letter`, `Tabloid` or an Object containing `height` in microns.
|
|
*/
|
|
pageSize?: (('A3' | 'A4' | 'A5' | 'Legal' | 'Letter' | 'Tabloid')) | (Size);
|
|
}
|
|
|
|
interface WillFrameNavigateEvent extends DOMEvent {
|
|
url: string;
|
|
isMainFrame: boolean;
|
|
frameProcessId: number;
|
|
frameRoutingId: number;
|
|
}
|
|
|
|
interface WillNavigateEvent extends DOMEvent {
|
|
url: string;
|
|
}
|
|
|
|
interface WillResizeDetails {
|
|
/**
|
|
* The edge of the window being dragged for resizing. Can be `bottom`, `left`,
|
|
* `right`, `top-left`, `top-right`, `bottom-left` or `bottom-right`.
|
|
*/
|
|
edge: ('bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right');
|
|
}
|
|
|
|
interface EditFlags {
|
|
/**
|
|
* Whether the renderer believes it can undo.
|
|
*/
|
|
canUndo: boolean;
|
|
/**
|
|
* Whether the renderer believes it can redo.
|
|
*/
|
|
canRedo: boolean;
|
|
/**
|
|
* Whether the renderer believes it can cut.
|
|
*/
|
|
canCut: boolean;
|
|
/**
|
|
* Whether the renderer believes it can copy.
|
|
*/
|
|
canCopy: boolean;
|
|
/**
|
|
* Whether the renderer believes it can paste.
|
|
*/
|
|
canPaste: boolean;
|
|
/**
|
|
* Whether the renderer believes it can delete.
|
|
*/
|
|
canDelete: boolean;
|
|
/**
|
|
* Whether the renderer believes it can select all.
|
|
*/
|
|
canSelectAll: boolean;
|
|
/**
|
|
* Whether the renderer believes it can edit text richly.
|
|
*/
|
|
canEditRichly: boolean;
|
|
}
|
|
|
|
interface Env {
|
|
}
|
|
|
|
interface FoundInPageResult {
|
|
requestId: number;
|
|
/**
|
|
* Position of the active match.
|
|
*/
|
|
activeMatchOrdinal: number;
|
|
/**
|
|
* Number of Matches.
|
|
*/
|
|
matches: number;
|
|
/**
|
|
* Coordinates of first match region.
|
|
*/
|
|
selectionArea: Rectangle;
|
|
finalUpdate: boolean;
|
|
}
|
|
|
|
interface LaunchItems {
|
|
/**
|
|
* name value of a registry entry.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
name: string;
|
|
/**
|
|
* The executable to an app that corresponds to a registry entry.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
path: string;
|
|
/**
|
|
* the command-line arguments to pass to the executable.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
args: string[];
|
|
/**
|
|
* one of `user` or `machine`. Indicates whether the registry entry is under
|
|
* `HKEY_CURRENT USER` or `HKEY_LOCAL_MACHINE`.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
scope: string;
|
|
/**
|
|
* `true` if the app registry key is startup approved and therefore shows as
|
|
* `enabled` in Task Manager and Windows settings.
|
|
*
|
|
* @platform win32
|
|
*/
|
|
enabled: boolean;
|
|
}
|
|
|
|
interface Margins {
|
|
/**
|
|
* Can be `default`, `none`, `printableArea`, or `custom`. If `custom` is chosen,
|
|
* you will also need to specify `top`, `bottom`, `left`, and `right`.
|
|
*/
|
|
marginType?: ('default' | 'none' | 'printableArea' | 'custom');
|
|
/**
|
|
* The top margin of the printed web page, in pixels.
|
|
*/
|
|
top?: number;
|
|
/**
|
|
* The bottom margin of the printed web page, in pixels.
|
|
*/
|
|
bottom?: number;
|
|
/**
|
|
* The left margin of the printed web page, in pixels.
|
|
*/
|
|
left?: number;
|
|
/**
|
|
* The right margin of the printed web page, in pixels.
|
|
*/
|
|
right?: number;
|
|
}
|
|
|
|
interface MediaFlags {
|
|
/**
|
|
* Whether the media element has crashed.
|
|
*/
|
|
inError: boolean;
|
|
/**
|
|
* Whether the media element is paused.
|
|
*/
|
|
isPaused: boolean;
|
|
/**
|
|
* Whether the media element is muted.
|
|
*/
|
|
isMuted: boolean;
|
|
/**
|
|
* Whether the media element has audio.
|
|
*/
|
|
hasAudio: boolean;
|
|
/**
|
|
* Whether the media element is looping.
|
|
*/
|
|
isLooping: boolean;
|
|
/**
|
|
* Whether the media element's controls are visible.
|
|
*/
|
|
isControlsVisible: boolean;
|
|
/**
|
|
* Whether the media element's controls are toggleable.
|
|
*/
|
|
canToggleControls: boolean;
|
|
/**
|
|
* Whether the media element can be printed.
|
|
*/
|
|
canPrint: boolean;
|
|
/**
|
|
* Whether or not the media element can be downloaded.
|
|
*/
|
|
canSave: boolean;
|
|
/**
|
|
* Whether the media element can show picture-in-picture.
|
|
*/
|
|
canShowPictureInPicture: boolean;
|
|
/**
|
|
* Whether the media element is currently showing picture-in-picture.
|
|
*/
|
|
isShowingPictureInPicture: boolean;
|
|
/**
|
|
* Whether the media element can be rotated.
|
|
*/
|
|
canRotate: boolean;
|
|
/**
|
|
* Whether the media element can be looped.
|
|
*/
|
|
canLoop: boolean;
|
|
}
|
|
|
|
interface PageRanges {
|
|
/**
|
|
* Index of the first page to print (0-based).
|
|
*/
|
|
from: number;
|
|
/**
|
|
* Index of the last page to print (inclusive) (0-based).
|
|
*/
|
|
to: number;
|
|
}
|
|
|
|
interface Params {
|
|
/**
|
|
* x coordinate.
|
|
*/
|
|
x: number;
|
|
/**
|
|
* y coordinate.
|
|
*/
|
|
y: number;
|
|
/**
|
|
* URL of the link that encloses the node the context menu was invoked on.
|
|
*/
|
|
linkURL: string;
|
|
/**
|
|
* Text associated with the link. May be an empty string if the contents of the
|
|
* link are an image.
|
|
*/
|
|
linkText: string;
|
|
/**
|
|
* URL of the top level page that the context menu was invoked on.
|
|
*/
|
|
pageURL: string;
|
|
/**
|
|
* URL of the subframe that the context menu was invoked on.
|
|
*/
|
|
frameURL: string;
|
|
/**
|
|
* Source URL for the element that the context menu was invoked on. Elements with
|
|
* source URLs are images, audio and video.
|
|
*/
|
|
srcURL: string;
|
|
/**
|
|
* Type of the node the context menu was invoked on. Can be `none`, `image`,
|
|
* `audio`, `video`, `canvas`, `file` or `plugin`.
|
|
*/
|
|
mediaType: ('none' | 'image' | 'audio' | 'video' | 'canvas' | 'file' | 'plugin');
|
|
/**
|
|
* Whether the context menu was invoked on an image which has non-empty contents.
|
|
*/
|
|
hasImageContents: boolean;
|
|
/**
|
|
* Whether the context is editable.
|
|
*/
|
|
isEditable: boolean;
|
|
/**
|
|
* Text of the selection that the context menu was invoked on.
|
|
*/
|
|
selectionText: string;
|
|
/**
|
|
* Title text of the selection that the context menu was invoked on.
|
|
*/
|
|
titleText: string;
|
|
/**
|
|
* Alt text of the selection that the context menu was invoked on.
|
|
*/
|
|
altText: string;
|
|
/**
|
|
* Suggested filename to be used when saving file through 'Save Link As' option of
|
|
* context menu.
|
|
*/
|
|
suggestedFilename: string;
|
|
/**
|
|
* Rect representing the coordinates in the document space of the selection.
|
|
*/
|
|
selectionRect: Rectangle;
|
|
/**
|
|
* Start position of the selection text.
|
|
*/
|
|
selectionStartOffset: number;
|
|
/**
|
|
* The referrer policy of the frame on which the menu is invoked.
|
|
*/
|
|
referrerPolicy: Referrer;
|
|
/**
|
|
* The misspelled word under the cursor, if any.
|
|
*/
|
|
misspelledWord: string;
|
|
/**
|
|
* An array of suggested words to show the user to replace the `misspelledWord`.
|
|
* Only available if there is a misspelled word and spellchecker is enabled.
|
|
*/
|
|
dictionarySuggestions: string[];
|
|
/**
|
|
* The character encoding of the frame on which the menu was invoked.
|
|
*/
|
|
frameCharset: string;
|
|
/**
|
|
* If the context menu was invoked on an input field, the type of that field.
|
|
* Possible values include `none`, `plainText`, `password`, `other`.
|
|
*/
|
|
inputFieldType: ('none' | 'plainText' | 'password' | 'other');
|
|
/**
|
|
* If the context is editable, whether or not spellchecking is enabled.
|
|
*/
|
|
spellcheckEnabled: boolean;
|
|
/**
|
|
* Input source that invoked the context menu. Can be `none`, `mouse`, `keyboard`,
|
|
* `touch`, `touchMenu`, `longPress`, `longTap`, `touchHandle`, `stylus`,
|
|
* `adjustSelection`, or `adjustSelectionReset`.
|
|
*/
|
|
menuSourceType: ('none' | 'mouse' | 'keyboard' | 'touch' | 'touchMenu' | 'longPress' | 'longTap' | 'touchHandle' | 'stylus' | 'adjustSelection' | 'adjustSelectionReset');
|
|
/**
|
|
* The flags for the media element the context menu was invoked on.
|
|
*/
|
|
mediaFlags: MediaFlags;
|
|
/**
|
|
* These flags indicate whether the renderer believes it is able to perform the
|
|
* corresponding action.
|
|
*/
|
|
editFlags: EditFlags;
|
|
}
|
|
|
|
interface Video {
|
|
/**
|
|
* The id of the stream being granted. This will usually come from a
|
|
* DesktopCapturerSource object.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* The name of the stream being granted. This will usually come from a
|
|
* DesktopCapturerSource object.
|
|
*/
|
|
name: string;
|
|
}
|
|
|
|
interface RemoteMainInterface {
|
|
app: App;
|
|
autoUpdater: AutoUpdater;
|
|
BrowserView: typeof BrowserView;
|
|
BrowserWindow: typeof BrowserWindow;
|
|
clipboard: Clipboard;
|
|
contentTracing: ContentTracing;
|
|
crashReporter: CrashReporter;
|
|
desktopCapturer: DesktopCapturer;
|
|
dialog: Dialog;
|
|
globalShortcut: GlobalShortcut;
|
|
inAppPurchase: InAppPurchase;
|
|
ipcMain: IpcMain;
|
|
Menu: typeof Menu;
|
|
MenuItem: typeof MenuItem;
|
|
MessageChannelMain: typeof MessageChannelMain;
|
|
nativeImage: typeof NativeImage;
|
|
nativeTheme: NativeTheme;
|
|
net: Net;
|
|
netLog: NetLog;
|
|
Notification: typeof Notification;
|
|
powerMonitor: PowerMonitor;
|
|
powerSaveBlocker: PowerSaveBlocker;
|
|
protocol: Protocol;
|
|
pushNotifications: PushNotifications;
|
|
safeStorage: SafeStorage;
|
|
screen: Screen;
|
|
session: typeof Session;
|
|
ShareMenu: typeof ShareMenu;
|
|
shell: Shell;
|
|
systemPreferences: SystemPreferences;
|
|
TouchBar: typeof TouchBar;
|
|
Tray: typeof Tray;
|
|
utilityProcess: typeof UtilityProcess;
|
|
webContents: typeof WebContents;
|
|
webFrameMain: typeof WebFrameMain;
|
|
}
|
|
|
|
|
|
|
|
namespace Common {
|
|
type Event<Params extends object = {}> = Electron.Event<Params>;
|
|
const clipboard: Clipboard;
|
|
type Clipboard = Electron.Clipboard;
|
|
const crashReporter: CrashReporter;
|
|
type CrashReporter = Electron.CrashReporter;
|
|
const nativeImage: typeof NativeImage;
|
|
type NativeImage = Electron.NativeImage;
|
|
const shell: Shell;
|
|
type Shell = Electron.Shell;
|
|
type AboutPanelOptionsOptions = Electron.AboutPanelOptionsOptions;
|
|
type AddRepresentationOptions = Electron.AddRepresentationOptions;
|
|
type AdjustSelectionOptions = Electron.AdjustSelectionOptions;
|
|
type AnimationSettings = Electron.AnimationSettings;
|
|
type AppDetailsOptions = Electron.AppDetailsOptions;
|
|
type ApplicationInfoForProtocolReturnValue = Electron.ApplicationInfoForProtocolReturnValue;
|
|
type AuthenticationResponseDetails = Electron.AuthenticationResponseDetails;
|
|
type AuthInfo = Electron.AuthInfo;
|
|
type AutoResizeOptions = Electron.AutoResizeOptions;
|
|
type BeforeSendResponse = Electron.BeforeSendResponse;
|
|
type BitmapOptions = Electron.BitmapOptions;
|
|
type BlinkMemoryInfo = Electron.BlinkMemoryInfo;
|
|
type BluetoothPairingHandlerHandlerDetails = Electron.BluetoothPairingHandlerHandlerDetails;
|
|
type BrowserViewConstructorOptions = Electron.BrowserViewConstructorOptions;
|
|
type CallbackResponse = Electron.CallbackResponse;
|
|
type CertificateTrustDialogOptions = Electron.CertificateTrustDialogOptions;
|
|
type ClearCodeCachesOptions = Electron.ClearCodeCachesOptions;
|
|
type ClearStorageDataOptions = Electron.ClearStorageDataOptions;
|
|
type ClientRequestConstructorOptions = Electron.ClientRequestConstructorOptions;
|
|
type CloseOpts = Electron.CloseOpts;
|
|
type Config = Electron.Config;
|
|
type ConfigureHostResolverOptions = Electron.ConfigureHostResolverOptions;
|
|
type ConsoleMessageEvent = Electron.ConsoleMessageEvent;
|
|
type ContextMenuEvent = Electron.ContextMenuEvent;
|
|
type ContextMenuParams = Electron.ContextMenuParams;
|
|
type ContinueActivityDetails = Electron.ContinueActivityDetails;
|
|
type CookiesGetFilter = Electron.CookiesGetFilter;
|
|
type CookiesSetDetails = Electron.CookiesSetDetails;
|
|
type CrashReporterStartOptions = Electron.CrashReporterStartOptions;
|
|
type CreateFromBitmapOptions = Electron.CreateFromBitmapOptions;
|
|
type CreateFromBufferOptions = Electron.CreateFromBufferOptions;
|
|
type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
|
|
type Data = Electron.Data;
|
|
type DefaultFontFamily = Electron.DefaultFontFamily;
|
|
type Details = Electron.Details;
|
|
type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
|
|
type DevtoolsOpenUrlEvent = Electron.DevtoolsOpenUrlEvent;
|
|
type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
|
|
type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
|
|
type DidFailLoadEvent = Electron.DidFailLoadEvent;
|
|
type DidFrameFinishLoadEvent = Electron.DidFrameFinishLoadEvent;
|
|
type DidFrameNavigateEvent = Electron.DidFrameNavigateEvent;
|
|
type DidNavigateEvent = Electron.DidNavigateEvent;
|
|
type DidNavigateInPageEvent = Electron.DidNavigateInPageEvent;
|
|
type DidRedirectNavigationEvent = Electron.DidRedirectNavigationEvent;
|
|
type DidStartNavigationEvent = Electron.DidStartNavigationEvent;
|
|
type DisplayBalloonOptions = Electron.DisplayBalloonOptions;
|
|
type DisplayMediaRequestHandlerHandlerRequest = Electron.DisplayMediaRequestHandlerHandlerRequest;
|
|
type DownloadURLOptions = Electron.DownloadURLOptions;
|
|
type EnableNetworkEmulationOptions = Electron.EnableNetworkEmulationOptions;
|
|
type FeedURLOptions = Electron.FeedURLOptions;
|
|
type FileIconOptions = Electron.FileIconOptions;
|
|
type FindInPageOptions = Electron.FindInPageOptions;
|
|
type FocusOptions = Electron.FocusOptions;
|
|
type ForkOptions = Electron.ForkOptions;
|
|
type FoundInPageEvent = Electron.FoundInPageEvent;
|
|
type FrameCreatedDetails = Electron.FrameCreatedDetails;
|
|
type FromPartitionOptions = Electron.FromPartitionOptions;
|
|
type FromPathOptions = Electron.FromPathOptions;
|
|
type HandlerDetails = Electron.HandlerDetails;
|
|
type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
|
|
type HeapStatistics = Electron.HeapStatistics;
|
|
type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
|
|
type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
|
|
type HidDeviceRevokedDetails = Electron.HidDeviceRevokedDetails;
|
|
type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
|
|
type ImportCertificateOptions = Electron.ImportCertificateOptions;
|
|
type Info = Electron.Info;
|
|
type Input = Electron.Input;
|
|
type InsertCSSOptions = Electron.InsertCSSOptions;
|
|
type IpcMessageEvent = Electron.IpcMessageEvent;
|
|
type Item = Electron.Item;
|
|
type JumpListSettings = Electron.JumpListSettings;
|
|
type LoadCommitEvent = Electron.LoadCommitEvent;
|
|
type LoadExtensionOptions = Electron.LoadExtensionOptions;
|
|
type LoadFileOptions = Electron.LoadFileOptions;
|
|
type LoadURLOptions = Electron.LoadURLOptions;
|
|
type LoginItemSettings = Electron.LoginItemSettings;
|
|
type LoginItemSettingsOptions = Electron.LoginItemSettingsOptions;
|
|
type MenuItemConstructorOptions = Electron.MenuItemConstructorOptions;
|
|
type MessageBoxOptions = Electron.MessageBoxOptions;
|
|
type MessageBoxReturnValue = Electron.MessageBoxReturnValue;
|
|
type MessageBoxSyncOptions = Electron.MessageBoxSyncOptions;
|
|
type MessageDetails = Electron.MessageDetails;
|
|
type MessageEvent = Electron.MessageEvent;
|
|
type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
|
|
type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
|
|
type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
|
|
type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
|
|
type OnBeforeSendHeadersListenerDetails = Electron.OnBeforeSendHeadersListenerDetails;
|
|
type OnCompletedListenerDetails = Electron.OnCompletedListenerDetails;
|
|
type OnErrorOccurredListenerDetails = Electron.OnErrorOccurredListenerDetails;
|
|
type OnHeadersReceivedListenerDetails = Electron.OnHeadersReceivedListenerDetails;
|
|
type OnResponseStartedListenerDetails = Electron.OnResponseStartedListenerDetails;
|
|
type OnSendHeadersListenerDetails = Electron.OnSendHeadersListenerDetails;
|
|
type OpenDevToolsOptions = Electron.OpenDevToolsOptions;
|
|
type OpenDialogOptions = Electron.OpenDialogOptions;
|
|
type OpenDialogReturnValue = Electron.OpenDialogReturnValue;
|
|
type OpenDialogSyncOptions = Electron.OpenDialogSyncOptions;
|
|
type OpenExternalOptions = Electron.OpenExternalOptions;
|
|
type Options = Electron.Options;
|
|
type Opts = Electron.Opts;
|
|
type PageFaviconUpdatedEvent = Electron.PageFaviconUpdatedEvent;
|
|
type PageTitleUpdatedEvent = Electron.PageTitleUpdatedEvent;
|
|
type Parameters = Electron.Parameters;
|
|
type Payment = Electron.Payment;
|
|
type PermissionCheckHandlerHandlerDetails = Electron.PermissionCheckHandlerHandlerDetails;
|
|
type PermissionRequestHandlerHandlerDetails = Electron.PermissionRequestHandlerHandlerDetails;
|
|
type PluginCrashedEvent = Electron.PluginCrashedEvent;
|
|
type PopupOptions = Electron.PopupOptions;
|
|
type PreconnectOptions = Electron.PreconnectOptions;
|
|
type PrintToPDFOptions = Electron.PrintToPDFOptions;
|
|
type Privileges = Electron.Privileges;
|
|
type ProgressBarOptions = Electron.ProgressBarOptions;
|
|
type Provider = Electron.Provider;
|
|
type PurchaseProductOpts = Electron.PurchaseProductOpts;
|
|
type ReadBookmark = Electron.ReadBookmark;
|
|
type RegistrationCompletedDetails = Electron.RegistrationCompletedDetails;
|
|
type RelaunchOptions = Electron.RelaunchOptions;
|
|
type RenderProcessGoneEvent = Electron.RenderProcessGoneEvent;
|
|
type Request = Electron.Request;
|
|
type ResizeOptions = Electron.ResizeOptions;
|
|
type ResolveHostOptions = Electron.ResolveHostOptions;
|
|
type ResourceUsage = Electron.ResourceUsage;
|
|
type Response = Electron.Response;
|
|
type Result = Electron.Result;
|
|
type SaveDialogOptions = Electron.SaveDialogOptions;
|
|
type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
|
|
type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
|
|
type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
|
|
type SelectUsbDeviceDetails = Electron.SelectUsbDeviceDetails;
|
|
type SerialPortRevokedDetails = Electron.SerialPortRevokedDetails;
|
|
type Settings = Electron.Settings;
|
|
type SourcesOptions = Electron.SourcesOptions;
|
|
type SSLConfigConfig = Electron.SSLConfigConfig;
|
|
type StartLoggingOptions = Electron.StartLoggingOptions;
|
|
type Streams = Electron.Streams;
|
|
type SystemMemoryInfo = Electron.SystemMemoryInfo;
|
|
type TitleBarOverlay = Electron.TitleBarOverlay;
|
|
type TitleBarOverlayOptions = Electron.TitleBarOverlayOptions;
|
|
type TitleOptions = Electron.TitleOptions;
|
|
type ToBitmapOptions = Electron.ToBitmapOptions;
|
|
type ToDataURLOptions = Electron.ToDataURLOptions;
|
|
type ToPNGOptions = Electron.ToPNGOptions;
|
|
type TouchBarButtonConstructorOptions = Electron.TouchBarButtonConstructorOptions;
|
|
type TouchBarColorPickerConstructorOptions = Electron.TouchBarColorPickerConstructorOptions;
|
|
type TouchBarConstructorOptions = Electron.TouchBarConstructorOptions;
|
|
type TouchBarGroupConstructorOptions = Electron.TouchBarGroupConstructorOptions;
|
|
type TouchBarLabelConstructorOptions = Electron.TouchBarLabelConstructorOptions;
|
|
type TouchBarPopoverConstructorOptions = Electron.TouchBarPopoverConstructorOptions;
|
|
type TouchBarScrubberConstructorOptions = Electron.TouchBarScrubberConstructorOptions;
|
|
type TouchBarSegmentedControlConstructorOptions = Electron.TouchBarSegmentedControlConstructorOptions;
|
|
type TouchBarSliderConstructorOptions = Electron.TouchBarSliderConstructorOptions;
|
|
type TouchBarSpacerConstructorOptions = Electron.TouchBarSpacerConstructorOptions;
|
|
type TraceBufferUsageReturnValue = Electron.TraceBufferUsageReturnValue;
|
|
type UpdateTargetUrlEvent = Electron.UpdateTargetUrlEvent;
|
|
type UploadProgress = Electron.UploadProgress;
|
|
type UsbDeviceRevokedDetails = Electron.UsbDeviceRevokedDetails;
|
|
type USBProtectedClassesHandlerHandlerDetails = Electron.USBProtectedClassesHandlerHandlerDetails;
|
|
type VisibleOnAllWorkspacesOptions = Electron.VisibleOnAllWorkspacesOptions;
|
|
type WebContentsAudioStateChangedEventParams = Electron.WebContentsAudioStateChangedEventParams;
|
|
type WebContentsDidRedirectNavigationEventParams = Electron.WebContentsDidRedirectNavigationEventParams;
|
|
type WebContentsDidStartNavigationEventParams = Electron.WebContentsDidStartNavigationEventParams;
|
|
type WebContentsPrintOptions = Electron.WebContentsPrintOptions;
|
|
type WebContentsWillFrameNavigateEventParams = Electron.WebContentsWillFrameNavigateEventParams;
|
|
type WebContentsWillNavigateEventParams = Electron.WebContentsWillNavigateEventParams;
|
|
type WebContentsWillRedirectEventParams = Electron.WebContentsWillRedirectEventParams;
|
|
type WebviewTagPrintOptions = Electron.WebviewTagPrintOptions;
|
|
type WillFrameNavigateEvent = Electron.WillFrameNavigateEvent;
|
|
type WillNavigateEvent = Electron.WillNavigateEvent;
|
|
type WillResizeDetails = Electron.WillResizeDetails;
|
|
type EditFlags = Electron.EditFlags;
|
|
type Env = Electron.Env;
|
|
type FoundInPageResult = Electron.FoundInPageResult;
|
|
type LaunchItems = Electron.LaunchItems;
|
|
type Margins = Electron.Margins;
|
|
type MediaFlags = Electron.MediaFlags;
|
|
type PageRanges = Electron.PageRanges;
|
|
type Params = Electron.Params;
|
|
type Video = Electron.Video;
|
|
type BluetoothDevice = Electron.BluetoothDevice;
|
|
type BrowserWindowConstructorOptions = Electron.BrowserWindowConstructorOptions;
|
|
type Certificate = Electron.Certificate;
|
|
type CertificatePrincipal = Electron.CertificatePrincipal;
|
|
type Cookie = Electron.Cookie;
|
|
type CPUUsage = Electron.CPUUsage;
|
|
type CrashReport = Electron.CrashReport;
|
|
type CustomScheme = Electron.CustomScheme;
|
|
type DesktopCapturerSource = Electron.DesktopCapturerSource;
|
|
type Display = Electron.Display;
|
|
type Extension = Electron.Extension;
|
|
type ExtensionInfo = Electron.ExtensionInfo;
|
|
type FileFilter = Electron.FileFilter;
|
|
type FilePathWithHeaders = Electron.FilePathWithHeaders;
|
|
type GPUFeatureStatus = Electron.GPUFeatureStatus;
|
|
type HIDDevice = Electron.HIDDevice;
|
|
type InputEvent = Electron.InputEvent;
|
|
type IOCounters = Electron.IOCounters;
|
|
type IpcMainEvent = Electron.IpcMainEvent;
|
|
type IpcMainInvokeEvent = Electron.IpcMainInvokeEvent;
|
|
type IpcRendererEvent = Electron.IpcRendererEvent;
|
|
type JumpListCategory = Electron.JumpListCategory;
|
|
type JumpListItem = Electron.JumpListItem;
|
|
type KeyboardEvent = Electron.KeyboardEvent;
|
|
type KeyboardInputEvent = Electron.KeyboardInputEvent;
|
|
type MemoryInfo = Electron.MemoryInfo;
|
|
type MemoryUsageDetails = Electron.MemoryUsageDetails;
|
|
type MimeTypedBuffer = Electron.MimeTypedBuffer;
|
|
type MouseInputEvent = Electron.MouseInputEvent;
|
|
type MouseWheelInputEvent = Electron.MouseWheelInputEvent;
|
|
type NotificationAction = Electron.NotificationAction;
|
|
type NotificationResponse = Electron.NotificationResponse;
|
|
type PaymentDiscount = Electron.PaymentDiscount;
|
|
type Point = Electron.Point;
|
|
type PostBody = Electron.PostBody;
|
|
type PrinterInfo = Electron.PrinterInfo;
|
|
type ProcessMemoryInfo = Electron.ProcessMemoryInfo;
|
|
type ProcessMetric = Electron.ProcessMetric;
|
|
type Product = Electron.Product;
|
|
type ProductDiscount = Electron.ProductDiscount;
|
|
type ProductSubscriptionPeriod = Electron.ProductSubscriptionPeriod;
|
|
type ProtocolRequest = Electron.ProtocolRequest;
|
|
type ProtocolResponse = Electron.ProtocolResponse;
|
|
type ProtocolResponseUploadData = Electron.ProtocolResponseUploadData;
|
|
type Rectangle = Electron.Rectangle;
|
|
type Referrer = Electron.Referrer;
|
|
type RenderProcessGoneDetails = Electron.RenderProcessGoneDetails;
|
|
type ResolvedEndpoint = Electron.ResolvedEndpoint;
|
|
type ResolvedHost = Electron.ResolvedHost;
|
|
type ScrubberItem = Electron.ScrubberItem;
|
|
type SegmentedControlSegment = Electron.SegmentedControlSegment;
|
|
type SerialPort = Electron.SerialPort;
|
|
type ServiceWorkerInfo = Electron.ServiceWorkerInfo;
|
|
type SharedWorkerInfo = Electron.SharedWorkerInfo;
|
|
type SharingItem = Electron.SharingItem;
|
|
type ShortcutDetails = Electron.ShortcutDetails;
|
|
type Size = Electron.Size;
|
|
type Task = Electron.Task;
|
|
type ThumbarButton = Electron.ThumbarButton;
|
|
type TraceCategoriesAndOptions = Electron.TraceCategoriesAndOptions;
|
|
type TraceConfig = Electron.TraceConfig;
|
|
type Transaction = Electron.Transaction;
|
|
type UploadData = Electron.UploadData;
|
|
type UploadFile = Electron.UploadFile;
|
|
type UploadRawData = Electron.UploadRawData;
|
|
type USBDevice = Electron.USBDevice;
|
|
type UserDefaultTypes = Electron.UserDefaultTypes;
|
|
type WebPreferences = Electron.WebPreferences;
|
|
type WebRequestFilter = Electron.WebRequestFilter;
|
|
type WebSource = Electron.WebSource;
|
|
}
|
|
|
|
namespace Main {
|
|
type Event<Params extends object = {}> = Electron.Event<Params>;
|
|
const app: App;
|
|
type App = Electron.App;
|
|
const autoUpdater: AutoUpdater;
|
|
type AutoUpdater = Electron.AutoUpdater;
|
|
class BrowserView extends Electron.BrowserView {}
|
|
class BrowserWindow extends Electron.BrowserWindow {}
|
|
type ClientRequest = Electron.ClientRequest;
|
|
type CommandLine = Electron.CommandLine;
|
|
const contentTracing: ContentTracing;
|
|
type ContentTracing = Electron.ContentTracing;
|
|
type Cookies = Electron.Cookies;
|
|
type Debugger = Electron.Debugger;
|
|
const desktopCapturer: DesktopCapturer;
|
|
type DesktopCapturer = Electron.DesktopCapturer;
|
|
const dialog: Dialog;
|
|
type Dialog = Electron.Dialog;
|
|
type Dock = Electron.Dock;
|
|
type DownloadItem = Electron.DownloadItem;
|
|
const globalShortcut: GlobalShortcut;
|
|
type GlobalShortcut = Electron.GlobalShortcut;
|
|
const inAppPurchase: InAppPurchase;
|
|
type InAppPurchase = Electron.InAppPurchase;
|
|
type IncomingMessage = Electron.IncomingMessage;
|
|
const ipcMain: IpcMain;
|
|
type IpcMain = Electron.IpcMain;
|
|
class Menu extends Electron.Menu {}
|
|
class MenuItem extends Electron.MenuItem {}
|
|
class MessageChannelMain extends Electron.MessageChannelMain {}
|
|
type MessagePortMain = Electron.MessagePortMain;
|
|
const nativeTheme: NativeTheme;
|
|
type NativeTheme = Electron.NativeTheme;
|
|
const net: Net;
|
|
type Net = Electron.Net;
|
|
const netLog: NetLog;
|
|
type NetLog = Electron.NetLog;
|
|
class Notification extends Electron.Notification {}
|
|
const powerMonitor: PowerMonitor;
|
|
type PowerMonitor = Electron.PowerMonitor;
|
|
const powerSaveBlocker: PowerSaveBlocker;
|
|
type PowerSaveBlocker = Electron.PowerSaveBlocker;
|
|
const protocol: Protocol;
|
|
type Protocol = Electron.Protocol;
|
|
const pushNotifications: PushNotifications;
|
|
type PushNotifications = Electron.PushNotifications;
|
|
const safeStorage: SafeStorage;
|
|
type SafeStorage = Electron.SafeStorage;
|
|
const screen: Screen;
|
|
type Screen = Electron.Screen;
|
|
type ServiceWorkers = Electron.ServiceWorkers;
|
|
const session: typeof Session;
|
|
type Session = Electron.Session;
|
|
class ShareMenu extends Electron.ShareMenu {}
|
|
const systemPreferences: SystemPreferences;
|
|
type SystemPreferences = Electron.SystemPreferences;
|
|
class TouchBar extends Electron.TouchBar {}
|
|
type TouchBarButton = Electron.TouchBarButton;
|
|
type TouchBarColorPicker = Electron.TouchBarColorPicker;
|
|
type TouchBarGroup = Electron.TouchBarGroup;
|
|
type TouchBarLabel = Electron.TouchBarLabel;
|
|
type TouchBarOtherItemsProxy = Electron.TouchBarOtherItemsProxy;
|
|
type TouchBarPopover = Electron.TouchBarPopover;
|
|
type TouchBarScrubber = Electron.TouchBarScrubber;
|
|
type TouchBarSegmentedControl = Electron.TouchBarSegmentedControl;
|
|
type TouchBarSlider = Electron.TouchBarSlider;
|
|
type TouchBarSpacer = Electron.TouchBarSpacer;
|
|
class Tray extends Electron.Tray {}
|
|
const utilityProcess: typeof UtilityProcess;
|
|
type UtilityProcess = Electron.UtilityProcess;
|
|
const webContents: typeof WebContents;
|
|
type WebContents = Electron.WebContents;
|
|
const webFrameMain: typeof WebFrameMain;
|
|
type WebFrameMain = Electron.WebFrameMain;
|
|
type WebRequest = Electron.WebRequest;
|
|
type AboutPanelOptionsOptions = Electron.AboutPanelOptionsOptions;
|
|
type AddRepresentationOptions = Electron.AddRepresentationOptions;
|
|
type AdjustSelectionOptions = Electron.AdjustSelectionOptions;
|
|
type AnimationSettings = Electron.AnimationSettings;
|
|
type AppDetailsOptions = Electron.AppDetailsOptions;
|
|
type ApplicationInfoForProtocolReturnValue = Electron.ApplicationInfoForProtocolReturnValue;
|
|
type AuthenticationResponseDetails = Electron.AuthenticationResponseDetails;
|
|
type AuthInfo = Electron.AuthInfo;
|
|
type AutoResizeOptions = Electron.AutoResizeOptions;
|
|
type BeforeSendResponse = Electron.BeforeSendResponse;
|
|
type BitmapOptions = Electron.BitmapOptions;
|
|
type BlinkMemoryInfo = Electron.BlinkMemoryInfo;
|
|
type BluetoothPairingHandlerHandlerDetails = Electron.BluetoothPairingHandlerHandlerDetails;
|
|
type BrowserViewConstructorOptions = Electron.BrowserViewConstructorOptions;
|
|
type CallbackResponse = Electron.CallbackResponse;
|
|
type CertificateTrustDialogOptions = Electron.CertificateTrustDialogOptions;
|
|
type ClearCodeCachesOptions = Electron.ClearCodeCachesOptions;
|
|
type ClearStorageDataOptions = Electron.ClearStorageDataOptions;
|
|
type ClientRequestConstructorOptions = Electron.ClientRequestConstructorOptions;
|
|
type CloseOpts = Electron.CloseOpts;
|
|
type Config = Electron.Config;
|
|
type ConfigureHostResolverOptions = Electron.ConfigureHostResolverOptions;
|
|
type ConsoleMessageEvent = Electron.ConsoleMessageEvent;
|
|
type ContextMenuEvent = Electron.ContextMenuEvent;
|
|
type ContextMenuParams = Electron.ContextMenuParams;
|
|
type ContinueActivityDetails = Electron.ContinueActivityDetails;
|
|
type CookiesGetFilter = Electron.CookiesGetFilter;
|
|
type CookiesSetDetails = Electron.CookiesSetDetails;
|
|
type CrashReporterStartOptions = Electron.CrashReporterStartOptions;
|
|
type CreateFromBitmapOptions = Electron.CreateFromBitmapOptions;
|
|
type CreateFromBufferOptions = Electron.CreateFromBufferOptions;
|
|
type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
|
|
type Data = Electron.Data;
|
|
type DefaultFontFamily = Electron.DefaultFontFamily;
|
|
type Details = Electron.Details;
|
|
type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
|
|
type DevtoolsOpenUrlEvent = Electron.DevtoolsOpenUrlEvent;
|
|
type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
|
|
type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
|
|
type DidFailLoadEvent = Electron.DidFailLoadEvent;
|
|
type DidFrameFinishLoadEvent = Electron.DidFrameFinishLoadEvent;
|
|
type DidFrameNavigateEvent = Electron.DidFrameNavigateEvent;
|
|
type DidNavigateEvent = Electron.DidNavigateEvent;
|
|
type DidNavigateInPageEvent = Electron.DidNavigateInPageEvent;
|
|
type DidRedirectNavigationEvent = Electron.DidRedirectNavigationEvent;
|
|
type DidStartNavigationEvent = Electron.DidStartNavigationEvent;
|
|
type DisplayBalloonOptions = Electron.DisplayBalloonOptions;
|
|
type DisplayMediaRequestHandlerHandlerRequest = Electron.DisplayMediaRequestHandlerHandlerRequest;
|
|
type DownloadURLOptions = Electron.DownloadURLOptions;
|
|
type EnableNetworkEmulationOptions = Electron.EnableNetworkEmulationOptions;
|
|
type FeedURLOptions = Electron.FeedURLOptions;
|
|
type FileIconOptions = Electron.FileIconOptions;
|
|
type FindInPageOptions = Electron.FindInPageOptions;
|
|
type FocusOptions = Electron.FocusOptions;
|
|
type ForkOptions = Electron.ForkOptions;
|
|
type FoundInPageEvent = Electron.FoundInPageEvent;
|
|
type FrameCreatedDetails = Electron.FrameCreatedDetails;
|
|
type FromPartitionOptions = Electron.FromPartitionOptions;
|
|
type FromPathOptions = Electron.FromPathOptions;
|
|
type HandlerDetails = Electron.HandlerDetails;
|
|
type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
|
|
type HeapStatistics = Electron.HeapStatistics;
|
|
type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
|
|
type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
|
|
type HidDeviceRevokedDetails = Electron.HidDeviceRevokedDetails;
|
|
type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
|
|
type ImportCertificateOptions = Electron.ImportCertificateOptions;
|
|
type Info = Electron.Info;
|
|
type Input = Electron.Input;
|
|
type InsertCSSOptions = Electron.InsertCSSOptions;
|
|
type IpcMessageEvent = Electron.IpcMessageEvent;
|
|
type Item = Electron.Item;
|
|
type JumpListSettings = Electron.JumpListSettings;
|
|
type LoadCommitEvent = Electron.LoadCommitEvent;
|
|
type LoadExtensionOptions = Electron.LoadExtensionOptions;
|
|
type LoadFileOptions = Electron.LoadFileOptions;
|
|
type LoadURLOptions = Electron.LoadURLOptions;
|
|
type LoginItemSettings = Electron.LoginItemSettings;
|
|
type LoginItemSettingsOptions = Electron.LoginItemSettingsOptions;
|
|
type MenuItemConstructorOptions = Electron.MenuItemConstructorOptions;
|
|
type MessageBoxOptions = Electron.MessageBoxOptions;
|
|
type MessageBoxReturnValue = Electron.MessageBoxReturnValue;
|
|
type MessageBoxSyncOptions = Electron.MessageBoxSyncOptions;
|
|
type MessageDetails = Electron.MessageDetails;
|
|
type MessageEvent = Electron.MessageEvent;
|
|
type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
|
|
type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
|
|
type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
|
|
type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
|
|
type OnBeforeSendHeadersListenerDetails = Electron.OnBeforeSendHeadersListenerDetails;
|
|
type OnCompletedListenerDetails = Electron.OnCompletedListenerDetails;
|
|
type OnErrorOccurredListenerDetails = Electron.OnErrorOccurredListenerDetails;
|
|
type OnHeadersReceivedListenerDetails = Electron.OnHeadersReceivedListenerDetails;
|
|
type OnResponseStartedListenerDetails = Electron.OnResponseStartedListenerDetails;
|
|
type OnSendHeadersListenerDetails = Electron.OnSendHeadersListenerDetails;
|
|
type OpenDevToolsOptions = Electron.OpenDevToolsOptions;
|
|
type OpenDialogOptions = Electron.OpenDialogOptions;
|
|
type OpenDialogReturnValue = Electron.OpenDialogReturnValue;
|
|
type OpenDialogSyncOptions = Electron.OpenDialogSyncOptions;
|
|
type OpenExternalOptions = Electron.OpenExternalOptions;
|
|
type Options = Electron.Options;
|
|
type Opts = Electron.Opts;
|
|
type PageFaviconUpdatedEvent = Electron.PageFaviconUpdatedEvent;
|
|
type PageTitleUpdatedEvent = Electron.PageTitleUpdatedEvent;
|
|
type Parameters = Electron.Parameters;
|
|
type Payment = Electron.Payment;
|
|
type PermissionCheckHandlerHandlerDetails = Electron.PermissionCheckHandlerHandlerDetails;
|
|
type PermissionRequestHandlerHandlerDetails = Electron.PermissionRequestHandlerHandlerDetails;
|
|
type PluginCrashedEvent = Electron.PluginCrashedEvent;
|
|
type PopupOptions = Electron.PopupOptions;
|
|
type PreconnectOptions = Electron.PreconnectOptions;
|
|
type PrintToPDFOptions = Electron.PrintToPDFOptions;
|
|
type Privileges = Electron.Privileges;
|
|
type ProgressBarOptions = Electron.ProgressBarOptions;
|
|
type Provider = Electron.Provider;
|
|
type PurchaseProductOpts = Electron.PurchaseProductOpts;
|
|
type ReadBookmark = Electron.ReadBookmark;
|
|
type RegistrationCompletedDetails = Electron.RegistrationCompletedDetails;
|
|
type RelaunchOptions = Electron.RelaunchOptions;
|
|
type RenderProcessGoneEvent = Electron.RenderProcessGoneEvent;
|
|
type Request = Electron.Request;
|
|
type ResizeOptions = Electron.ResizeOptions;
|
|
type ResolveHostOptions = Electron.ResolveHostOptions;
|
|
type ResourceUsage = Electron.ResourceUsage;
|
|
type Response = Electron.Response;
|
|
type Result = Electron.Result;
|
|
type SaveDialogOptions = Electron.SaveDialogOptions;
|
|
type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
|
|
type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
|
|
type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
|
|
type SelectUsbDeviceDetails = Electron.SelectUsbDeviceDetails;
|
|
type SerialPortRevokedDetails = Electron.SerialPortRevokedDetails;
|
|
type Settings = Electron.Settings;
|
|
type SourcesOptions = Electron.SourcesOptions;
|
|
type SSLConfigConfig = Electron.SSLConfigConfig;
|
|
type StartLoggingOptions = Electron.StartLoggingOptions;
|
|
type Streams = Electron.Streams;
|
|
type SystemMemoryInfo = Electron.SystemMemoryInfo;
|
|
type TitleBarOverlay = Electron.TitleBarOverlay;
|
|
type TitleBarOverlayOptions = Electron.TitleBarOverlayOptions;
|
|
type TitleOptions = Electron.TitleOptions;
|
|
type ToBitmapOptions = Electron.ToBitmapOptions;
|
|
type ToDataURLOptions = Electron.ToDataURLOptions;
|
|
type ToPNGOptions = Electron.ToPNGOptions;
|
|
type TouchBarButtonConstructorOptions = Electron.TouchBarButtonConstructorOptions;
|
|
type TouchBarColorPickerConstructorOptions = Electron.TouchBarColorPickerConstructorOptions;
|
|
type TouchBarConstructorOptions = Electron.TouchBarConstructorOptions;
|
|
type TouchBarGroupConstructorOptions = Electron.TouchBarGroupConstructorOptions;
|
|
type TouchBarLabelConstructorOptions = Electron.TouchBarLabelConstructorOptions;
|
|
type TouchBarPopoverConstructorOptions = Electron.TouchBarPopoverConstructorOptions;
|
|
type TouchBarScrubberConstructorOptions = Electron.TouchBarScrubberConstructorOptions;
|
|
type TouchBarSegmentedControlConstructorOptions = Electron.TouchBarSegmentedControlConstructorOptions;
|
|
type TouchBarSliderConstructorOptions = Electron.TouchBarSliderConstructorOptions;
|
|
type TouchBarSpacerConstructorOptions = Electron.TouchBarSpacerConstructorOptions;
|
|
type TraceBufferUsageReturnValue = Electron.TraceBufferUsageReturnValue;
|
|
type UpdateTargetUrlEvent = Electron.UpdateTargetUrlEvent;
|
|
type UploadProgress = Electron.UploadProgress;
|
|
type UsbDeviceRevokedDetails = Electron.UsbDeviceRevokedDetails;
|
|
type USBProtectedClassesHandlerHandlerDetails = Electron.USBProtectedClassesHandlerHandlerDetails;
|
|
type VisibleOnAllWorkspacesOptions = Electron.VisibleOnAllWorkspacesOptions;
|
|
type WebContentsAudioStateChangedEventParams = Electron.WebContentsAudioStateChangedEventParams;
|
|
type WebContentsDidRedirectNavigationEventParams = Electron.WebContentsDidRedirectNavigationEventParams;
|
|
type WebContentsDidStartNavigationEventParams = Electron.WebContentsDidStartNavigationEventParams;
|
|
type WebContentsPrintOptions = Electron.WebContentsPrintOptions;
|
|
type WebContentsWillFrameNavigateEventParams = Electron.WebContentsWillFrameNavigateEventParams;
|
|
type WebContentsWillNavigateEventParams = Electron.WebContentsWillNavigateEventParams;
|
|
type WebContentsWillRedirectEventParams = Electron.WebContentsWillRedirectEventParams;
|
|
type WebviewTagPrintOptions = Electron.WebviewTagPrintOptions;
|
|
type WillFrameNavigateEvent = Electron.WillFrameNavigateEvent;
|
|
type WillNavigateEvent = Electron.WillNavigateEvent;
|
|
type WillResizeDetails = Electron.WillResizeDetails;
|
|
type EditFlags = Electron.EditFlags;
|
|
type Env = Electron.Env;
|
|
type FoundInPageResult = Electron.FoundInPageResult;
|
|
type LaunchItems = Electron.LaunchItems;
|
|
type Margins = Electron.Margins;
|
|
type MediaFlags = Electron.MediaFlags;
|
|
type PageRanges = Electron.PageRanges;
|
|
type Params = Electron.Params;
|
|
type Video = Electron.Video;
|
|
type BluetoothDevice = Electron.BluetoothDevice;
|
|
type BrowserWindowConstructorOptions = Electron.BrowserWindowConstructorOptions;
|
|
type Certificate = Electron.Certificate;
|
|
type CertificatePrincipal = Electron.CertificatePrincipal;
|
|
type Cookie = Electron.Cookie;
|
|
type CPUUsage = Electron.CPUUsage;
|
|
type CrashReport = Electron.CrashReport;
|
|
type CustomScheme = Electron.CustomScheme;
|
|
type DesktopCapturerSource = Electron.DesktopCapturerSource;
|
|
type Display = Electron.Display;
|
|
type Extension = Electron.Extension;
|
|
type ExtensionInfo = Electron.ExtensionInfo;
|
|
type FileFilter = Electron.FileFilter;
|
|
type FilePathWithHeaders = Electron.FilePathWithHeaders;
|
|
type GPUFeatureStatus = Electron.GPUFeatureStatus;
|
|
type HIDDevice = Electron.HIDDevice;
|
|
type InputEvent = Electron.InputEvent;
|
|
type IOCounters = Electron.IOCounters;
|
|
type IpcMainEvent = Electron.IpcMainEvent;
|
|
type IpcMainInvokeEvent = Electron.IpcMainInvokeEvent;
|
|
type IpcRendererEvent = Electron.IpcRendererEvent;
|
|
type JumpListCategory = Electron.JumpListCategory;
|
|
type JumpListItem = Electron.JumpListItem;
|
|
type KeyboardEvent = Electron.KeyboardEvent;
|
|
type KeyboardInputEvent = Electron.KeyboardInputEvent;
|
|
type MemoryInfo = Electron.MemoryInfo;
|
|
type MemoryUsageDetails = Electron.MemoryUsageDetails;
|
|
type MimeTypedBuffer = Electron.MimeTypedBuffer;
|
|
type MouseInputEvent = Electron.MouseInputEvent;
|
|
type MouseWheelInputEvent = Electron.MouseWheelInputEvent;
|
|
type NotificationAction = Electron.NotificationAction;
|
|
type NotificationResponse = Electron.NotificationResponse;
|
|
type PaymentDiscount = Electron.PaymentDiscount;
|
|
type Point = Electron.Point;
|
|
type PostBody = Electron.PostBody;
|
|
type PrinterInfo = Electron.PrinterInfo;
|
|
type ProcessMemoryInfo = Electron.ProcessMemoryInfo;
|
|
type ProcessMetric = Electron.ProcessMetric;
|
|
type Product = Electron.Product;
|
|
type ProductDiscount = Electron.ProductDiscount;
|
|
type ProductSubscriptionPeriod = Electron.ProductSubscriptionPeriod;
|
|
type ProtocolRequest = Electron.ProtocolRequest;
|
|
type ProtocolResponse = Electron.ProtocolResponse;
|
|
type ProtocolResponseUploadData = Electron.ProtocolResponseUploadData;
|
|
type Rectangle = Electron.Rectangle;
|
|
type Referrer = Electron.Referrer;
|
|
type RenderProcessGoneDetails = Electron.RenderProcessGoneDetails;
|
|
type ResolvedEndpoint = Electron.ResolvedEndpoint;
|
|
type ResolvedHost = Electron.ResolvedHost;
|
|
type ScrubberItem = Electron.ScrubberItem;
|
|
type SegmentedControlSegment = Electron.SegmentedControlSegment;
|
|
type SerialPort = Electron.SerialPort;
|
|
type ServiceWorkerInfo = Electron.ServiceWorkerInfo;
|
|
type SharedWorkerInfo = Electron.SharedWorkerInfo;
|
|
type SharingItem = Electron.SharingItem;
|
|
type ShortcutDetails = Electron.ShortcutDetails;
|
|
type Size = Electron.Size;
|
|
type Task = Electron.Task;
|
|
type ThumbarButton = Electron.ThumbarButton;
|
|
type TraceCategoriesAndOptions = Electron.TraceCategoriesAndOptions;
|
|
type TraceConfig = Electron.TraceConfig;
|
|
type Transaction = Electron.Transaction;
|
|
type UploadData = Electron.UploadData;
|
|
type UploadFile = Electron.UploadFile;
|
|
type UploadRawData = Electron.UploadRawData;
|
|
type USBDevice = Electron.USBDevice;
|
|
type UserDefaultTypes = Electron.UserDefaultTypes;
|
|
type WebPreferences = Electron.WebPreferences;
|
|
type WebRequestFilter = Electron.WebRequestFilter;
|
|
type WebSource = Electron.WebSource;
|
|
}
|
|
|
|
namespace Renderer {
|
|
type Event<Params extends object = {}> = Electron.Event<Params>;
|
|
const contextBridge: ContextBridge;
|
|
type ContextBridge = Electron.ContextBridge;
|
|
const ipcRenderer: IpcRenderer;
|
|
type IpcRenderer = Electron.IpcRenderer;
|
|
const webFrame: WebFrame;
|
|
type WebFrame = Electron.WebFrame;
|
|
type WebviewTag = Electron.WebviewTag;
|
|
type AboutPanelOptionsOptions = Electron.AboutPanelOptionsOptions;
|
|
type AddRepresentationOptions = Electron.AddRepresentationOptions;
|
|
type AdjustSelectionOptions = Electron.AdjustSelectionOptions;
|
|
type AnimationSettings = Electron.AnimationSettings;
|
|
type AppDetailsOptions = Electron.AppDetailsOptions;
|
|
type ApplicationInfoForProtocolReturnValue = Electron.ApplicationInfoForProtocolReturnValue;
|
|
type AuthenticationResponseDetails = Electron.AuthenticationResponseDetails;
|
|
type AuthInfo = Electron.AuthInfo;
|
|
type AutoResizeOptions = Electron.AutoResizeOptions;
|
|
type BeforeSendResponse = Electron.BeforeSendResponse;
|
|
type BitmapOptions = Electron.BitmapOptions;
|
|
type BlinkMemoryInfo = Electron.BlinkMemoryInfo;
|
|
type BluetoothPairingHandlerHandlerDetails = Electron.BluetoothPairingHandlerHandlerDetails;
|
|
type BrowserViewConstructorOptions = Electron.BrowserViewConstructorOptions;
|
|
type CallbackResponse = Electron.CallbackResponse;
|
|
type CertificateTrustDialogOptions = Electron.CertificateTrustDialogOptions;
|
|
type ClearCodeCachesOptions = Electron.ClearCodeCachesOptions;
|
|
type ClearStorageDataOptions = Electron.ClearStorageDataOptions;
|
|
type ClientRequestConstructorOptions = Electron.ClientRequestConstructorOptions;
|
|
type CloseOpts = Electron.CloseOpts;
|
|
type Config = Electron.Config;
|
|
type ConfigureHostResolverOptions = Electron.ConfigureHostResolverOptions;
|
|
type ConsoleMessageEvent = Electron.ConsoleMessageEvent;
|
|
type ContextMenuEvent = Electron.ContextMenuEvent;
|
|
type ContextMenuParams = Electron.ContextMenuParams;
|
|
type ContinueActivityDetails = Electron.ContinueActivityDetails;
|
|
type CookiesGetFilter = Electron.CookiesGetFilter;
|
|
type CookiesSetDetails = Electron.CookiesSetDetails;
|
|
type CrashReporterStartOptions = Electron.CrashReporterStartOptions;
|
|
type CreateFromBitmapOptions = Electron.CreateFromBitmapOptions;
|
|
type CreateFromBufferOptions = Electron.CreateFromBufferOptions;
|
|
type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
|
|
type Data = Electron.Data;
|
|
type DefaultFontFamily = Electron.DefaultFontFamily;
|
|
type Details = Electron.Details;
|
|
type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
|
|
type DevtoolsOpenUrlEvent = Electron.DevtoolsOpenUrlEvent;
|
|
type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
|
|
type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
|
|
type DidFailLoadEvent = Electron.DidFailLoadEvent;
|
|
type DidFrameFinishLoadEvent = Electron.DidFrameFinishLoadEvent;
|
|
type DidFrameNavigateEvent = Electron.DidFrameNavigateEvent;
|
|
type DidNavigateEvent = Electron.DidNavigateEvent;
|
|
type DidNavigateInPageEvent = Electron.DidNavigateInPageEvent;
|
|
type DidRedirectNavigationEvent = Electron.DidRedirectNavigationEvent;
|
|
type DidStartNavigationEvent = Electron.DidStartNavigationEvent;
|
|
type DisplayBalloonOptions = Electron.DisplayBalloonOptions;
|
|
type DisplayMediaRequestHandlerHandlerRequest = Electron.DisplayMediaRequestHandlerHandlerRequest;
|
|
type DownloadURLOptions = Electron.DownloadURLOptions;
|
|
type EnableNetworkEmulationOptions = Electron.EnableNetworkEmulationOptions;
|
|
type FeedURLOptions = Electron.FeedURLOptions;
|
|
type FileIconOptions = Electron.FileIconOptions;
|
|
type FindInPageOptions = Electron.FindInPageOptions;
|
|
type FocusOptions = Electron.FocusOptions;
|
|
type ForkOptions = Electron.ForkOptions;
|
|
type FoundInPageEvent = Electron.FoundInPageEvent;
|
|
type FrameCreatedDetails = Electron.FrameCreatedDetails;
|
|
type FromPartitionOptions = Electron.FromPartitionOptions;
|
|
type FromPathOptions = Electron.FromPathOptions;
|
|
type HandlerDetails = Electron.HandlerDetails;
|
|
type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
|
|
type HeapStatistics = Electron.HeapStatistics;
|
|
type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
|
|
type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
|
|
type HidDeviceRevokedDetails = Electron.HidDeviceRevokedDetails;
|
|
type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
|
|
type ImportCertificateOptions = Electron.ImportCertificateOptions;
|
|
type Info = Electron.Info;
|
|
type Input = Electron.Input;
|
|
type InsertCSSOptions = Electron.InsertCSSOptions;
|
|
type IpcMessageEvent = Electron.IpcMessageEvent;
|
|
type Item = Electron.Item;
|
|
type JumpListSettings = Electron.JumpListSettings;
|
|
type LoadCommitEvent = Electron.LoadCommitEvent;
|
|
type LoadExtensionOptions = Electron.LoadExtensionOptions;
|
|
type LoadFileOptions = Electron.LoadFileOptions;
|
|
type LoadURLOptions = Electron.LoadURLOptions;
|
|
type LoginItemSettings = Electron.LoginItemSettings;
|
|
type LoginItemSettingsOptions = Electron.LoginItemSettingsOptions;
|
|
type MenuItemConstructorOptions = Electron.MenuItemConstructorOptions;
|
|
type MessageBoxOptions = Electron.MessageBoxOptions;
|
|
type MessageBoxReturnValue = Electron.MessageBoxReturnValue;
|
|
type MessageBoxSyncOptions = Electron.MessageBoxSyncOptions;
|
|
type MessageDetails = Electron.MessageDetails;
|
|
type MessageEvent = Electron.MessageEvent;
|
|
type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
|
|
type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
|
|
type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
|
|
type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
|
|
type OnBeforeSendHeadersListenerDetails = Electron.OnBeforeSendHeadersListenerDetails;
|
|
type OnCompletedListenerDetails = Electron.OnCompletedListenerDetails;
|
|
type OnErrorOccurredListenerDetails = Electron.OnErrorOccurredListenerDetails;
|
|
type OnHeadersReceivedListenerDetails = Electron.OnHeadersReceivedListenerDetails;
|
|
type OnResponseStartedListenerDetails = Electron.OnResponseStartedListenerDetails;
|
|
type OnSendHeadersListenerDetails = Electron.OnSendHeadersListenerDetails;
|
|
type OpenDevToolsOptions = Electron.OpenDevToolsOptions;
|
|
type OpenDialogOptions = Electron.OpenDialogOptions;
|
|
type OpenDialogReturnValue = Electron.OpenDialogReturnValue;
|
|
type OpenDialogSyncOptions = Electron.OpenDialogSyncOptions;
|
|
type OpenExternalOptions = Electron.OpenExternalOptions;
|
|
type Options = Electron.Options;
|
|
type Opts = Electron.Opts;
|
|
type PageFaviconUpdatedEvent = Electron.PageFaviconUpdatedEvent;
|
|
type PageTitleUpdatedEvent = Electron.PageTitleUpdatedEvent;
|
|
type Parameters = Electron.Parameters;
|
|
type Payment = Electron.Payment;
|
|
type PermissionCheckHandlerHandlerDetails = Electron.PermissionCheckHandlerHandlerDetails;
|
|
type PermissionRequestHandlerHandlerDetails = Electron.PermissionRequestHandlerHandlerDetails;
|
|
type PluginCrashedEvent = Electron.PluginCrashedEvent;
|
|
type PopupOptions = Electron.PopupOptions;
|
|
type PreconnectOptions = Electron.PreconnectOptions;
|
|
type PrintToPDFOptions = Electron.PrintToPDFOptions;
|
|
type Privileges = Electron.Privileges;
|
|
type ProgressBarOptions = Electron.ProgressBarOptions;
|
|
type Provider = Electron.Provider;
|
|
type PurchaseProductOpts = Electron.PurchaseProductOpts;
|
|
type ReadBookmark = Electron.ReadBookmark;
|
|
type RegistrationCompletedDetails = Electron.RegistrationCompletedDetails;
|
|
type RelaunchOptions = Electron.RelaunchOptions;
|
|
type RenderProcessGoneEvent = Electron.RenderProcessGoneEvent;
|
|
type Request = Electron.Request;
|
|
type ResizeOptions = Electron.ResizeOptions;
|
|
type ResolveHostOptions = Electron.ResolveHostOptions;
|
|
type ResourceUsage = Electron.ResourceUsage;
|
|
type Response = Electron.Response;
|
|
type Result = Electron.Result;
|
|
type SaveDialogOptions = Electron.SaveDialogOptions;
|
|
type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
|
|
type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
|
|
type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
|
|
type SelectUsbDeviceDetails = Electron.SelectUsbDeviceDetails;
|
|
type SerialPortRevokedDetails = Electron.SerialPortRevokedDetails;
|
|
type Settings = Electron.Settings;
|
|
type SourcesOptions = Electron.SourcesOptions;
|
|
type SSLConfigConfig = Electron.SSLConfigConfig;
|
|
type StartLoggingOptions = Electron.StartLoggingOptions;
|
|
type Streams = Electron.Streams;
|
|
type SystemMemoryInfo = Electron.SystemMemoryInfo;
|
|
type TitleBarOverlay = Electron.TitleBarOverlay;
|
|
type TitleBarOverlayOptions = Electron.TitleBarOverlayOptions;
|
|
type TitleOptions = Electron.TitleOptions;
|
|
type ToBitmapOptions = Electron.ToBitmapOptions;
|
|
type ToDataURLOptions = Electron.ToDataURLOptions;
|
|
type ToPNGOptions = Electron.ToPNGOptions;
|
|
type TouchBarButtonConstructorOptions = Electron.TouchBarButtonConstructorOptions;
|
|
type TouchBarColorPickerConstructorOptions = Electron.TouchBarColorPickerConstructorOptions;
|
|
type TouchBarConstructorOptions = Electron.TouchBarConstructorOptions;
|
|
type TouchBarGroupConstructorOptions = Electron.TouchBarGroupConstructorOptions;
|
|
type TouchBarLabelConstructorOptions = Electron.TouchBarLabelConstructorOptions;
|
|
type TouchBarPopoverConstructorOptions = Electron.TouchBarPopoverConstructorOptions;
|
|
type TouchBarScrubberConstructorOptions = Electron.TouchBarScrubberConstructorOptions;
|
|
type TouchBarSegmentedControlConstructorOptions = Electron.TouchBarSegmentedControlConstructorOptions;
|
|
type TouchBarSliderConstructorOptions = Electron.TouchBarSliderConstructorOptions;
|
|
type TouchBarSpacerConstructorOptions = Electron.TouchBarSpacerConstructorOptions;
|
|
type TraceBufferUsageReturnValue = Electron.TraceBufferUsageReturnValue;
|
|
type UpdateTargetUrlEvent = Electron.UpdateTargetUrlEvent;
|
|
type UploadProgress = Electron.UploadProgress;
|
|
type UsbDeviceRevokedDetails = Electron.UsbDeviceRevokedDetails;
|
|
type USBProtectedClassesHandlerHandlerDetails = Electron.USBProtectedClassesHandlerHandlerDetails;
|
|
type VisibleOnAllWorkspacesOptions = Electron.VisibleOnAllWorkspacesOptions;
|
|
type WebContentsAudioStateChangedEventParams = Electron.WebContentsAudioStateChangedEventParams;
|
|
type WebContentsDidRedirectNavigationEventParams = Electron.WebContentsDidRedirectNavigationEventParams;
|
|
type WebContentsDidStartNavigationEventParams = Electron.WebContentsDidStartNavigationEventParams;
|
|
type WebContentsPrintOptions = Electron.WebContentsPrintOptions;
|
|
type WebContentsWillFrameNavigateEventParams = Electron.WebContentsWillFrameNavigateEventParams;
|
|
type WebContentsWillNavigateEventParams = Electron.WebContentsWillNavigateEventParams;
|
|
type WebContentsWillRedirectEventParams = Electron.WebContentsWillRedirectEventParams;
|
|
type WebviewTagPrintOptions = Electron.WebviewTagPrintOptions;
|
|
type WillFrameNavigateEvent = Electron.WillFrameNavigateEvent;
|
|
type WillNavigateEvent = Electron.WillNavigateEvent;
|
|
type WillResizeDetails = Electron.WillResizeDetails;
|
|
type EditFlags = Electron.EditFlags;
|
|
type Env = Electron.Env;
|
|
type FoundInPageResult = Electron.FoundInPageResult;
|
|
type LaunchItems = Electron.LaunchItems;
|
|
type Margins = Electron.Margins;
|
|
type MediaFlags = Electron.MediaFlags;
|
|
type PageRanges = Electron.PageRanges;
|
|
type Params = Electron.Params;
|
|
type Video = Electron.Video;
|
|
type BluetoothDevice = Electron.BluetoothDevice;
|
|
type BrowserWindowConstructorOptions = Electron.BrowserWindowConstructorOptions;
|
|
type Certificate = Electron.Certificate;
|
|
type CertificatePrincipal = Electron.CertificatePrincipal;
|
|
type Cookie = Electron.Cookie;
|
|
type CPUUsage = Electron.CPUUsage;
|
|
type CrashReport = Electron.CrashReport;
|
|
type CustomScheme = Electron.CustomScheme;
|
|
type DesktopCapturerSource = Electron.DesktopCapturerSource;
|
|
type Display = Electron.Display;
|
|
type Extension = Electron.Extension;
|
|
type ExtensionInfo = Electron.ExtensionInfo;
|
|
type FileFilter = Electron.FileFilter;
|
|
type FilePathWithHeaders = Electron.FilePathWithHeaders;
|
|
type GPUFeatureStatus = Electron.GPUFeatureStatus;
|
|
type HIDDevice = Electron.HIDDevice;
|
|
type InputEvent = Electron.InputEvent;
|
|
type IOCounters = Electron.IOCounters;
|
|
type IpcMainEvent = Electron.IpcMainEvent;
|
|
type IpcMainInvokeEvent = Electron.IpcMainInvokeEvent;
|
|
type IpcRendererEvent = Electron.IpcRendererEvent;
|
|
type JumpListCategory = Electron.JumpListCategory;
|
|
type JumpListItem = Electron.JumpListItem;
|
|
type KeyboardEvent = Electron.KeyboardEvent;
|
|
type KeyboardInputEvent = Electron.KeyboardInputEvent;
|
|
type MemoryInfo = Electron.MemoryInfo;
|
|
type MemoryUsageDetails = Electron.MemoryUsageDetails;
|
|
type MimeTypedBuffer = Electron.MimeTypedBuffer;
|
|
type MouseInputEvent = Electron.MouseInputEvent;
|
|
type MouseWheelInputEvent = Electron.MouseWheelInputEvent;
|
|
type NotificationAction = Electron.NotificationAction;
|
|
type NotificationResponse = Electron.NotificationResponse;
|
|
type PaymentDiscount = Electron.PaymentDiscount;
|
|
type Point = Electron.Point;
|
|
type PostBody = Electron.PostBody;
|
|
type PrinterInfo = Electron.PrinterInfo;
|
|
type ProcessMemoryInfo = Electron.ProcessMemoryInfo;
|
|
type ProcessMetric = Electron.ProcessMetric;
|
|
type Product = Electron.Product;
|
|
type ProductDiscount = Electron.ProductDiscount;
|
|
type ProductSubscriptionPeriod = Electron.ProductSubscriptionPeriod;
|
|
type ProtocolRequest = Electron.ProtocolRequest;
|
|
type ProtocolResponse = Electron.ProtocolResponse;
|
|
type ProtocolResponseUploadData = Electron.ProtocolResponseUploadData;
|
|
type Rectangle = Electron.Rectangle;
|
|
type Referrer = Electron.Referrer;
|
|
type RenderProcessGoneDetails = Electron.RenderProcessGoneDetails;
|
|
type ResolvedEndpoint = Electron.ResolvedEndpoint;
|
|
type ResolvedHost = Electron.ResolvedHost;
|
|
type ScrubberItem = Electron.ScrubberItem;
|
|
type SegmentedControlSegment = Electron.SegmentedControlSegment;
|
|
type SerialPort = Electron.SerialPort;
|
|
type ServiceWorkerInfo = Electron.ServiceWorkerInfo;
|
|
type SharedWorkerInfo = Electron.SharedWorkerInfo;
|
|
type SharingItem = Electron.SharingItem;
|
|
type ShortcutDetails = Electron.ShortcutDetails;
|
|
type Size = Electron.Size;
|
|
type Task = Electron.Task;
|
|
type ThumbarButton = Electron.ThumbarButton;
|
|
type TraceCategoriesAndOptions = Electron.TraceCategoriesAndOptions;
|
|
type TraceConfig = Electron.TraceConfig;
|
|
type Transaction = Electron.Transaction;
|
|
type UploadData = Electron.UploadData;
|
|
type UploadFile = Electron.UploadFile;
|
|
type UploadRawData = Electron.UploadRawData;
|
|
type USBDevice = Electron.USBDevice;
|
|
type UserDefaultTypes = Electron.UserDefaultTypes;
|
|
type WebPreferences = Electron.WebPreferences;
|
|
type WebRequestFilter = Electron.WebRequestFilter;
|
|
type WebSource = Electron.WebSource;
|
|
}
|
|
|
|
namespace CrossProcessExports {
|
|
type Event<Params extends object = {}> = Electron.Event<Params>;
|
|
const app: App;
|
|
type App = Electron.App;
|
|
const autoUpdater: AutoUpdater;
|
|
type AutoUpdater = Electron.AutoUpdater;
|
|
class BrowserView extends Electron.BrowserView {}
|
|
class BrowserWindow extends Electron.BrowserWindow {}
|
|
type ClientRequest = Electron.ClientRequest;
|
|
const clipboard: Clipboard;
|
|
type Clipboard = Electron.Clipboard;
|
|
type CommandLine = Electron.CommandLine;
|
|
const contentTracing: ContentTracing;
|
|
type ContentTracing = Electron.ContentTracing;
|
|
const contextBridge: ContextBridge;
|
|
type ContextBridge = Electron.ContextBridge;
|
|
type Cookies = Electron.Cookies;
|
|
const crashReporter: CrashReporter;
|
|
type CrashReporter = Electron.CrashReporter;
|
|
type Debugger = Electron.Debugger;
|
|
const desktopCapturer: DesktopCapturer;
|
|
type DesktopCapturer = Electron.DesktopCapturer;
|
|
const dialog: Dialog;
|
|
type Dialog = Electron.Dialog;
|
|
type Dock = Electron.Dock;
|
|
type DownloadItem = Electron.DownloadItem;
|
|
const globalShortcut: GlobalShortcut;
|
|
type GlobalShortcut = Electron.GlobalShortcut;
|
|
const inAppPurchase: InAppPurchase;
|
|
type InAppPurchase = Electron.InAppPurchase;
|
|
type IncomingMessage = Electron.IncomingMessage;
|
|
const ipcMain: IpcMain;
|
|
type IpcMain = Electron.IpcMain;
|
|
const ipcRenderer: IpcRenderer;
|
|
type IpcRenderer = Electron.IpcRenderer;
|
|
class Menu extends Electron.Menu {}
|
|
class MenuItem extends Electron.MenuItem {}
|
|
class MessageChannelMain extends Electron.MessageChannelMain {}
|
|
type MessagePortMain = Electron.MessagePortMain;
|
|
const nativeImage: typeof NativeImage;
|
|
type NativeImage = Electron.NativeImage;
|
|
const nativeTheme: NativeTheme;
|
|
type NativeTheme = Electron.NativeTheme;
|
|
const net: Net;
|
|
type Net = Electron.Net;
|
|
const netLog: NetLog;
|
|
type NetLog = Electron.NetLog;
|
|
class Notification extends Electron.Notification {}
|
|
const powerMonitor: PowerMonitor;
|
|
type PowerMonitor = Electron.PowerMonitor;
|
|
const powerSaveBlocker: PowerSaveBlocker;
|
|
type PowerSaveBlocker = Electron.PowerSaveBlocker;
|
|
const protocol: Protocol;
|
|
type Protocol = Electron.Protocol;
|
|
const pushNotifications: PushNotifications;
|
|
type PushNotifications = Electron.PushNotifications;
|
|
const safeStorage: SafeStorage;
|
|
type SafeStorage = Electron.SafeStorage;
|
|
const screen: Screen;
|
|
type Screen = Electron.Screen;
|
|
type ServiceWorkers = Electron.ServiceWorkers;
|
|
const session: typeof Session;
|
|
type Session = Electron.Session;
|
|
class ShareMenu extends Electron.ShareMenu {}
|
|
const shell: Shell;
|
|
type Shell = Electron.Shell;
|
|
const systemPreferences: SystemPreferences;
|
|
type SystemPreferences = Electron.SystemPreferences;
|
|
class TouchBar extends Electron.TouchBar {}
|
|
type TouchBarButton = Electron.TouchBarButton;
|
|
type TouchBarColorPicker = Electron.TouchBarColorPicker;
|
|
type TouchBarGroup = Electron.TouchBarGroup;
|
|
type TouchBarLabel = Electron.TouchBarLabel;
|
|
type TouchBarOtherItemsProxy = Electron.TouchBarOtherItemsProxy;
|
|
type TouchBarPopover = Electron.TouchBarPopover;
|
|
type TouchBarScrubber = Electron.TouchBarScrubber;
|
|
type TouchBarSegmentedControl = Electron.TouchBarSegmentedControl;
|
|
type TouchBarSlider = Electron.TouchBarSlider;
|
|
type TouchBarSpacer = Electron.TouchBarSpacer;
|
|
class Tray extends Electron.Tray {}
|
|
const utilityProcess: typeof UtilityProcess;
|
|
type UtilityProcess = Electron.UtilityProcess;
|
|
const webContents: typeof WebContents;
|
|
type WebContents = Electron.WebContents;
|
|
const webFrame: WebFrame;
|
|
type WebFrame = Electron.WebFrame;
|
|
const webFrameMain: typeof WebFrameMain;
|
|
type WebFrameMain = Electron.WebFrameMain;
|
|
type WebRequest = Electron.WebRequest;
|
|
type WebviewTag = Electron.WebviewTag;
|
|
type AboutPanelOptionsOptions = Electron.AboutPanelOptionsOptions;
|
|
type AddRepresentationOptions = Electron.AddRepresentationOptions;
|
|
type AdjustSelectionOptions = Electron.AdjustSelectionOptions;
|
|
type AnimationSettings = Electron.AnimationSettings;
|
|
type AppDetailsOptions = Electron.AppDetailsOptions;
|
|
type ApplicationInfoForProtocolReturnValue = Electron.ApplicationInfoForProtocolReturnValue;
|
|
type AuthenticationResponseDetails = Electron.AuthenticationResponseDetails;
|
|
type AuthInfo = Electron.AuthInfo;
|
|
type AutoResizeOptions = Electron.AutoResizeOptions;
|
|
type BeforeSendResponse = Electron.BeforeSendResponse;
|
|
type BitmapOptions = Electron.BitmapOptions;
|
|
type BlinkMemoryInfo = Electron.BlinkMemoryInfo;
|
|
type BluetoothPairingHandlerHandlerDetails = Electron.BluetoothPairingHandlerHandlerDetails;
|
|
type BrowserViewConstructorOptions = Electron.BrowserViewConstructorOptions;
|
|
type CallbackResponse = Electron.CallbackResponse;
|
|
type CertificateTrustDialogOptions = Electron.CertificateTrustDialogOptions;
|
|
type ClearCodeCachesOptions = Electron.ClearCodeCachesOptions;
|
|
type ClearStorageDataOptions = Electron.ClearStorageDataOptions;
|
|
type ClientRequestConstructorOptions = Electron.ClientRequestConstructorOptions;
|
|
type CloseOpts = Electron.CloseOpts;
|
|
type Config = Electron.Config;
|
|
type ConfigureHostResolverOptions = Electron.ConfigureHostResolverOptions;
|
|
type ConsoleMessageEvent = Electron.ConsoleMessageEvent;
|
|
type ContextMenuEvent = Electron.ContextMenuEvent;
|
|
type ContextMenuParams = Electron.ContextMenuParams;
|
|
type ContinueActivityDetails = Electron.ContinueActivityDetails;
|
|
type CookiesGetFilter = Electron.CookiesGetFilter;
|
|
type CookiesSetDetails = Electron.CookiesSetDetails;
|
|
type CrashReporterStartOptions = Electron.CrashReporterStartOptions;
|
|
type CreateFromBitmapOptions = Electron.CreateFromBitmapOptions;
|
|
type CreateFromBufferOptions = Electron.CreateFromBufferOptions;
|
|
type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
|
|
type Data = Electron.Data;
|
|
type DefaultFontFamily = Electron.DefaultFontFamily;
|
|
type Details = Electron.Details;
|
|
type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
|
|
type DevtoolsOpenUrlEvent = Electron.DevtoolsOpenUrlEvent;
|
|
type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
|
|
type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
|
|
type DidFailLoadEvent = Electron.DidFailLoadEvent;
|
|
type DidFrameFinishLoadEvent = Electron.DidFrameFinishLoadEvent;
|
|
type DidFrameNavigateEvent = Electron.DidFrameNavigateEvent;
|
|
type DidNavigateEvent = Electron.DidNavigateEvent;
|
|
type DidNavigateInPageEvent = Electron.DidNavigateInPageEvent;
|
|
type DidRedirectNavigationEvent = Electron.DidRedirectNavigationEvent;
|
|
type DidStartNavigationEvent = Electron.DidStartNavigationEvent;
|
|
type DisplayBalloonOptions = Electron.DisplayBalloonOptions;
|
|
type DisplayMediaRequestHandlerHandlerRequest = Electron.DisplayMediaRequestHandlerHandlerRequest;
|
|
type DownloadURLOptions = Electron.DownloadURLOptions;
|
|
type EnableNetworkEmulationOptions = Electron.EnableNetworkEmulationOptions;
|
|
type FeedURLOptions = Electron.FeedURLOptions;
|
|
type FileIconOptions = Electron.FileIconOptions;
|
|
type FindInPageOptions = Electron.FindInPageOptions;
|
|
type FocusOptions = Electron.FocusOptions;
|
|
type ForkOptions = Electron.ForkOptions;
|
|
type FoundInPageEvent = Electron.FoundInPageEvent;
|
|
type FrameCreatedDetails = Electron.FrameCreatedDetails;
|
|
type FromPartitionOptions = Electron.FromPartitionOptions;
|
|
type FromPathOptions = Electron.FromPathOptions;
|
|
type HandlerDetails = Electron.HandlerDetails;
|
|
type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
|
|
type HeapStatistics = Electron.HeapStatistics;
|
|
type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
|
|
type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
|
|
type HidDeviceRevokedDetails = Electron.HidDeviceRevokedDetails;
|
|
type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
|
|
type ImportCertificateOptions = Electron.ImportCertificateOptions;
|
|
type Info = Electron.Info;
|
|
type Input = Electron.Input;
|
|
type InsertCSSOptions = Electron.InsertCSSOptions;
|
|
type IpcMessageEvent = Electron.IpcMessageEvent;
|
|
type Item = Electron.Item;
|
|
type JumpListSettings = Electron.JumpListSettings;
|
|
type LoadCommitEvent = Electron.LoadCommitEvent;
|
|
type LoadExtensionOptions = Electron.LoadExtensionOptions;
|
|
type LoadFileOptions = Electron.LoadFileOptions;
|
|
type LoadURLOptions = Electron.LoadURLOptions;
|
|
type LoginItemSettings = Electron.LoginItemSettings;
|
|
type LoginItemSettingsOptions = Electron.LoginItemSettingsOptions;
|
|
type MenuItemConstructorOptions = Electron.MenuItemConstructorOptions;
|
|
type MessageBoxOptions = Electron.MessageBoxOptions;
|
|
type MessageBoxReturnValue = Electron.MessageBoxReturnValue;
|
|
type MessageBoxSyncOptions = Electron.MessageBoxSyncOptions;
|
|
type MessageDetails = Electron.MessageDetails;
|
|
type MessageEvent = Electron.MessageEvent;
|
|
type MoveToApplicationsFolderOptions = Electron.MoveToApplicationsFolderOptions;
|
|
type NotificationConstructorOptions = Electron.NotificationConstructorOptions;
|
|
type OnBeforeRedirectListenerDetails = Electron.OnBeforeRedirectListenerDetails;
|
|
type OnBeforeRequestListenerDetails = Electron.OnBeforeRequestListenerDetails;
|
|
type OnBeforeSendHeadersListenerDetails = Electron.OnBeforeSendHeadersListenerDetails;
|
|
type OnCompletedListenerDetails = Electron.OnCompletedListenerDetails;
|
|
type OnErrorOccurredListenerDetails = Electron.OnErrorOccurredListenerDetails;
|
|
type OnHeadersReceivedListenerDetails = Electron.OnHeadersReceivedListenerDetails;
|
|
type OnResponseStartedListenerDetails = Electron.OnResponseStartedListenerDetails;
|
|
type OnSendHeadersListenerDetails = Electron.OnSendHeadersListenerDetails;
|
|
type OpenDevToolsOptions = Electron.OpenDevToolsOptions;
|
|
type OpenDialogOptions = Electron.OpenDialogOptions;
|
|
type OpenDialogReturnValue = Electron.OpenDialogReturnValue;
|
|
type OpenDialogSyncOptions = Electron.OpenDialogSyncOptions;
|
|
type OpenExternalOptions = Electron.OpenExternalOptions;
|
|
type Options = Electron.Options;
|
|
type Opts = Electron.Opts;
|
|
type PageFaviconUpdatedEvent = Electron.PageFaviconUpdatedEvent;
|
|
type PageTitleUpdatedEvent = Electron.PageTitleUpdatedEvent;
|
|
type Parameters = Electron.Parameters;
|
|
type Payment = Electron.Payment;
|
|
type PermissionCheckHandlerHandlerDetails = Electron.PermissionCheckHandlerHandlerDetails;
|
|
type PermissionRequestHandlerHandlerDetails = Electron.PermissionRequestHandlerHandlerDetails;
|
|
type PluginCrashedEvent = Electron.PluginCrashedEvent;
|
|
type PopupOptions = Electron.PopupOptions;
|
|
type PreconnectOptions = Electron.PreconnectOptions;
|
|
type PrintToPDFOptions = Electron.PrintToPDFOptions;
|
|
type Privileges = Electron.Privileges;
|
|
type ProgressBarOptions = Electron.ProgressBarOptions;
|
|
type Provider = Electron.Provider;
|
|
type PurchaseProductOpts = Electron.PurchaseProductOpts;
|
|
type ReadBookmark = Electron.ReadBookmark;
|
|
type RegistrationCompletedDetails = Electron.RegistrationCompletedDetails;
|
|
type RelaunchOptions = Electron.RelaunchOptions;
|
|
type RenderProcessGoneEvent = Electron.RenderProcessGoneEvent;
|
|
type Request = Electron.Request;
|
|
type ResizeOptions = Electron.ResizeOptions;
|
|
type ResolveHostOptions = Electron.ResolveHostOptions;
|
|
type ResourceUsage = Electron.ResourceUsage;
|
|
type Response = Electron.Response;
|
|
type Result = Electron.Result;
|
|
type SaveDialogOptions = Electron.SaveDialogOptions;
|
|
type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
|
|
type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
|
|
type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
|
|
type SelectUsbDeviceDetails = Electron.SelectUsbDeviceDetails;
|
|
type SerialPortRevokedDetails = Electron.SerialPortRevokedDetails;
|
|
type Settings = Electron.Settings;
|
|
type SourcesOptions = Electron.SourcesOptions;
|
|
type SSLConfigConfig = Electron.SSLConfigConfig;
|
|
type StartLoggingOptions = Electron.StartLoggingOptions;
|
|
type Streams = Electron.Streams;
|
|
type SystemMemoryInfo = Electron.SystemMemoryInfo;
|
|
type TitleBarOverlay = Electron.TitleBarOverlay;
|
|
type TitleBarOverlayOptions = Electron.TitleBarOverlayOptions;
|
|
type TitleOptions = Electron.TitleOptions;
|
|
type ToBitmapOptions = Electron.ToBitmapOptions;
|
|
type ToDataURLOptions = Electron.ToDataURLOptions;
|
|
type ToPNGOptions = Electron.ToPNGOptions;
|
|
type TouchBarButtonConstructorOptions = Electron.TouchBarButtonConstructorOptions;
|
|
type TouchBarColorPickerConstructorOptions = Electron.TouchBarColorPickerConstructorOptions;
|
|
type TouchBarConstructorOptions = Electron.TouchBarConstructorOptions;
|
|
type TouchBarGroupConstructorOptions = Electron.TouchBarGroupConstructorOptions;
|
|
type TouchBarLabelConstructorOptions = Electron.TouchBarLabelConstructorOptions;
|
|
type TouchBarPopoverConstructorOptions = Electron.TouchBarPopoverConstructorOptions;
|
|
type TouchBarScrubberConstructorOptions = Electron.TouchBarScrubberConstructorOptions;
|
|
type TouchBarSegmentedControlConstructorOptions = Electron.TouchBarSegmentedControlConstructorOptions;
|
|
type TouchBarSliderConstructorOptions = Electron.TouchBarSliderConstructorOptions;
|
|
type TouchBarSpacerConstructorOptions = Electron.TouchBarSpacerConstructorOptions;
|
|
type TraceBufferUsageReturnValue = Electron.TraceBufferUsageReturnValue;
|
|
type UpdateTargetUrlEvent = Electron.UpdateTargetUrlEvent;
|
|
type UploadProgress = Electron.UploadProgress;
|
|
type UsbDeviceRevokedDetails = Electron.UsbDeviceRevokedDetails;
|
|
type USBProtectedClassesHandlerHandlerDetails = Electron.USBProtectedClassesHandlerHandlerDetails;
|
|
type VisibleOnAllWorkspacesOptions = Electron.VisibleOnAllWorkspacesOptions;
|
|
type WebContentsAudioStateChangedEventParams = Electron.WebContentsAudioStateChangedEventParams;
|
|
type WebContentsDidRedirectNavigationEventParams = Electron.WebContentsDidRedirectNavigationEventParams;
|
|
type WebContentsDidStartNavigationEventParams = Electron.WebContentsDidStartNavigationEventParams;
|
|
type WebContentsPrintOptions = Electron.WebContentsPrintOptions;
|
|
type WebContentsWillFrameNavigateEventParams = Electron.WebContentsWillFrameNavigateEventParams;
|
|
type WebContentsWillNavigateEventParams = Electron.WebContentsWillNavigateEventParams;
|
|
type WebContentsWillRedirectEventParams = Electron.WebContentsWillRedirectEventParams;
|
|
type WebviewTagPrintOptions = Electron.WebviewTagPrintOptions;
|
|
type WillFrameNavigateEvent = Electron.WillFrameNavigateEvent;
|
|
type WillNavigateEvent = Electron.WillNavigateEvent;
|
|
type WillResizeDetails = Electron.WillResizeDetails;
|
|
type EditFlags = Electron.EditFlags;
|
|
type Env = Electron.Env;
|
|
type FoundInPageResult = Electron.FoundInPageResult;
|
|
type LaunchItems = Electron.LaunchItems;
|
|
type Margins = Electron.Margins;
|
|
type MediaFlags = Electron.MediaFlags;
|
|
type PageRanges = Electron.PageRanges;
|
|
type Params = Electron.Params;
|
|
type Video = Electron.Video;
|
|
type BluetoothDevice = Electron.BluetoothDevice;
|
|
type BrowserWindowConstructorOptions = Electron.BrowserWindowConstructorOptions;
|
|
type Certificate = Electron.Certificate;
|
|
type CertificatePrincipal = Electron.CertificatePrincipal;
|
|
type Cookie = Electron.Cookie;
|
|
type CPUUsage = Electron.CPUUsage;
|
|
type CrashReport = Electron.CrashReport;
|
|
type CustomScheme = Electron.CustomScheme;
|
|
type DesktopCapturerSource = Electron.DesktopCapturerSource;
|
|
type Display = Electron.Display;
|
|
type Extension = Electron.Extension;
|
|
type ExtensionInfo = Electron.ExtensionInfo;
|
|
type FileFilter = Electron.FileFilter;
|
|
type FilePathWithHeaders = Electron.FilePathWithHeaders;
|
|
type GPUFeatureStatus = Electron.GPUFeatureStatus;
|
|
type HIDDevice = Electron.HIDDevice;
|
|
type InputEvent = Electron.InputEvent;
|
|
type IOCounters = Electron.IOCounters;
|
|
type IpcMainEvent = Electron.IpcMainEvent;
|
|
type IpcMainInvokeEvent = Electron.IpcMainInvokeEvent;
|
|
type IpcRendererEvent = Electron.IpcRendererEvent;
|
|
type JumpListCategory = Electron.JumpListCategory;
|
|
type JumpListItem = Electron.JumpListItem;
|
|
type KeyboardEvent = Electron.KeyboardEvent;
|
|
type KeyboardInputEvent = Electron.KeyboardInputEvent;
|
|
type MemoryInfo = Electron.MemoryInfo;
|
|
type MemoryUsageDetails = Electron.MemoryUsageDetails;
|
|
type MimeTypedBuffer = Electron.MimeTypedBuffer;
|
|
type MouseInputEvent = Electron.MouseInputEvent;
|
|
type MouseWheelInputEvent = Electron.MouseWheelInputEvent;
|
|
type NotificationAction = Electron.NotificationAction;
|
|
type NotificationResponse = Electron.NotificationResponse;
|
|
type PaymentDiscount = Electron.PaymentDiscount;
|
|
type Point = Electron.Point;
|
|
type PostBody = Electron.PostBody;
|
|
type PrinterInfo = Electron.PrinterInfo;
|
|
type ProcessMemoryInfo = Electron.ProcessMemoryInfo;
|
|
type ProcessMetric = Electron.ProcessMetric;
|
|
type Product = Electron.Product;
|
|
type ProductDiscount = Electron.ProductDiscount;
|
|
type ProductSubscriptionPeriod = Electron.ProductSubscriptionPeriod;
|
|
type ProtocolRequest = Electron.ProtocolRequest;
|
|
type ProtocolResponse = Electron.ProtocolResponse;
|
|
type ProtocolResponseUploadData = Electron.ProtocolResponseUploadData;
|
|
type Rectangle = Electron.Rectangle;
|
|
type Referrer = Electron.Referrer;
|
|
type RenderProcessGoneDetails = Electron.RenderProcessGoneDetails;
|
|
type ResolvedEndpoint = Electron.ResolvedEndpoint;
|
|
type ResolvedHost = Electron.ResolvedHost;
|
|
type ScrubberItem = Electron.ScrubberItem;
|
|
type SegmentedControlSegment = Electron.SegmentedControlSegment;
|
|
type SerialPort = Electron.SerialPort;
|
|
type ServiceWorkerInfo = Electron.ServiceWorkerInfo;
|
|
type SharedWorkerInfo = Electron.SharedWorkerInfo;
|
|
type SharingItem = Electron.SharingItem;
|
|
type ShortcutDetails = Electron.ShortcutDetails;
|
|
type Size = Electron.Size;
|
|
type Task = Electron.Task;
|
|
type ThumbarButton = Electron.ThumbarButton;
|
|
type TraceCategoriesAndOptions = Electron.TraceCategoriesAndOptions;
|
|
type TraceConfig = Electron.TraceConfig;
|
|
type Transaction = Electron.Transaction;
|
|
type UploadData = Electron.UploadData;
|
|
type UploadFile = Electron.UploadFile;
|
|
type UploadRawData = Electron.UploadRawData;
|
|
type USBDevice = Electron.USBDevice;
|
|
type UserDefaultTypes = Electron.UserDefaultTypes;
|
|
type WebPreferences = Electron.WebPreferences;
|
|
type WebRequestFilter = Electron.WebRequestFilter;
|
|
type WebSource = Electron.WebSource;
|
|
}
|
|
|
|
const app: App;
|
|
const autoUpdater: AutoUpdater;
|
|
const clipboard: Clipboard;
|
|
const contentTracing: ContentTracing;
|
|
const contextBridge: ContextBridge;
|
|
const crashReporter: CrashReporter;
|
|
const desktopCapturer: DesktopCapturer;
|
|
const dialog: Dialog;
|
|
const globalShortcut: GlobalShortcut;
|
|
const inAppPurchase: InAppPurchase;
|
|
const ipcMain: IpcMain;
|
|
const ipcRenderer: IpcRenderer;
|
|
const nativeImage: typeof NativeImage;
|
|
const nativeTheme: NativeTheme;
|
|
const net: Net;
|
|
const netLog: NetLog;
|
|
const parentPort: ParentPort;
|
|
const powerMonitor: PowerMonitor;
|
|
const powerSaveBlocker: PowerSaveBlocker;
|
|
const protocol: Protocol;
|
|
const pushNotifications: PushNotifications;
|
|
const safeStorage: SafeStorage;
|
|
const screen: Screen;
|
|
const session: typeof Session;
|
|
const shell: Shell;
|
|
const systemPreferences: SystemPreferences;
|
|
const utilityProcess: typeof UtilityProcess;
|
|
const webContents: typeof WebContents;
|
|
const webFrame: WebFrame;
|
|
const webFrameMain: typeof WebFrameMain;
|
|
|
|
}
|
|
|
|
declare module 'electron' {
|
|
export = Electron.CrossProcessExports;
|
|
}
|
|
|
|
declare module 'electron/main' {
|
|
export = Electron.Main;
|
|
}
|
|
|
|
declare module 'electron/common' {
|
|
export = Electron.Common;
|
|
}
|
|
|
|
declare module 'electron/renderer' {
|
|
export = Electron.Renderer;
|
|
}
|
|
|
|
interface NodeRequireFunction {
|
|
(moduleName: 'electron'): typeof Electron.CrossProcessExports;
|
|
(moduleName: 'electron/main'): typeof Electron.Main;
|
|
(moduleName: 'electron/common'): typeof Electron.Common;
|
|
(moduleName: 'electron/renderer'): typeof Electron.Renderer;
|
|
}
|
|
|
|
interface NodeRequire {
|
|
(moduleName: 'electron'): typeof Electron.CrossProcessExports;
|
|
(moduleName: 'electron/main'): typeof Electron.Main;
|
|
(moduleName: 'electron/common'): typeof Electron.Common;
|
|
(moduleName: 'electron/renderer'): typeof Electron.Renderer;
|
|
}
|
|
|
|
interface File {
|
|
/**
|
|
* The real path to the file on the users filesystem
|
|
*/
|
|
path: string;
|
|
}
|
|
|
|
declare module 'original-fs' {
|
|
import * as fs from 'fs';
|
|
export = fs;
|
|
}
|
|
|
|
declare module 'node:original-fs' {
|
|
import * as fs from 'fs';
|
|
export = fs;
|
|
}
|
|
|
|
interface Document {
|
|
createElement(tagName: 'webview'): Electron.WebviewTag;
|
|
}
|
|
|
|
|
|
declare namespace NodeJS {
|
|
interface Process extends NodeJS.EventEmitter {
|
|
|
|
// Docs: https://electronjs.org/docs/api/process
|
|
|
|
/**
|
|
* Emitted when Electron has loaded its internal initialization script and is
|
|
* beginning to load the web page or the main script.
|
|
*/
|
|
on(event: 'loaded', listener: Function): this;
|
|
once(event: 'loaded', listener: Function): this;
|
|
addListener(event: 'loaded', listener: Function): this;
|
|
removeListener(event: 'loaded', listener: Function): this;
|
|
/**
|
|
* Causes the main thread of the current process crash.
|
|
*/
|
|
crash(): void;
|
|
/**
|
|
* * `allocated` Integer - Size of all allocated objects in Kilobytes.
|
|
* * `total` Integer - Total allocated space in Kilobytes.
|
|
*
|
|
* Returns an object with Blink memory information. It can be useful for debugging
|
|
* rendering / DOM related memory issues. Note that all values are reported in
|
|
* Kilobytes.
|
|
*/
|
|
getBlinkMemoryInfo(): Electron.BlinkMemoryInfo;
|
|
getCPUUsage(): Electron.CPUUsage;
|
|
/**
|
|
* The number of milliseconds since epoch, or `null` if the information is
|
|
* unavailable
|
|
*
|
|
* Indicates the creation time of the application. The time is represented as
|
|
* number of milliseconds since epoch. It returns null if it is unable to get the
|
|
* process creation time.
|
|
*/
|
|
getCreationTime(): (number) | (null);
|
|
/**
|
|
* * `totalHeapSize` Integer
|
|
* * `totalHeapSizeExecutable` Integer
|
|
* * `totalPhysicalSize` Integer
|
|
* * `totalAvailableSize` Integer
|
|
* * `usedHeapSize` Integer
|
|
* * `heapSizeLimit` Integer
|
|
* * `mallocedMemory` Integer
|
|
* * `peakMallocedMemory` Integer
|
|
* * `doesZapGarbage` boolean
|
|
*
|
|
* Returns an object with V8 heap statistics. Note that all statistics are reported
|
|
* in Kilobytes.
|
|
*/
|
|
getHeapStatistics(): Electron.HeapStatistics;
|
|
/**
|
|
* @platform win32,linux
|
|
*/
|
|
getIOCounters(): Electron.IOCounters;
|
|
/**
|
|
* Resolves with a ProcessMemoryInfo
|
|
*
|
|
* Returns an object giving memory usage statistics about the current process. Note
|
|
* that all statistics are reported in Kilobytes. This api should be called after
|
|
* app ready.
|
|
*
|
|
* Chromium does not provide `residentSet` value for macOS. This is because macOS
|
|
* performs in-memory compression of pages that haven't been recently used. As a
|
|
* result the resident set size value is not what one would expect. `private`
|
|
* memory is more representative of the actual pre-compression memory usage of the
|
|
* process on macOS.
|
|
*/
|
|
getProcessMemoryInfo(): Promise<Electron.ProcessMemoryInfo>;
|
|
/**
|
|
* * `total` Integer - The total amount of physical memory in Kilobytes available
|
|
* to the system.
|
|
* * `free` Integer - The total amount of memory not being used by applications or
|
|
* disk cache.
|
|
* * `swapTotal` Integer _Windows_ _Linux_ - The total amount of swap memory in
|
|
* Kilobytes available to the system.
|
|
* * `swapFree` Integer _Windows_ _Linux_ - The free amount of swap memory in
|
|
* Kilobytes available to the system.
|
|
*
|
|
* Returns an object giving memory usage statistics about the entire system. Note
|
|
* that all statistics are reported in Kilobytes.
|
|
*/
|
|
getSystemMemoryInfo(): Electron.SystemMemoryInfo;
|
|
/**
|
|
* The version of the host operating system.
|
|
*
|
|
* Example:
|
|
*
|
|
* **Note:** It returns the actual operating system version instead of kernel
|
|
* version on macOS unlike `os.release()`.
|
|
*/
|
|
getSystemVersion(): string;
|
|
/**
|
|
* Causes the main thread of the current process hang.
|
|
*/
|
|
hang(): void;
|
|
/**
|
|
* Sets the file descriptor soft limit to `maxDescriptors` or the OS hard limit,
|
|
* whichever is lower for the current process.
|
|
*
|
|
* @platform darwin,linux
|
|
*/
|
|
setFdLimit(maxDescriptors: number): void;
|
|
/**
|
|
* Indicates whether the snapshot has been created successfully.
|
|
*
|
|
* Takes a V8 heap snapshot and saves it to `filePath`.
|
|
*/
|
|
takeHeapSnapshot(filePath: string): boolean;
|
|
/**
|
|
* A `string` representing Chrome's version string.
|
|
*
|
|
*/
|
|
readonly chrome: string;
|
|
/**
|
|
* A `string` (optional) representing a globally unique ID of the current
|
|
* JavaScript context. Each frame has its own JavaScript context. When
|
|
* contextIsolation is enabled, the isolated world also has a separate JavaScript
|
|
* context. This property is only available in the renderer process.
|
|
*
|
|
*/
|
|
readonly contextId?: string;
|
|
/**
|
|
* A `boolean` that indicates whether the current renderer context has
|
|
* `contextIsolation` enabled. It is `undefined` in the main process.
|
|
*
|
|
*/
|
|
readonly contextIsolated: boolean;
|
|
/**
|
|
* A `boolean`. When the app is started by being passed as parameter to the default
|
|
* Electron executable, this property is `true` in the main process, otherwise it
|
|
* is `undefined`. For example when running the app with `electron .`, it is
|
|
* `true`, even if the app is packaged (`isPackaged`) is `true`. This can be useful
|
|
* to determine how many arguments will need to be sliced off from `process.argv`.
|
|
*
|
|
*/
|
|
readonly defaultApp: boolean;
|
|
/**
|
|
* A `string` representing Electron's version string.
|
|
*
|
|
*/
|
|
readonly electron: string;
|
|
/**
|
|
* A `boolean`, `true` when the current renderer context is the "main" renderer
|
|
* frame. If you want the ID of the current frame you should use
|
|
* `webFrame.routingId`.
|
|
*
|
|
*/
|
|
readonly isMainFrame: boolean;
|
|
/**
|
|
* A `boolean`. For Mac App Store build, this property is `true`, for other builds
|
|
* it is `undefined`.
|
|
*
|
|
*/
|
|
readonly mas: boolean;
|
|
/**
|
|
* A `boolean` that controls ASAR support inside your application. Setting this to
|
|
* `true` will disable the support for `asar` archives in Node's built-in modules.
|
|
*/
|
|
noAsar: boolean;
|
|
/**
|
|
* A `boolean` that controls whether or not deprecation warnings are printed to
|
|
* `stderr`. Setting this to `true` will silence deprecation warnings. This
|
|
* property is used instead of the `--no-deprecation` command line flag.
|
|
*/
|
|
noDeprecation: boolean;
|
|
/**
|
|
* A `Electron.ParentPort` property if this is a `UtilityProcess` (or `null`
|
|
* otherwise) allowing communication with the parent process.
|
|
*/
|
|
parentPort: Electron.ParentPort;
|
|
/**
|
|
* A `string` representing the path to the resources directory.
|
|
*
|
|
*/
|
|
readonly resourcesPath: string;
|
|
/**
|
|
* A `boolean`. When the renderer process is sandboxed, this property is `true`,
|
|
* otherwise it is `undefined`.
|
|
*
|
|
*/
|
|
readonly sandboxed: boolean;
|
|
/**
|
|
* A `boolean` that controls whether or not deprecation warnings will be thrown as
|
|
* exceptions. Setting this to `true` will throw errors for deprecations. This
|
|
* property is used instead of the `--throw-deprecation` command line flag.
|
|
*/
|
|
throwDeprecation: boolean;
|
|
/**
|
|
* A `boolean` that controls whether or not deprecations printed to `stderr`
|
|
* include their stack trace. Setting this to `true` will print stack traces for
|
|
* deprecations. This property is instead of the `--trace-deprecation` command line
|
|
* flag.
|
|
*/
|
|
traceDeprecation: boolean;
|
|
/**
|
|
* A `boolean` that controls whether or not process warnings printed to `stderr`
|
|
* include their stack trace. Setting this to `true` will print stack traces for
|
|
* process warnings (including deprecations). This property is instead of the
|
|
* `--trace-warnings` command line flag.
|
|
*/
|
|
traceProcessWarnings: boolean;
|
|
/**
|
|
* A `string` representing the current process's type, can be:
|
|
*
|
|
* * `browser` - The main process
|
|
* * `renderer` - A renderer process
|
|
* * `worker` - In a web worker
|
|
* * `utility` - In a node process launched as a service
|
|
*
|
|
*/
|
|
readonly type: ('browser' | 'renderer' | 'worker' | 'utility');
|
|
/**
|
|
* A `boolean`. If the app is running as a Windows Store app (appx), this property
|
|
* is `true`, for otherwise it is `undefined`.
|
|
*
|
|
*/
|
|
readonly windowsStore: boolean;
|
|
}
|
|
interface ProcessVersions {
|
|
readonly electron: string;
|
|
readonly chrome: string;
|
|
}
|
|
}
|