electron 9.0.0-beta.7 → 9.0.2

package/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 9.0.0-beta.7
+// Type definitions for Electron 9.0.2
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/electron-typescript-definitions
@@ -695,7 +695,7 @@ You should call `event.preventDefault()` if you want to handle this event.
      * 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.updateCurrentActiviy()` in a timely manner. Otherwise, the operation will
+     * `app.updateCurrentActivity()` in a timely manner. Otherwise, the operation will
      * fail and `continue-activity-error` will be called.
      *
      * @platform darwin
@@ -789,8 +789,8 @@ In most cases, you should do everything in the `ready` event handler.
     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 behaviour, which is
-     * terminating the application.
+     * `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.
@@ -834,7 +834,7 @@ In most cases, you should do everything in the `ready` event handler.
     /**
      * 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
-     * behaviour.
+     * behavior.
 
 This method can only be called before app is ready.
      */
@@ -863,8 +863,10 @@ This method can only be called before app is ready.
     /**
      * 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(): void;
+    focus(options?: FocusOptions): void;
     /**
      * 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
@@ -887,8 +889,6 @@ This method can only be called before app is ready.
     getAppPath(): string;
     /**
      * The current value displayed in the counter badge.
-
-**Deprecated**
      *
      * @platform linux,darwin
      */
@@ -993,8 +993,6 @@ This method can only be called before app is ready.
      * 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.
-
-**Deprecated**
      */
     getName(): string;
     /**
@@ -1005,7 +1003,7 @@ This method can only be called before app is ready.
      * called first, a default log directory will be created equivalent to calling
      * `app.setAppLogsPath()` without a `path` parameter.
      */
-    getPath(name: 'home' | 'appData' | 'userData' | 'cache' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'logs' | 'pepperFlashSystemPlugin'): string;
+    getPath(name: 'home' | 'appData' | 'userData' | 'cache' | 'temp' | 'exe' | 'module' | 'desktop' | 'documents' | 'downloads' | 'music' | 'pictures' | 'videos' | 'logs' | 'pepperFlashSystemPlugin' | 'crashDumps'): 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
@@ -1046,8 +1044,6 @@ This method can only be called before app is ready.
      * has been detected. See
      * https://www.chromium.org/developers/design-documents/accessibility for more
      * details.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -1191,7 +1187,7 @@ This method can only be called before app is ready.
     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
