notes/node_modules/electron-to-chromium/README.md

102 lines
2.6 KiB
Markdown

# Electron-to-Chromium
This repository provides a mapping of Electron versions to the Chromium version that it uses.
## Install
Install using `npm install electron-to-chromium`.
## Usage
to include electron-to-chromium, require it:
```js
var e2c = require('electron-to-chromium');
```
### Properties
The Electron-to-Chromium object has 4 properties to use:
#### versions
An object with all _major_ Electron versions as keys and their respective major Chromium version as string value.
```js
var versions = e2c.versions;
console.log(versions['1.4']);
// returns "53"
```
#### fullVersions
An object with all Electron versions as keys and their respective Chromium version as value.
```js
var versions = e2c.fullVersions;
console.log(versions['1.4.11']);
// returns "53.0.2785.143"
```
#### electronToChromium(query)
Arguments:
* Query: string or number, required. A major or full electron version.
A function that returns the corresponding Chromium version for a given Electron function. Returns a string.
If you provide it with a major Electron version, it will return a major Chromium version:
```js
var chromeVersion = e2c.electronToChromium('1.4');
// chromeVersion is "53"
```
If you provide it with a full Electron version, it will return the full Chromium version.
```js
var chromeVersion = e2c.electronToChromium('1.4.11');
// chromeVersion is "53.0.2785.143"
```
If a query does not match a Chromium version, it will return `undefined`.
```js
var chromeVersion = e2c.electronToChromium('9000');
// chromeVersion is undefined
```
#### electronToBrowserList(query)
Arguments:
* Query: string or number, required. A major Electron version.
A function that returns a [Browserlist](https://github.com/ai/browserslist) query that matches the given major Electron version. Returns a string.
If you provide it with a major Electron version, it will return a Browserlist query string that matches the chromium capabilities:
```js
var query = e2c.electronToBrowserList('1.4');
// query is "Chrome >= 53"
```
If a query does not match a Chromium version, it will return `undefined`.
```js
var query = e2c.electronToBrowserList('9000');
// query is undefined
```
### importing just versions or fullVersions
Both the versions and the fullVersions list can be imported on their own, if file-size is a concern.
### versions
```js
var versions = require('electron-to-chromium/versions');
```
### fullVersions
```js
var fullVersions = require('electron-to-chromium/full-versions');
```
## Updating
This package will be updated with each new Electron release.
To update the list, run `npm run build.js`. Requires internet access as it downloads from the canonical list of Electron versions.