electron 15.0.0-beta.6 → 16.0.0-alpha.2

package/README.md

@@ -1,7 +1,7 @@
 [![Electron Logo](https://electronjs.org/images/electron-logo.svg)](https://electronjs.org)
 
-[![CircleCI Build Status](https://circleci.com/gh/electron/electron/tree/master.svg?style=shield)](https://circleci.com/gh/electron/electron/tree/master)
-[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/4lggi9dpjc1qob7k/branch/master?svg=true)](https://ci.appveyor.com/project/electron-bot/electron-ljo26/branch/master)
+[![CircleCI Build Status](https://circleci.com/gh/electron/electron/tree/main.svg?style=shield)](https://circleci.com/gh/electron/electron/tree/main)
+[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/4lggi9dpjc1qob7k/branch/main?svg=true)](https://ci.appveyor.com/project/electron-bot/electron-ljo26/branch/main)
 [![Electron Discord Invite](https://img.shields.io/discord/745037351163527189?color=%237289DA&label=chat&logo=discord&logoColor=white)](https://discord.com/invite/electron)
 
 :memo: Available Translations: 🇨🇳 🇧🇷 🇪🇸 🇯🇵 🇷🇺 🇫🇷 🇺🇸 🇩🇪.
@@ -16,7 +16,7 @@ Follow [@ElectronJS](https://twitter.com/electronjs) on Twitter for important
 announcements.
 
 This project adheres to the Contributor Covenant
-[code of conduct](https://github.com/electron/electron/tree/master/CODE_OF_CONDUCT.md).
+[code of conduct](https://github.com/electron/electron/tree/main/CODE_OF_CONDUCT.md).
 By participating, you are expected to uphold this code. Please report unacceptable
 behavior to [coc@electronjs.org](mailto:coc@electronjs.org).
 
@@ -60,7 +60,6 @@ npm start
 - [electronjs.org/community#boilerplates](https://electronjs.org/community#boilerplates) - Sample starter apps created by the community
 - [electron/simple-samples](https://github.com/electron/simple-samples) - Small applications with ideas for taking them further
 - [electron/electron-api-demos](https://github.com/electron/electron-api-demos) - An Electron app that teaches you how to use Electron
-- [hokein/electron-sample-apps](https://github.com/hokein/electron-sample-apps) - Small demo apps for the various Electron APIs
 
 ## Programmatic usage
 
@@ -98,6 +97,6 @@ and more can be found in the [support document](docs/tutorial/support.md#finding
 
 ## License
 
-[MIT](https://github.com/electron/electron/blob/master/LICENSE)
+[MIT](https://github.com/electron/electron/blob/main/LICENSE)
 
 When using the Electron or other GitHub logos, be sure to follow the [GitHub logo guidelines](https://github.com/logos).

package/checksums.json

@@ -0,0 +1,80 @@
+{
+  "chromedriver-v16.0.0-alpha.2-darwin-arm64.zip": "81f0f9efe3e54ceb3fdd0a4304c11b5de1a50ee41abe344ce370ca0d6dba36ab",
+  "chromedriver-v16.0.0-alpha.2-darwin-x64.zip": "1a0b5849634378a9e8928a760696a9460504f3ac6f9cb1cf66e87debc866004c",
+  "chromedriver-v16.0.0-alpha.2-linux-arm64.zip": "3d675a3bf3129d8d0ba5e9d267d429134bb1af83f3ae08c6029fe416c2695a55",
+  "chromedriver-v16.0.0-alpha.2-linux-armv7l.zip": "708d55c09fdb2f11bdb68a3613545ee8652adfaefe537b52b2dc9dd88ab27ad4",
+  "chromedriver-v16.0.0-alpha.2-linux-ia32.zip": "dc77f94bf2af2d4695435da6187cfffcb75b8fda9473c9f6d2ebe673bcfbf40a",
+  "chromedriver-v16.0.0-alpha.2-linux-x64.zip": "f9594d85c032b9f30614c3399c28b5098d6d1b0f151a0ab1bd169c1fe65886b8",
+  "chromedriver-v16.0.0-alpha.2-mas-arm64.zip": "3c2c18f1b8e6beb2846129e81aed99e7f10026b6e6c49fb7c61167e8d8b5ab43",
+  "chromedriver-v16.0.0-alpha.2-mas-x64.zip": "bb125fe3869c577382e3701c1ec7e54b38ad165dc0d7935a14a310965721c354",
+  "chromedriver-v16.0.0-alpha.2-win32-arm64.zip": "b630832cf0461a08033f1c680613caea6a7762b01d69511c896d22521ffcdb54",
+  "chromedriver-v16.0.0-alpha.2-win32-ia32.zip": "b315f38c1fc24d41c58c486df47838fa231787d69d8d671018a420f544437a93",
+  "chromedriver-v16.0.0-alpha.2-win32-x64.zip": "d5a055e34eb9cfc6a7153e154b93b7bc8e9c26794d9bbf1fc24483262928a09b",
+  "electron-api.json": "ea82b53c2177f40b87e023479e28b3d1ad2ffa2e8cab81d439d2c337ae9f6163",
+  "electron-v16.0.0-alpha.2-darwin-arm64-dsym.zip": "e4b715d4a5d3aaa8a2778f89c9b7aaf21dbe548b81d98fba0637dfcb54c488d2",
+  "electron-v16.0.0-alpha.2-darwin-arm64-symbols.zip": "a4d110fd8da4551d335f9de45378f0a30dec9e7464f9e14005ec84bbe5a55d8c",
+  "electron-v16.0.0-alpha.2-darwin-arm64.zip": "a264140bb6872cf6edc40972a91e2383bc8dac0847eec9e343cf09d99dbd68ee",
+  "electron-v16.0.0-alpha.2-darwin-x64-dsym.zip": "c53d27aa88a30f51c58dd3abb845d7732f532456c84172a51628d7271b3eb034",
+  "electron-v16.0.0-alpha.2-darwin-x64-symbols.zip": "d98047dd1beb464d963f31b503c41435aaf98dcde085cdda034a578765d6054f",
+  "electron-v16.0.0-alpha.2-darwin-x64.zip": "b032823d6bfdf8d26bdadf4cfc11d56fd0c9bf182b72a7eb2bcee21e894e51f2",
+  "electron-v16.0.0-alpha.2-linux-arm64-debug.zip": "572a93b546ffb85b6018304048891c457a1efb6c0fc18eb020d197caf22fc23c",
+  "electron-v16.0.0-alpha.2-linux-arm64-symbols.zip": "1e86b4722d30fd1eb87cbfb605a1174c6036b1337342c1c7c97498e31eb4ccdd",
+  "electron-v16.0.0-alpha.2-linux-arm64.zip": "a306d4c3d0aaf739a263deaf8c85b3c43a5409e9fd2a62a295aa2e1b42538956",
+  "electron-v16.0.0-alpha.2-linux-armv7l-debug.zip": "572a93b546ffb85b6018304048891c457a1efb6c0fc18eb020d197caf22fc23c",
+  "electron-v16.0.0-alpha.2-linux-armv7l-symbols.zip": "99bfb569af4700dc435fccc86f1eaf977cc914da095dceb4c3059d0d81fdf2b3",
+  "electron-v16.0.0-alpha.2-linux-armv7l.zip": "0b597c87ccff1dd9c8bb342f882317812e343dd38456f5328fe66d955a30661e",
+  "electron-v16.0.0-alpha.2-linux-ia32-debug.zip": "572a93b546ffb85b6018304048891c457a1efb6c0fc18eb020d197caf22fc23c",
+  "electron-v16.0.0-alpha.2-linux-ia32-symbols.zip": "40798272358a1d6264baffe6746c3f8bec3302e898e17d3adcd82215483fd9c4",
+  "electron-v16.0.0-alpha.2-linux-ia32.zip": "a8c8dbfcea6ac55a071e2a7a8f865ca5a2328cdc8dc9c7720379e4709a789588",
+  "electron-v16.0.0-alpha.2-linux-x64-debug.zip": "262313575dc402246345b9c3f7d8e9d7ab4c1b99a38ff8c96ef31805a7931a88",
+  "electron-v16.0.0-alpha.2-linux-x64-symbols.zip": "b228d86407a819819dc5a0919bf04a01f0aca2c9a3ce3baf2448d2989c14d521",
+  "electron-v16.0.0-alpha.2-linux-x64.zip": "d352568522e730f82df8f5f340ce241d8e97b6e373f8b82d6d37514abae6b66a",
+  "electron-v16.0.0-alpha.2-mas-arm64-dsym.zip": "c107cae485005ea48006eda395c35ee4f26310315868f2e67dd308ce8e7a77df",
+  "electron-v16.0.0-alpha.2-mas-arm64-symbols.zip": "ce9ae240138a8994b6ec02cfe75feadac5c82aba724e21eaa75d3821d76887cd",
+  "electron-v16.0.0-alpha.2-mas-arm64.zip": "a7d360362a4bf9f220b0bb205d147c7dd6876a73d449afa507076f119aa4a671",
+  "electron-v16.0.0-alpha.2-mas-x64-dsym.zip": "aae0b0ad8ee2e8466402f48d99948e2da30ba8b83c136cd417fc4355a17f0664",
+  "electron-v16.0.0-alpha.2-mas-x64-symbols.zip": "46344ed6d32cc260ed0ee481bcc0b3bf9cf0718c2ebc2f49ce7cde473d12deb6",
+  "electron-v16.0.0-alpha.2-mas-x64.zip": "88ce5aed3aea018e720669a8aec4f2ec63dad74c8612b92a405efc55d07ce5d0",
+  "electron-v16.0.0-alpha.2-win32-arm64-pdb.zip": "56ce956f2bc2bc590bab306b789985799a9ffcd6d8d64e87694ea9d65eee28f7",
+  "electron-v16.0.0-alpha.2-win32-arm64-symbols.zip": "49d86fd034ef4e99ac2bebc620845643d3f0391b2225da017102032189e95fbc",
+  "electron-v16.0.0-alpha.2-win32-arm64-toolchain-profile.zip": "3b0e3dde77968ef5643bf5a043be2ccd84edd88ccb588505a65ba7e7a6542b9e",
+  "electron-v16.0.0-alpha.2-win32-arm64.zip": "b6915637fe2beefdc9b4a41812d41e84bd9cb52ae15916c5e1032a65d1b548f0",
+  "electron-v16.0.0-alpha.2-win32-ia32-pdb.zip": "038b5772934ef645dd910421259b3e5691169c4c02730be2f7a508f046485a31",
+  "electron-v16.0.0-alpha.2-win32-ia32-symbols.zip": "0cdbdb761f61c24663970eb809605718e9a9fc34d83365682141c3e3545d8332",
+  "electron-v16.0.0-alpha.2-win32-ia32-toolchain-profile.zip": "3b0e3dde77968ef5643bf5a043be2ccd84edd88ccb588505a65ba7e7a6542b9e",
+  "electron-v16.0.0-alpha.2-win32-ia32.zip": "0fbc326275f1fdd3e77d2bf75383171a0b562c205c53af7f95dcf356ce8fb216",
+  "electron-v16.0.0-alpha.2-win32-x64-pdb.zip": "414e603c43eccb286a51719070ca7f3b14df54fbcb2ab797df1cbd855ae95566",
+  "electron-v16.0.0-alpha.2-win32-x64-symbols.zip": "b6a1d4965280d350b7556ca73cb683bc67839ce9e98f0422d6f5eb86e4c1b9a6",
+  "electron-v16.0.0-alpha.2-win32-x64-toolchain-profile.zip": "3b0e3dde77968ef5643bf5a043be2ccd84edd88ccb588505a65ba7e7a6542b9e",
+  "electron-v16.0.0-alpha.2-win32-x64.zip": "63d4a871e9100fa3a383768d3ba81a2466a33e5e1fd6c665365f9327bad0742f",
+  "electron.d.ts": "c8e75323ecb55173e14f2d7f08444e1f6882acef11db717358d7c7dc6cc80bab",
+  "ffmpeg-v16.0.0-alpha.2-darwin-arm64.zip": "67beeed81bd3e0110209dc209da9cbf1fad72147fd22e385a556dc1d83778ee4",
+  "ffmpeg-v16.0.0-alpha.2-darwin-x64.zip": "c034c04d55284200e8279ab9ffc0918a8095b95e1b85730c4559160ec71baaf5",
+  "ffmpeg-v16.0.0-alpha.2-linux-arm64.zip": "e2d1731c111913e06d0c2eb9f1d3d6bfe187860e8ebf1f07534d9377086e1b52",
+  "ffmpeg-v16.0.0-alpha.2-linux-armv7l.zip": "3f6847162054cd591642a42ede3c47534d2643c7e61277cedd40945bc63b6682",
+  "ffmpeg-v16.0.0-alpha.2-linux-ia32.zip": "3ea031098a53b4edf6e885b2625cdcbc64a07e6e712fc798cd214170711a58d7",
+  "ffmpeg-v16.0.0-alpha.2-linux-x64.zip": "b0a7d05bf32e8f2d123b67bdf4b32d1572491a9ca18346e9ea5a3f2c07558e2b",
+  "ffmpeg-v16.0.0-alpha.2-mas-arm64.zip": "67beeed81bd3e0110209dc209da9cbf1fad72147fd22e385a556dc1d83778ee4",
+  "ffmpeg-v16.0.0-alpha.2-mas-x64.zip": "c034c04d55284200e8279ab9ffc0918a8095b95e1b85730c4559160ec71baaf5",
+  "ffmpeg-v16.0.0-alpha.2-win32-arm64.zip": "3d6e85e8e151cc0494b16aea88ed71777628be70b8b0c3f8aac6ed6551bd377a",
+  "ffmpeg-v16.0.0-alpha.2-win32-ia32.zip": "577c39e570d23fc8e2510160bc7d4d41d893f0a5493e094d1d35041ba51077c9",
+  "ffmpeg-v16.0.0-alpha.2-win32-x64.zip": "ce8fce4d4da0fcaa5cb80e461afeecb92f51f36d9786cb39635f7b0f617ff56b",
+  "hunspell_dictionaries.zip": "6c6e76d717dbd1574901eefd626fc16eca80c5117567faf431c5631020e7c19c",
+  "libcxx-objects-v16.0.0-alpha.2-linux-arm64.zip": "fd981642797ad60f64eb79f8e6a1466eb23e31a2a4ce15d9a34b8db85a71bcf2",
+  "libcxx-objects-v16.0.0-alpha.2-linux-armv7l.zip": "0e81197bbee9414e2a29ccf8b6703980d0d69d46aea87d577b3d549502db2f9a",
+  "libcxx-objects-v16.0.0-alpha.2-linux-ia32.zip": "b142310e81e1b2510c54a219d7bbdfffc7fef0fb4d587ecb3121df73dc9950f4",
+  "libcxx-objects-v16.0.0-alpha.2-linux-x64.zip": "ad21fdea582dc9201097f1fb1e4fa5ca05f570d755517a9f35dae2bbc2944d35",
+  "libcxx_headers.zip": "8038c110a33d48e9f81b8314e8843c226aab19ea4f689891534461281b867de8",
+  "libcxxabi_headers.zip": "d2346f4c54d855365e83a031a26cf20d5798ca9185326f72bcb9faabe406f0b9",
+  "mksnapshot-v16.0.0-alpha.2-darwin-arm64.zip": "f4af4c4290660cf4565fbc9bc08c6b80c2c7ea907f815b07a39edf3d658c1695",
+  "mksnapshot-v16.0.0-alpha.2-darwin-x64.zip": "638517e3254275ccce2ed02ec1e89da68884e38dd95b948e16e14d9d53f65fce",
+  "mksnapshot-v16.0.0-alpha.2-linux-arm64-x64.zip": "541487d3fe6090a0a06598b1b33b09eaddfca775f9eb52a88941d944edc3bdca",
+  "mksnapshot-v16.0.0-alpha.2-linux-armv7l-x64.zip": "49883fd3ff08c306134191b9ef65d8f120d6a82ec9ebedd8b725b90652b98a7f",
+  "mksnapshot-v16.0.0-alpha.2-linux-ia32.zip": "0c8264f8c32d7c228576ac042df8e5d3bc39be5904c1ce98c2806e31ddaae684",
+  "mksnapshot-v16.0.0-alpha.2-linux-x64.zip": "3e698e39e456d04459d82407ade421f4bb0ecf3350fafa8d895e5864ea6df587",
+  "mksnapshot-v16.0.0-alpha.2-mas-arm64.zip": "d55e7af81cc496e78aa9a549bd3fcd65ed3cbda3725b2d06d975341de8df0b9f",
+  "mksnapshot-v16.0.0-alpha.2-mas-x64.zip": "691dce5c2fd11ec6d248c3f95287aa08b397a2f397090cee03bc5c91cd0d5d16",
+  "mksnapshot-v16.0.0-alpha.2-win32-arm64-x64.zip": "9e58807de5bcca58dd1e9f0287e3eb26b3b96a24bb455495942593a7a2b79a0c",
+  "mksnapshot-v16.0.0-alpha.2-win32-ia32.zip": "7167c3d3337a4b5cb6aa60ccf464b73256d4d352edc3ffd273d8251795a17957",
+  "mksnapshot-v16.0.0-alpha.2-win32-x64.zip": "b3fcbfa5af2407acf396c5ad895819ff296901a69229dfaf6ccf97feb23444bb"
+}

package/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 15.0.0-beta.6
+// Type definitions for Electron 16.0.0-alpha.2
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/electron-typescript-definitions
@@ -165,7 +165,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     once(event: 'certificate-error', listener: (event: Event,
                                               webContents: WebContents,
                                               url: string,
@@ -174,7 +175,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     addListener(event: 'certificate-error', listener: (event: Event,
                                               webContents: WebContents,
                                               url: string,
@@ -183,7 +185,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     removeListener(event: 'certificate-error', listener: (event: Event,
                                               webContents: WebContents,
                                               url: string,
@@ -192,7 +195,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              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.
@@ -2522,8 +2526,8 @@ declare namespace Electron {
      * 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 programmingly with APIs
-     * like `win.setSize`.
+     * The aspect ratio is not respected when window is resized programmatically with
+     * APIs like `win.setSize`.
      */
     setAspectRatio(aspectRatio: number, extraSize?: Size): void;
     /**
@@ -3381,7 +3385,7 @@ declare namespace Electron {
      *
      * 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.
+     * bookmark is unavailable.  The `title` value will always be empty on Windows.
      *
      * @platform darwin,win32
      */
@@ -3424,7 +3428,7 @@ declare namespace Electron {
      */
     write(data: Data, type?: 'selection' | 'clipboard'): void;
     /**
-     * Writes the `title` and `url` into the clipboard as a bookmark.
+     * 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
@@ -3747,13 +3751,6 @@ declare namespace Electron {
      * 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.
-     *
-     * **Note:** On linux values that are longer than 127 bytes will be chunked into
-     * multiple keys, each 127 bytes in length.  E.g. `addExtraParameter('foo',
-     * 'a'.repeat(130))` will result in two chunked keys `foo__1` and `foo__2`, the
-     * first will contain the first 127 bytes and the second will contain the remaining
-     * 3 bytes.  On your crash reporting backend you should stitch together keys in
-     * this format.
      */
     addExtraParameter(key: string, value: string): void;
     /**
@@ -4754,6 +4751,37 @@ declare namespace Electron {
     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
@@ -7146,6 +7174,36 @@ declare namespace Electron {
                                                extension: Extension) => void): this;
     removeListener(event: 'extension-unloaded', listener: (event: Event,
                                                extension: Extension) => void): this;
+    /**
+     * Emitted when a new HID device becomes available. For example, when a new USB
+     * device is plugged in.
+     *
+     * This event will only be emitted after `navigator.hid.requestDevice` has been
+     * called and `select-hid-device` has fired.
+     */
+    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 when a HID device has been removed.  For example, this event will fire
+     * when a USB device is unplugged.
+     *
+     * This event will only be emitted after `navigator.hid.requestDevice` has been
+     * called and `select-hid-device` has fired.
+     */
+    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 when a render process requests preconnection to a URL, generally due to
      * a resource hint.
@@ -7190,6 +7248,26 @@ declare namespace Electron {
                                         * 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
@@ -7553,6 +7631,21 @@ declare namespace Electron {
      * > **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 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 through the lifetime of the
+     * corresponding WebContents.  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;
     /**
      * Sets download saving directory. By default, the download directory will be the
      * `Downloads` under the respective app folder.
@@ -9369,7 +9462,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     once(event: 'certificate-error', listener: (event: Event,
                                               url: string,
                                               /**
@@ -9377,7 +9471,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     addListener(event: 'certificate-error', listener: (event: Event,
                                               url: string,
                                               /**
@@ -9385,7 +9480,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     removeListener(event: 'certificate-error', listener: (event: Event,
                                               url: string,
                                               /**
@@ -9393,7 +9489,8 @@ declare namespace Electron {
                                                */
                                               error: string,
                                               certificate: Certificate,
-                                              callback: (isTrusted: boolean) => void) => void): this;
+                                              callback: (isTrusted: boolean) => void,
+                                              isMainFrame: boolean) => void): this;
     /**
      * Emitted when the associated window logs a console message.
      */
@@ -12926,6 +13023,10 @@ declare namespace Electron {
      * 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.
      */
@@ -13259,6 +13360,25 @@ declare namespace Electron {
     name?: string;
   }
 
+  interface DevicePermissionHandlerHandlerDetails {
+    /**
+     * The type of device that permission is being requested on, can be `hid`.
+     */
+    deviceType: ('hid');
+    /**
+     * The origin URL of the device permission check.
+     */
+    origin: string;
+    /**
+     * the device that permission is being requested for.
+     */
+    device: HIDDevice;
+    /**
+     * WebFrameMain checking the device permission.
+     */
+    frame: WebFrameMain;
+  }
+
   interface DidChangeThemeColorEvent extends Event {
     themeColor: string;
   }
@@ -13514,6 +13634,16 @@ declare namespace Electron {
     doesZapGarbage: boolean;
   }
 
+  interface HidDeviceAddedDetails {
+    device: HIDDevice[];
+    frame: WebFrameMain;
+  }
+
+  interface HidDeviceRemovedDetails {
+    device: HIDDevice[];
+    frame: WebFrameMain;
+  }
+
   interface IgnoreMouseEventsOptions {
     /**
      * If true, forwards mouse move messages to Chromium, enabling mouse related events
@@ -13617,9 +13747,13 @@ declare namespace Electron {
 
   interface Item {
     /**
-     * The path(s) to the file(s) being dragged.
+     * The path to the file being dragged.
      */
-    file: (string[]) | (string);
+    file: string;
+    /**
+     * The paths to the files being dragged. (`files` will override `file` field)
+     */
+    files?: string[];
     /**
      * The image must be non-empty on macOS.
      */
@@ -13903,6 +14037,12 @@ declare namespace Electron {
      */
     checkboxChecked?: boolean;
     icon?: NativeImage;
+    /**
+     * 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.
@@ -13971,6 +14111,12 @@ declare namespace Electron {
      */
     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.
@@ -14656,7 +14802,14 @@ declare namespace Electron {
     certificate: Certificate;
     validatedCertificate: Certificate;
     /**
-     * Verification result from chromium.
+     * `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;
     /**
@@ -14826,6 +14979,11 @@ declare namespace Electron {
     securityScopedBookmarks?: boolean;
   }
 
+  interface SelectHidDeviceDetails {
+    deviceList: HIDDevice[];
+    frame: WebFrameMain;
+  }
+
   interface Settings {
     /**
      * `true` to open the app at login, `false` to remove the app as a login item.
@@ -15893,6 +16051,7 @@ declare namespace Electron {
     type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
     type Data = Electron.Data;
     type Details = Electron.Details;
+    type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
     type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
     type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
     type DidFailLoadEvent = Electron.DidFailLoadEvent;
@@ -15914,6 +16073,8 @@ declare namespace Electron {
     type HandlerDetails = Electron.HandlerDetails;
     type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
     type HeapStatistics = Electron.HeapStatistics;
+    type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
+    type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
     type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
     type ImportCertificateOptions = Electron.ImportCertificateOptions;
     type Info = Electron.Info;
@@ -15976,6 +16137,7 @@ declare namespace Electron {
     type SaveDialogOptions = Electron.SaveDialogOptions;
     type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
     type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
+    type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
     type Settings = Electron.Settings;
     type SourcesOptions = Electron.SourcesOptions;
     type SSLConfigConfig = Electron.SSLConfigConfig;
@@ -16027,6 +16189,7 @@ declare namespace Electron {
     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;
@@ -16173,6 +16336,7 @@ declare namespace Electron {
     type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
     type Data = Electron.Data;
     type Details = Electron.Details;
+    type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
     type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
     type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
     type DidFailLoadEvent = Electron.DidFailLoadEvent;
@@ -16194,6 +16358,8 @@ declare namespace Electron {
     type HandlerDetails = Electron.HandlerDetails;
     type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
     type HeapStatistics = Electron.HeapStatistics;
+    type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
+    type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
     type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
     type ImportCertificateOptions = Electron.ImportCertificateOptions;
     type Info = Electron.Info;
@@ -16256,6 +16422,7 @@ declare namespace Electron {
     type SaveDialogOptions = Electron.SaveDialogOptions;
     type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
     type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
+    type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
     type Settings = Electron.Settings;
     type SourcesOptions = Electron.SourcesOptions;
     type SSLConfigConfig = Electron.SSLConfigConfig;
@@ -16307,6 +16474,7 @@ declare namespace Electron {
     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;
@@ -16393,6 +16561,7 @@ declare namespace Electron {
     type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
     type Data = Electron.Data;
     type Details = Electron.Details;
+    type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
     type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
     type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
     type DidFailLoadEvent = Electron.DidFailLoadEvent;
@@ -16414,6 +16583,8 @@ declare namespace Electron {
     type HandlerDetails = Electron.HandlerDetails;
     type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
     type HeapStatistics = Electron.HeapStatistics;
+    type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
+    type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
     type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
     type ImportCertificateOptions = Electron.ImportCertificateOptions;
     type Info = Electron.Info;
@@ -16476,6 +16647,7 @@ declare namespace Electron {
     type SaveDialogOptions = Electron.SaveDialogOptions;
     type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
     type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
+    type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
     type Settings = Electron.Settings;
     type SourcesOptions = Electron.SourcesOptions;
     type SSLConfigConfig = Electron.SSLConfigConfig;
@@ -16527,6 +16699,7 @@ declare namespace Electron {
     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;
@@ -16690,6 +16863,7 @@ declare namespace Electron {
     type CreateInterruptedDownloadOptions = Electron.CreateInterruptedDownloadOptions;
     type Data = Electron.Data;
     type Details = Electron.Details;
+    type DevicePermissionHandlerHandlerDetails = Electron.DevicePermissionHandlerHandlerDetails;
     type DidChangeThemeColorEvent = Electron.DidChangeThemeColorEvent;
     type DidCreateWindowDetails = Electron.DidCreateWindowDetails;
     type DidFailLoadEvent = Electron.DidFailLoadEvent;
@@ -16711,6 +16885,8 @@ declare namespace Electron {
     type HandlerDetails = Electron.HandlerDetails;
     type HeadersReceivedResponse = Electron.HeadersReceivedResponse;
     type HeapStatistics = Electron.HeapStatistics;
+    type HidDeviceAddedDetails = Electron.HidDeviceAddedDetails;
+    type HidDeviceRemovedDetails = Electron.HidDeviceRemovedDetails;
     type IgnoreMouseEventsOptions = Electron.IgnoreMouseEventsOptions;
     type ImportCertificateOptions = Electron.ImportCertificateOptions;
     type Info = Electron.Info;
@@ -16773,6 +16949,7 @@ declare namespace Electron {
     type SaveDialogOptions = Electron.SaveDialogOptions;
     type SaveDialogReturnValue = Electron.SaveDialogReturnValue;
     type SaveDialogSyncOptions = Electron.SaveDialogSyncOptions;
+    type SelectHidDeviceDetails = Electron.SelectHidDeviceDetails;
     type Settings = Electron.Settings;
     type SourcesOptions = Electron.SourcesOptions;
     type SSLConfigConfig = Electron.SSLConfigConfig;
@@ -16824,6 +17001,7 @@ declare namespace Electron {
     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;

package/install.js

@@ -41,6 +41,7 @@ downloadArtifact({
   artifactName: 'electron',
   force: process.env.force_no_cache === 'true',
   cacheRoot: process.env.electron_config_cache,
+  checksums: process.env.electron_use_remote_checksums ? undefined : require('./checksums.json'),
   platform,
   arch
 }).then(extractFile).catch(err => {

package/package.json

@@ -8,7 +8,7 @@
     "postinstall": "node install.js"
   },
   "dependencies": {
-    "@electron/get": "^1.0.1",
+    "@electron/get": "^1.13.0",
     "@types/node": "^14.6.2",
     "extract-zip": "^1.0.3"
   },
@@ -16,7 +16,7 @@
     "node": ">= 8.6"
   },
   "name": "electron",
-  "version": "15.0.0-beta.6",
+  "version": "16.0.0-alpha.2",
   "repository": "https://github.com/electron/electron",
   "description": "Build cross platform desktop apps with JavaScript, HTML, and CSS",
   "license": "MIT",