+     * `.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
@@ -1210,8 +1206,6 @@ This method can only be called before app is ready.
      *
      * **Note:** Rendering accessibility tree can significantly affect the performance
      * of your app. It should not be enabled by default.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -1282,8 +1276,6 @@ This method can only be called before app is ready.
      *
      * **Note:** Unity launcher requires the existence of a `.desktop` file to work,
      * for more information please read Desktop Environment Integration.
-     * 
-**Deprecated**
      *
      * @platform linux,darwin
      */
@@ -1338,8 +1330,6 @@ Here's a very simple example of creating a custom Jump List:
      *
      * **Note:** This function overrides the name used internally by Electron; it does
      * not affect the name that the OS uses.
-
-**Deprecated**
      */
     setName(name: string): void;
     /**
@@ -1956,6 +1946,13 @@ __Note__: On macOS this event is an alias of `moved`.
      * 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,
@@ -2333,8 +2330,6 @@ __Note__: On macOS this event is an alias of `moved`.
      * Whether the window can be manually closed by user.
      * 
 On Linux always returns `true`.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2364,8 +2359,6 @@ On Linux always returns `true`.
     /**
      * Whether the maximize/zoom window button toggles fullscreen mode or maximizes the
      * window.
-
-**Deprecated**
      */
     isFullScreenable(): boolean;
     /**
@@ -2376,8 +2369,6 @@ On Linux always returns `true`.
      * Whether the window can be manually maximized by user.
      * 
 On Linux always returns `true`.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2388,8 +2379,6 @@ On Linux always returns `true`.
     isMaximized(): boolean;
     /**
      * Whether menu bar automatically hides itself.
-
-**Deprecated**
      */
     isMenuBarAutoHide(): boolean;
     /**
@@ -2397,11 +2386,9 @@ On Linux always returns `true`.
      */
     isMenuBarVisible(): boolean;
     /**
-     * Whether the window can be manually minimized by user
+     * Whether the window can be manually minimized by the user.
      * 
 On Linux always returns `true`.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2416,10 +2403,8 @@ On Linux always returns `true`.
     isModal(): boolean;
     /**
      * Whether the window can be moved by user.
-     * 
-On Linux always returns `true`.
 
-**Deprecated**
+On Linux always returns `true`.
      *
      * @platform darwin,win32
      */
@@ -2430,9 +2415,7 @@ On Linux always returns `true`.
      */
     isNormal(): boolean;
     /**
-     * Whether the window can be manually resized by user.
-
-**Deprecated**
+     * Whether the window can be manually resized by the user.
      */
     isResizable(): boolean;
     /**
@@ -2596,8 +2579,6 @@ On Linux always returns `true`.
      *
      * If the menu bar is already visible, calling `setAutoHideMenuBar(true)` won't
      * hide it immediately.
-
-**Deprecated**
      */
     setAutoHideMenuBar(hide: boolean): void;
     /**
@@ -2612,8 +2593,6 @@ On Linux always returns `true`.
     setBrowserView(browserView: (BrowserView) | (null)): void;
     /**
      * Sets whether the window can be manually closed by user. On Linux does nothing.
-     * 
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2662,8 +2641,6 @@ On macOS it does not remove the focus from the window.
     /**
      * Sets whether the maximize/zoom window button toggles fullscreen mode or
      * maximizes the window.
-
-**Deprecated**
      */
     setFullScreenable(fullscreenable: boolean): void;
     /**
@@ -2684,14 +2661,12 @@ On macOS it does not remove the focus from the window.
      */
     setIgnoreMouseEvents(ignore: boolean, options?: IgnoreMouseEventsOptions): void;
     /**
-     * Enters or leaves the kiosk mode.
+     * Enters or leaves kiosk mode.
      */
     setKiosk(flag: boolean): void;
     /**
      * Sets whether the window can be manually maximized by user. On Linux does
      * nothing.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2716,8 +2691,6 @@ On macOS it does not remove the focus from the window.
     /**
      * Sets whether the window can be manually minimized by user. On Linux does
      * nothing.
-
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2728,8 +2701,6 @@ On macOS it does not remove the focus from the window.
     setMinimumSize(width: number, height: number): void;
     /**
      * Sets whether the window can be moved by user. On Linux does nothing.
-     * 
-**Deprecated**
      *
      * @platform darwin,win32
      */
@@ -2780,9 +2751,7 @@ On macOS it does not remove the focus from the window.
      */
     setRepresentedFilename(filename: string): void;
     /**
-     * Sets whether the window can be manually resized by user.
-
-**Deprecated**
+     * Sets whether the window can be manually resized by the user.
      */
     setResizable(resizable: boolean): void;
     /**
@@ -2808,7 +2777,7 @@ On macOS it does not remove the focus from the window.
      * Enters or leaves simple fullscreen mode.
      *
      * Simple fullscreen mode emulates the native fullscreen behavior found in versions
-     * of Mac OS X prior to Lion (10.7).
+     * of macOS prior to Lion (10.7).
      *
      * @platform darwin
      */
@@ -2962,13 +2931,22 @@ This cannot be called when `titleBarStyle` is set to `customButtonsOnHover`.
     accessibleTitle: string;
     autoHideMenuBar: boolean;
     closable: boolean;
+    documentEdited: boolean;
     excludedFromShownWindowsMenu: boolean;
+    fullScreen: boolean;
     fullScreenable: boolean;
     readonly id: number;
+    kiosk: boolean;
     maximizable: boolean;
+    menuBarVisible: boolean;
     minimizable: boolean;
     movable: boolean;
+    representedFilename: string;
     resizable: boolean;
+    shadow: boolean;
+    simpleFullScreen: boolean;
+    title: string;
+    visibleOnAllWorkspaces: boolean;
     readonly webContents: WebContents;
   }
 
@@ -3592,79 +3570,92 @@ Sets a cookie with `details`.
     /**
      * 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. This API is only available on macOS and windows, if you need
-     * to add/update extra parameters on Linux after your first call to `start` you can
-     * call `start` again with the updated `extra` options.
+     * `start` was called.
      *
-     * @platform darwin,win32
+     * 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 127 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 directory where crashes are temporarily stored before being uploaded.
+     * 
+**Note:** This method is deprecated, use `app.getPath('crashDumps')` instead.
+     *
+     * @deprecated
      */
     getCrashesDirectory(): string;
     /**
-     * Returns 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.
+     * 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:** Calling this method from the renderer process is deprecated.
      */
     getLastCrashReport(): CrashReport;
     /**
-     * See all of the current parameters being passed to the crash reporter.
+     * The current 'extra' parameters of the crash reporter.
      */
-    getParameters(): void;
+    getParameters(): Record<string, string>;
     /**
      * Returns all uploaded crash reports. Each report contains the date and uploaded
      * ID.
+
+**Note:** Calling this method from the renderer process is deprecated.
      */
     getUploadedReports(): CrashReport[];
     /**
      * Whether reports should be submitted to the server. Set through the `start`
      * method or `setUploadToServer`.
      * 
-**Note:** This API can only be called from the main process.
+**Note:** Calling this method from the renderer process is deprecated.
      */
     getUploadToServer(): boolean;
     /**
-     * Remove a extra parameter from the current set of parameters so that it will not
-     * be sent with the crash report.
-     *
-     * @platform darwin,win32
+     * Remove a 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 API can only be called from the main process.
+**Note:** Calling this method from the renderer process is deprecated.
      */
     setUploadToServer(uploadToServer: boolean): void;
     /**
-     * You are required to call this method before using any other `crashReporter` APIs
-     * and in each process (main/renderer) from which you want to collect crash
-     * reports. You can pass different options to `crashReporter.start` when calling
-     * from different processes.
-     *
-     * **Note** Child processes created via the `child_process` module will not have
-     * access to the Electron modules. Therefore, to collect crash reports from them,
-     * use `process.crashReporter.start` instead. Pass the same options as above along
-     * with an additional one called `crashesDirectory` that should point to a
-     * directory to store the crash reports temporarily. You can test this out by
-     * calling `process.crash()` to crash the child process.
-     *
-     * **Note:** If you need send additional/updated `extra` parameters after your
-     * first call `start` you can call `addExtraParameter` on macOS or call `start`
-     * again with the new/updated `extra` parameters on Linux and Windows.
-     *
-     * **Note:** On macOS and windows, Electron uses a new `crashpad` client for crash
-     * collection and reporting. If you want to enable crash reporting, initializing
-     * `crashpad` from the main process using `crashReporter.start` is required
-     * regardless of which process you want to collect crashes from. Once initialized
-     * this way, the crashpad handler collects crashes from all processes. You still
-     * have to call `crashReporter.start` from the renderer or child process, otherwise
-     * crashes from them will get reported without `companyName`, `productName` or any
-     * of the `extra` information.
+     * 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:** Calling this method from the renderer process is deprecated.
      */
     start(options: CrashReporterStartOptions): void;
   }
@@ -3909,7 +3900,8 @@ Send given command to the debugging target.
      * It returns the index of the clicked button.
      *
      * The `browserWindow` argument allows the dialog to attach itself to a parent
-     * window, making it modal.
+     * window, making it modal. If `browserWindow` is not shown dialog will not be
+     * attached to it. In such case It will be displayed as independed window.
      */
     showMessageBoxSync(browserWindow: BrowserWindow, options: MessageBoxSyncOptions): number;
     /**
@@ -3919,7 +3911,8 @@ Send given command to the debugging target.
      * It returns the index of the clicked button.
      *
      * The `browserWindow` argument allows the dialog to attach itself to a parent
-     * window, making it modal.
+     * window, making it modal. If `browserWindow` is not shown dialog will not be
+     * attached to it. In such case It will be displayed as independed window.
      */
     showMessageBoxSync(options: MessageBoxSyncOptions): number;
     /**
@@ -4319,8 +4312,6 @@ Send given command to the debugging target.
      * 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.
-
-**Deprecated: use the `savePath` property instead.**
      */
     getSavePath(): string;
     /**
@@ -4380,8 +4371,6 @@ If the size is unknown, it returns 0.
      * The API is only available in session's `will-download` callback function. 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.
-     * 
-**Deprecated: use the `savePath` property instead.**
      */
     setSavePath(path: string): void;
     savePath: string;
@@ -4399,7 +4388,19 @@ If the size is unknown, it returns 0.
     // Docs: http://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;
   }
 
@@ -5144,7 +5145,7 @@ For example:
     label: string;
     menu: Menu;
     registerAccelerator: boolean;
-    role?: ('undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'pasteAndMatchStyle' | 'delete' | 'selectAll' | 'reload' | 'forceReload' | 'toggleDevTools' | 'resetZoom' | 'zoomIn' | 'zoomOut' | 'togglefullscreen' | 'window' | 'minimize' | 'close' | 'help' | 'about' | 'services' | 'hide' | 'hideOthers' | 'unhide' | 'quit' | 'startSpeaking' | 'stopSpeaking' | 'close' | 'minimize' | 'zoom' | 'front' | 'appMenu' | 'fileMenu' | 'editMenu' | 'viewMenu' | 'recentDocuments' | 'toggleTabBar' | 'selectNextTab' | 'selectPreviousTab' | 'mergeAllWindows' | 'clearRecentDocuments' | 'moveTabToNewWindow' | 'windowMenu');
+    role?: ('undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'pasteAndMatchStyle' | 'delete' | 'selectAll' | 'reload' | 'forceReload' | 'toggleDevTools' | 'resetZoom' | 'zoomIn' | 'zoomOut' | 'togglefullscreen' | 'window' | 'minimize' | 'close' | 'help' | 'about' | 'services' | 'hide' | 'hideOthers' | 'unhide' | 'quit' | 'startSpeaking' | 'stopSpeaking' | 'zoom' | 'front' | 'appMenu' | 'fileMenu' | 'editMenu' | 'viewMenu' | 'recentDocuments' | 'toggleTabBar' | 'selectNextTab' | 'selectPreviousTab' | 'mergeAllWindows' | 'clearRecentDocuments' | 'moveTabToNewWindow' | 'windowMenu');
     sublabel: string;
     submenu?: Menu;
     toolTip: string;
@@ -5306,8 +5307,6 @@ where `SYSTEM_IMAGE_NAME` should be replaced with any value from this list.
     isEmpty(): boolean;
     /**
      * Whether the image is a template image.
-
-**Deprecated**
      */
     isTemplateImage(): boolean;
     /**
@@ -5319,8 +5318,6 @@ where `SYSTEM_IMAGE_NAME` should be replaced with any value from this list.
     resize(options: ResizeOptions): NativeImage;
     /**
      * Marks the image as a template image.
-
-**Deprecated**
      */
     setTemplateImage(option: boolean): void;
     /**
@@ -5460,6 +5457,13 @@ Starts recording network events to `path`.
     readonly currentlyLoggingPath: string;
   }
 
+  interface NewWindowEvent extends Event {
+
+    // Docs: http://electronjs.org/docs/api/structures/new-window-event
+
+    newGuest?: BrowserWindow;
+  }
+
   class Notification extends NodeJS.EventEmitter {
 
     // Docs: http://electronjs.org/docs/api/notification
@@ -6568,7 +6572,8 @@ e.g.
                                           item: DownloadItem,
                                           webContents: WebContents) => void): this;
     /**
-     * Whether the word was successfully written to the custom dictionary.
+     * 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
@@ -6705,7 +6710,8 @@ Clears the host resolver cache.
      */
     removeExtension(extensionId: string): void;
     /**
-     * Whether the word was successfully removed from the custom dictionary.
+     * 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
@@ -7142,8 +7148,6 @@ Returns an object with system animation settings.
      * Gets the macOS appearance setting that you have declared you want for your
      * application, maps to NSApplication.appearance. You can use the
      * `setAppLevelAppearance` API to set this value.
-
-**Deprecated**
      *
      * @deprecated
      * @platform darwin
@@ -7151,7 +7155,7 @@ Returns an object with system animation settings.
     getAppLevelAppearance(): ('dark' | 'light' | 'unknown');
     /**
      * The system color setting in RGB hexadecimal form (`#ABCDEF`). See the Windows
