electron/docs/api/web-frame.md

149 lines
3.6 KiB
Markdown
Raw Normal View History

2015-08-29 06:20:49 +00:00
# webFrame
2014-06-16 06:56:24 +00:00
2016-04-21 22:39:12 +00:00
> Customize the rendering of the current web page.
2014-06-16 06:56:24 +00:00
An example of zooming current page to 200%.
```javascript
const {webFrame} = require('electron');
2015-08-29 06:20:49 +00:00
2014-10-24 10:24:12 +00:00
webFrame.setZoomFactor(2);
2014-06-16 06:56:24 +00:00
```
2015-08-29 06:20:49 +00:00
## Methods
2016-04-26 17:28:04 +00:00
The `webFrame` module has the following methods:
2015-08-29 06:20:49 +00:00
### `webFrame.setZoomFactor(factor)`
2014-06-16 06:56:24 +00:00
2015-08-29 06:20:49 +00:00
* `factor` Number - Zoom factor.
2014-06-16 06:56:24 +00:00
2015-09-02 16:57:29 +00:00
Changes the zoom factor to the specified factor. Zoom factor is
zoom percent divided by 100, so 300% = 3.0.
2014-06-16 06:56:24 +00:00
2015-08-29 06:20:49 +00:00
### `webFrame.getZoomFactor()`
2014-06-16 06:56:24 +00:00
Returns the current zoom factor.
2015-08-29 06:20:49 +00:00
### `webFrame.setZoomLevel(level)`
2014-06-16 06:56:24 +00:00
* `level` Number - Zoom level
2015-09-01 03:05:57 +00:00
Changes the zoom level to the specified level. The original size is 0 and each
2014-06-16 06:56:24 +00:00
increment above or below represents zooming 20% larger or smaller to default
limits of 300% and 50% of original size, respectively.
2015-08-29 06:20:49 +00:00
### `webFrame.getZoomLevel()`
2014-06-16 06:56:24 +00:00
Returns the current zoom level.
2014-12-20 06:34:34 +00:00
2015-08-29 06:20:49 +00:00
### `webFrame.setZoomLevelLimits(minimumLevel, maximumLevel)`
2015-08-27 14:08:25 +00:00
* `minimumLevel` Number
* `maximumLevel` Number
Sets the maximum and minimum zoom level.
2015-08-29 06:20:49 +00:00
### `webFrame.setSpellCheckProvider(language, autoCorrectWord, provider)`
2014-12-20 06:34:34 +00:00
* `language` String
* `autoCorrectWord` Boolean
* `provider` Object
Sets a provider for spell checking in input fields and text areas.
The `provider` must be an object that has a `spellCheck` method that returns
whether the word passed is correctly spelled.
An example of using [node-spellchecker][spellchecker] as provider:
```javascript
webFrame.setSpellCheckProvider('en-US', true, {
spellCheck(text) {
2014-12-20 06:34:34 +00:00
return !(require('spellchecker').isMisspelled(text));
}
});
```
2015-11-13 08:03:40 +00:00
### `webFrame.registerURLSchemeAsSecure(scheme)`
* `scheme` String
Registers the `scheme` as secure scheme.
Secure schemes do not trigger mixed content warnings. For example, `https` and
`data` are secure schemes because they cannot be corrupted by active network
attackers.
2015-11-13 08:03:40 +00:00
### `webFrame.registerURLSchemeAsBypassingCSP(scheme)`
* `scheme` String
2015-08-29 06:20:49 +00:00
Resources will be loaded from this `scheme` regardless of the current page's
Content Security Policy.
2015-11-13 08:03:40 +00:00
### `webFrame.registerURLSchemeAsPrivileged(scheme)`
* `scheme` String
Registers the `scheme` as secure, bypasses content security policy for resources,
allows registering ServiceWorker and supports fetch API.
2016-01-13 03:21:16 +00:00
### `webFrame.insertText(text)`
* `text` String
2016-01-13 03:55:49 +00:00
Inserts `text` to the focused element.
2016-01-13 03:21:16 +00:00
2016-01-13 04:20:49 +00:00
### `webFrame.executeJavaScript(code[, userGesture])`
* `code` String
* `userGesture` Boolean (optional) - Default is `false`.
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.
2016-05-12 22:03:47 +00:00
### `webFrame.getResourceUsage()`
Returns an object describing usage information of Blink's internal memory
caches.
2016-05-12 22:03:47 +00:00
```javascript
console.log(webFrame.getResourceUsage())
```
This will generate:
```javascript
2016-05-12 22:03:47 +00:00
{
images: {
count: 22,
size: 2549,
liveSize: 2542,
decodedSize: 478,
purgedSize: 0,
purgeableSize: 0
2016-05-12 22:03:47 +00:00
},
cssStyleSheets: { /* same with "images" */ },
xslStyleSheets: { /* same with "images" */ },
fonts: { /* same with "images" */ },
other: { /* same with "images" */ },
2016-05-12 22:03:47 +00:00
}
```
### `webFrame.clearCache()`
2016-05-12 22:03:47 +00:00
Attempts to free memory that is no longer being used (like images from a
previous navigation).
2016-05-12 22:03:47 +00:00
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 occured 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).
2016-05-12 22:03:47 +00:00
2014-12-20 06:34:34 +00:00
[spellchecker]: https://github.com/atom/node-spellchecker