-     * docs and the MacOS docs for more details.
+     * docs and the macOS docs for more details.
      *
      * The following colors are only available on macOS 10.14: `find-highlight`,
      * `selected-content-background`, `separator`,
@@ -7166,8 +7170,6 @@ Returns an object with system animation settings.
      *
      * Gets the macOS appearance setting that is currently applied to your application,
      * maps to NSApplication.effectiveAppearance
-
-**Deprecated**
      *
      * @platform darwin
      */
@@ -7235,7 +7237,7 @@ Returns an object with system animation settings.
     /**
      * `true` if a high contrast theme is active, `false` otherwise.
      *
-     * **Depreacted:** Should use the new `nativeTheme.shouldUseHighContrastColors`
+     * **Deprecated:** Should use the new `nativeTheme.shouldUseHighContrastColors`
      * API.
      *
      * @deprecated
@@ -7319,8 +7321,6 @@ Returns an object with system animation settings.
     /**
      * Sets the appearance setting for your application, this should override the
      * system default and override the value of `getEffectiveAppearance`.
-     * 
-**Deprecated**
      *
      * @deprecated
      * @platform darwin
@@ -8937,7 +8937,7 @@ The usage is the same with the `login` event of `app`.
      * reference the new `BrowserWindow` instance, failing to do so may result in
      * unexpected behavior. For example:
      */
-    on(event: 'new-window', listener: (event: Event,
+    on(event: 'new-window', listener: (event: NewWindowEvent,
                                        url: string,
                                        frameName: string,
                                        /**
@@ -8959,7 +8959,7 @@ The usage is the same with the `login` event of `app`.
                                         * `Referer` header being sent, depending on the referrer policy.
                                         */
                                        referrer: Referrer) => void): this;
-    once(event: 'new-window', listener: (event: Event,
+    once(event: 'new-window', listener: (event: NewWindowEvent,
                                        url: string,
                                        frameName: string,
                                        /**
@@ -8981,7 +8981,7 @@ The usage is the same with the `login` event of `app`.
                                         * `Referer` header being sent, depending on the referrer policy.
                                         */
                                        referrer: Referrer) => void): this;
-    addListener(event: 'new-window', listener: (event: Event,
+    addListener(event: 'new-window', listener: (event: NewWindowEvent,
                                        url: string,
                                        frameName: string,
                                        /**
@@ -9003,7 +9003,7 @@ The usage is the same with the `login` event of `app`.
                                         * `Referer` header being sent, depending on the referrer policy.
                                         */
                                        referrer: Referrer) => void): this;
-    removeListener(event: 'new-window', listener: (event: Event,
+    removeListener(event: 'new-window', listener: (event: NewWindowEvent,
                                        url: string,
                                        frameName: string,
                                        /**
@@ -9523,8 +9523,6 @@ Works like `executeJavaScript` but evaluates `scripts` in an isolated context.
     getAllSharedWorkers(): SharedWorkerInfo[];
     /**
      * If *offscreen rendering* is enabled returns the current frame rate.
-     * 
-**Deprecated**
      */
     getFrameRate(): number;
     /**
@@ -9556,8 +9554,6 @@ Works like `executeJavaScript` but evaluates `scripts` in an isolated context.
     getURL(): string;
     /**
      * The user agent for this web page.
-
-**Deprecated**
      */
     getUserAgent(): string;
     /**
@@ -9566,14 +9562,10 @@ Works like `executeJavaScript` but evaluates `scripts` in an isolated context.
     getWebRTCIPHandlingPolicy(): string;
     /**
      * the current zoom factor.
-
-**Deprecated**
      */
     getZoomFactor(): number;
     /**
      * the current zoom level.
-
-**Deprecated**
      */
     getZoomLevel(): number;
     /**
@@ -9637,8 +9629,6 @@ This also affects the Page Visibility API.
     invalidate(): void;
     /**
      * Whether this page has been muted.
-
-**Deprecated**
      */
     isAudioMuted(): boolean;
     /**
@@ -9836,8 +9826,6 @@ You can also read `frameId` from all incoming IPC messages in the main process.
     sendToFrame(frameId: number, channel: string, ...args: any[]): void;
     /**
      * Mute the audio on the current web page.
-
-**Deprecated**
      */
     setAudioMuted(muted: boolean): void;
     /**
@@ -9868,8 +9856,6 @@ An example of showing devtools in a `BrowserWindow`:
     /**
      * If *offscreen rendering* is enabled sets the frame rate to the specified number.
      * Only values between 1 and 60 are accepted.
-
-**Deprecated**
      */
     setFrameRate(fps: number): void;
     /**
@@ -9880,8 +9866,6 @@ An example of showing devtools in a `BrowserWindow`:
     setIgnoreMenuShortcuts(ignore: boolean): void;
     /**
      * Overrides the user agent for this web page.
-
-**Deprecated**
      */
     setUserAgent(userAgent: string): void;
     /**
@@ -9900,7 +9884,7 @@ An example of showing devtools in a `BrowserWindow`:
      * Changes the zoom factor to the specified factor. Zoom factor is zoom percent
      * divided by 100, so 300% = 3.0.
 
-**Deprecated**
+The factor must be greater than 0.0.
      */
     setZoomFactor(factor: number): void;
     /**
@@ -9908,8 +9892,6 @@ An example of showing devtools in a `BrowserWindow`:
      * 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`.
-
-**Deprecated**
      */
     setZoomLevel(level: number): void;
     /**
@@ -9960,7 +9942,7 @@ Takes a V8 heap snapshot and saves it to `filePath`.
     unselect(): void;
     audioMuted: boolean;
     readonly debugger: Debugger;
-    readonly devToolsWebContents: WebContents;
+    readonly devToolsWebContents: (WebContents) | (null);
     frameRate: number;
     readonly hostWebContents: WebContents;
     readonly id: number;
@@ -9998,9 +9980,13 @@ Takes a V8 heap snapshot and saves it to `filePath`.
     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 throws or results in a rejected promise.
-     * 
-Works like `executeJavaScript` but evaluates `scripts` in an isolated context.
+     * 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>;
     /**
@@ -10087,6 +10073,8 @@ An example of using node-spellchecker as provider:
     /**
      * 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;
     /**
@@ -11115,7 +11103,7 @@ See webContents.sendInputEvent for detailed description of `event` object.
      */
     skipTaskbar?: boolean;
     /**
-     * The kiosk mode. Default is `false`.
+     * Whether the window is in kiosk mode. Default is `false`.
      */
     kiosk?: boolean;
     /**
@@ -11187,7 +11175,7 @@ See webContents.sendInputEvent for detailed description of `event` object.
      */
     opacity?: number;
     /**
-     * Forces using dark theme for the window, only works on some GTK+3 desktop
+     * Forces using dark theme for the window, only works on some GTK desktop
      * environments. Default is `false`.
      */
     darkTheme?: boolean;
@@ -11315,6 +11303,12 @@ See webContents.sendInputEvent for detailed description of `event` object.
      * `session` is explicitly specified, `partition` is ignored.
      */
     partition?: string;
+    /**
+     * Whether to send cookies with this request from the provided session.  This will
+     * make the `net` request's cookie behavior match a `fetch` request. Default is
+     * `false`.
+     */
+    useSessionCookies?: boolean;
     /**
      * The protocol scheme in the form 'scheme:'. Currently supported values are
      * 'http:' or 'https:'. Defaults to 'http:'.
@@ -11522,7 +11516,6 @@ See webContents.sendInputEvent for detailed description of `event` object.
   }
 
   interface CrashReporterStartOptions {
-    companyName: string;
     /**
      * URL that crash reports will be sent to as POST.
      */
@@ -11532,24 +11525,53 @@ See webContents.sendInputEvent for detailed description of `event` object.
      */
     productName?: string;
     /**
-     * Whether crash reports should be sent to the server. Default is `true`.
+     * 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;
     /**
-     * Default is `false`.
+     * If true, crashes generated in the main process will not be forwarded to the
+     * system crash handler. Default is `false`.
      */
     ignoreSystemCrashHandler?: boolean;
     /**
-     * An object you can define that will be sent along with the report. Only string
-     * properties are sent correctly. Nested objects are not supported. When using
-     * Windows, the property names and values must be fewer than 64 characters.
+     * 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`. Not all collection servers support compressed payloads. Default is
+     * `false`.
+     *
+     * @platform darwin,win32
+     */
+    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>;
     /**
-     * Directory to store the crash reports temporarily (only used when the crash
-     * reporter is started via `process.crashReporter.start`).
+     * 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.
      */
-    crashesDirectory?: string;
+    globalExtra?: Record<string, string>;
   }
 
   interface CreateFromBitmapOptions {
@@ -11761,6 +11783,15 @@ See webContents.sendInputEvent for detailed description of `event` object.
     medialCapitalAsWordStart?: boolean;
   }
 
+  interface FocusOptions {
+    /**
+     * Make the receiver the active app even if another app is currently active.
+     *
+     * @platform darwin
+     */
+    steal: boolean;
+  }
+
   interface FoundInPageEvent extends Event {
     result: FoundInPageResult;
   }
@@ -12015,13 +12046,13 @@ See webContents.sendInputEvent for detailed description of `event` object.
      * `selectAll`, `reload`, `forceReload`, `toggleDevTools`, `resetZoom`, `zoomIn`,
      * `zoomOut`, `togglefullscreen`, `window`, `minimize`, `close`, `help`, `about`,
      * `services`, `hide`, `hideOthers`, `unhide`, `quit`, `startSpeaking`,
-     * `stopSpeaking`, `minimize`, `zoom`, `front`, `appMenu`, `fileMenu`, `editMenu`,
-     * `viewMenu`, `recentDocuments`, `toggleTabBar`, `selectNextTab`,
-     * `selectPreviousTab`, `mergeAllWindows`, `clearRecentDocuments`,
-     * `moveTabToNewWindow` or `windowMenu` - Define the action of the menu item, when
-     * specified the `click` property will be ignored. See roles.
+     * `stopSpeaking`, `zoom`, `front`, `appMenu`, `fileMenu`, `editMenu`, `viewMenu`,
+     * `recentDocuments`, `toggleTabBar`, `selectNextTab`, `selectPreviousTab`,
+     * `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' | 'togglefullscreen' | 'window' | 'minimize' | 'close' | 'help' | 'about' | 'services' | 'hide' | 'hideOthers' | 'unhide' | 'quit' | 'startSpeaking' | 'stopSpeaking' | 'minimize' | 'zoom' | 'front' | 'appMenu' | 'fileMenu' | 'editMenu' | 'viewMenu' | 'recentDocuments' | 'toggleTabBar' | 'selectNextTab' | 'selectPreviousTab' | 'mergeAllWindows' | 'clearRecentDocuments' | 'moveTabToNewWindow' | 'windowMenu');
+    role?: ('undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'pasteAndMatchStyle' | 'delete' | 'selectAll' | 'reload' | 'forceReload' | 'toggleDevTools' | 'resetZoom' | 'zoomIn' | 'zoomOut' | 'togglefullscreen' | 'window' | 'minimize' | 'close' | 'help' | 'about' | 'services' | 'hide' | 'hideOthers' | 'unhide' | 'quit' | 'startSpeaking' | 'stopSpeaking' | 'zoom' | 'front' | 'appMenu' | 'fileMenu' | 'editMenu' | 'viewMenu' | 'recentDocuments' | 'toggleTabBar' | 'selectNextTab' | 'selectPreviousTab' | 'mergeAllWindows' | 'clearRecentDocuments' | 'moveTabToNewWindow' | 'windowMenu');
     /**
      * Can be `normal`, `separator`, `submenu`, `checkbox` or `radio`.
      */
@@ -13719,6 +13750,11 @@ See webContents.sendInputEvent for detailed description of `event` object.
      * message is in English and not localized.
      */
     safeDialogsMessage?: string;
+    /**
+     * Whether to disable dialogs completely. Overrides `safeDialogs`. Default is
+     * `false`.
+     */
+    disableDialogs?: boolean;
     /**
      * Whether dragging and dropping a file or link onto the page causes a navigation.
      * Default is `false`.
@@ -13744,6 +13780,10 @@ See webContents.sendInputEvent for detailed description of `event` object.
      * Whether to enable the builtin spellchecker. Default is `true`.
      */
     spellcheck?: boolean;
+    /**
+     * Whether to enable the WebSQL api. Default is `true`.
+     */
+    enableWebSQL?: boolean;
   }
 
   interface DefaultFontFamily {

package/package.json

@@ -16,7 +16,7 @@
     "node": ">= 8.6"
   },
   "name": "electron",
-  "version": "9.0.0-beta.7",
+  "version": "9.0.2",
   "repository": "https://github.com/electron/electron",
   "description": "Build cross platform desktop apps with JavaScript, HTML, and CSS",
   "license": "MIT",