electron/lib/browser/guest-view-manager.js

339 lines
10 KiB
JavaScript
Raw Normal View History

'use strict'
2016-03-18 18:51:02 +00:00
2016-11-03 17:51:13 +00:00
const {ipcMain, webContents} = require('electron')
2016-10-25 01:21:42 +00:00
const parseFeaturesString = require('../common/parse-features-string')
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Doesn't exist in early initialization.
2016-06-07 17:29:24 +00:00
let webViewManager = null
2016-01-12 02:40:23 +00:00
2016-06-07 17:29:24 +00:00
const supportedWebViewEvents = [
2016-01-25 16:37:15 +00:00
'load-commit',
'did-attach',
2016-01-25 16:37:15 +00:00
'did-finish-load',
'did-fail-load',
'did-frame-finish-load',
'did-start-loading',
'did-stop-loading',
'dom-ready',
'console-message',
'context-menu',
2016-01-25 16:37:15 +00:00
'devtools-opened',
'devtools-closed',
'devtools-focused',
'new-window',
'will-navigate',
'did-start-navigation',
2016-01-25 16:37:15 +00:00
'did-navigate',
'did-frame-navigate',
2016-01-25 16:37:15 +00:00
'did-navigate-in-page',
'close',
'crashed',
'gpu-crashed',
'plugin-crashed',
'destroyed',
'page-title-updated',
'page-favicon-updated',
'enter-html-full-screen',
'leave-html-full-screen',
'media-started-playing',
'media-paused',
'found-in-page',
2016-06-07 06:56:19 +00:00
'did-change-theme-color',
'update-target-url'
]
2016-01-12 02:40:23 +00:00
let nextGuestInstanceId = 0
2016-06-07 17:29:24 +00:00
const guestInstances = {}
const embedderElementsMap = {}
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Generate guestInstanceId.
const getNextGuestInstanceId = function () {
return ++nextGuestInstanceId
}
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Create a new guest instance.
2016-06-07 17:29:24 +00:00
const createGuest = function (embedder, params) {
2016-01-12 02:40:23 +00:00
if (webViewManager == null) {
webViewManager = process.atomBinding('web_view_manager')
2016-01-12 02:40:23 +00:00
}
2016-06-07 17:24:48 +00:00
const guestInstanceId = getNextGuestInstanceId(embedder)
2016-06-07 17:24:48 +00:00
const guest = webContents.create({
isGuest: true,
2016-01-12 02:40:23 +00:00
partition: params.partition,
embedder: embedder
})
guestInstances[guestInstanceId] = {
2016-01-12 02:40:23 +00:00
guest: guest,
embedder: embedder
}
2016-01-12 02:40:23 +00:00
// Clear the guest from map when it is destroyed.
guest.once('destroyed', () => {
if (guestInstanceId in guestInstances) {
detachGuest(embedder, guestInstanceId)
}
})
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Init guest web view after attached.
guest.once('did-attach', function (event) {
params = this.attachParams
delete this.attachParams
const previouslyAttached = this.viewInstanceId != null
this.viewInstanceId = params.instanceId
// Only load URL and set size on first attach
if (previouslyAttached) {
return
}
2016-01-12 02:40:23 +00:00
if (params.src) {
2016-11-03 17:39:40 +00:00
const opts = {}
2016-01-12 02:40:23 +00:00
if (params.httpreferrer) {
opts.httpReferrer = params.httpreferrer
2016-01-12 02:40:23 +00:00
}
if (params.useragent) {
opts.userAgent = params.useragent
2016-01-12 02:40:23 +00:00
}
this.loadURL(params.src, opts)
2016-01-12 02:40:23 +00:00
}
2016-03-29 00:40:40 +00:00
guest.allowPopups = params.allowpopups
2017-10-06 16:31:41 +00:00
embedder.emit('did-attach-webview', event, guest)
})
2016-01-12 02:40:23 +00:00
2016-11-03 17:39:40 +00:00
const sendToEmbedder = (channel, ...args) => {
if (!embedder.isDestroyed()) {
2016-11-03 17:39:40 +00:00
embedder.send(`${channel}-${guest.viewInstanceId}`, ...args)
}
}
2016-01-14 18:35:29 +00:00
// Dispatch events to embedder.
2016-06-07 17:24:48 +00:00
const fn = function (event) {
guest.on(event, function (_, ...args) {
2016-11-03 17:39:40 +00:00
sendToEmbedder('ELECTRON_GUEST_VIEW_INTERNAL_DISPATCH_EVENT', event, ...args)
})
}
2016-06-07 17:24:48 +00:00
for (const event of supportedWebViewEvents) {
fn(event)
2016-01-12 02:40:23 +00:00
}
2016-01-14 18:35:29 +00:00
// Dispatch guest's IPC messages to embedder.
guest.on('ipc-message-host', function (_, [channel, ...args]) {
2016-11-03 17:39:40 +00:00
sendToEmbedder('ELECTRON_GUEST_VIEW_INTERNAL_IPC_MESSAGE', channel, ...args)
})
2016-01-12 02:40:23 +00:00
// Notify guest of embedder window visibility when it is ready
2017-06-14 21:12:51 +00:00
// FIXME Remove once https://github.com/electron/electron/issues/6828 is fixed
guest.on('dom-ready', function () {
const guestInstance = guestInstances[guestInstanceId]
if (guestInstance != null && guestInstance.visibilityState != null) {
guest.send('ELECTRON_GUEST_INSTANCE_VISIBILITY_CHANGE', guestInstance.visibilityState)
}
})
// Forward internal web contents event to embedder to handle
// native window.open setup
guest.on('-add-new-contents', (...args) => {
if (guest.getLastWebPreferences().nativeWindowOpen === true) {
const embedder = getEmbedder(guestInstanceId)
if (embedder != null) {
embedder.emit('-add-new-contents', ...args)
}
}
})
guest.on('-web-contents-created', (...args) => {
if (guest.getLastWebPreferences().nativeWindowOpen === true) {
const embedder = getEmbedder(guestInstanceId)
if (embedder != null) {
embedder.emit('-web-contents-created', ...args)
}
}
})
return guestInstanceId
}
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Attach the guest to an element of embedder.
const attachGuest = function (event, embedderFrameId, elementInstanceId, guestInstanceId, params) {
const embedder = event.sender
2016-01-14 18:35:29 +00:00
// Destroy the old guest when attaching.
const key = `${embedder.id}-${elementInstanceId}`
2016-11-03 17:39:40 +00:00
const oldGuestInstanceId = embedderElementsMap[key]
2016-01-12 02:40:23 +00:00
if (oldGuestInstanceId != null) {
// Reattachment to the same guest is just a no-op.
2016-01-12 02:40:23 +00:00
if (oldGuestInstanceId === guestInstanceId) {
return
2016-01-12 02:40:23 +00:00
}
const oldGuestInstance = guestInstances[oldGuestInstanceId]
if (oldGuestInstance) {
oldGuestInstance.guest.destroy()
}
2016-01-12 02:40:23 +00:00
}
2016-11-03 17:39:40 +00:00
const guestInstance = guestInstances[guestInstanceId]
// If this isn't a valid guest instance then do nothing.
if (!guestInstance) {
return
}
2016-11-03 17:39:40 +00:00
const {guest} = guestInstance
// If this guest is already attached to an element then remove it
if (guestInstance.elementInstanceId) {
const oldKey = `${guestInstance.embedder.id}-${guestInstance.elementInstanceId}`
delete embedderElementsMap[oldKey]
// Remove guest from embedder if moving across web views
if (guest.viewInstanceId !== params.instanceId) {
webViewManager.removeGuest(guestInstance.embedder, guestInstanceId)
guestInstance.embedder.send(`ELECTRON_GUEST_VIEW_INTERNAL_DESTROY_GUEST-${guest.viewInstanceId}`)
}
}
2016-11-03 17:39:40 +00:00
const webPreferences = {
2016-01-12 02:40:23 +00:00
guestInstanceId: guestInstanceId,
2016-11-03 17:39:40 +00:00
nodeIntegration: params.nodeintegration != null ? params.nodeintegration : false,
2016-01-12 02:40:23 +00:00
plugins: params.plugins,
zoomFactor: embedder._getZoomFactor(),
2016-01-21 10:13:41 +00:00
webSecurity: !params.disablewebsecurity,
enableBlinkFeatures: params.blinkfeatures,
2016-06-07 23:35:23 +00:00
disableBlinkFeatures: params.disableblinkfeatures
}
// parse the 'webpreferences' attribute string, if set
// this uses the same parsing rules as window.open uses for its features
if (typeof params.webpreferences === 'string') {
2016-10-25 01:21:42 +00:00
parseFeaturesString(params.webpreferences, function (key, value) {
if (value === undefined) {
// no value was specified, default it to true
value = true
}
webPreferences[key] = value
2016-10-25 01:21:42 +00:00
})
}
2016-01-12 02:40:23 +00:00
if (params.preload) {
webPreferences.preloadURL = params.preload
2016-01-12 02:40:23 +00:00
}
// Return null from native window.open if allowpopups is unset
if (webPreferences.nativeWindowOpen === true && !params.allowpopups) {
webPreferences.disablePopups = true
}
// Security options that guest will always inherit from embedder
const inheritedWebPreferences = new Map([
['contextIsolation', true],
['javascript', false],
['nativeWindowOpen', true],
['nodeIntegration', false],
['sandbox', true]
])
// Inherit certain option values from embedder
const lastWebPreferences = embedder.getLastWebPreferences()
for (const [name, value] of inheritedWebPreferences) {
if (lastWebPreferences[name] === value) {
webPreferences[name] = value
}
}
2017-02-09 19:48:45 +00:00
embedder.emit('will-attach-webview', event, webPreferences, params)
if (event.defaultPrevented) {
if (guest.viewInstanceId == null) guest.viewInstanceId = params.instanceId
guest.destroy()
return
}
guest.attachParams = params
embedderElementsMap[key] = guestInstanceId
guest.setEmbedder(embedder)
guestInstance.embedder = embedder
guestInstance.elementInstanceId = elementInstanceId
watchEmbedder(embedder)
2016-01-12 02:40:23 +00:00
webViewManager.addGuest(guestInstanceId, elementInstanceId, embedder, guest, webPreferences)
guest.attachToIframe(embedder, embedderFrameId)
}
// Remove an guest-embedder relationship.
const detachGuest = function (embedder, guestInstanceId) {
2016-11-03 17:39:40 +00:00
const guestInstance = guestInstances[guestInstanceId]
if (embedder !== guestInstance.embedder) {
return
}
webViewManager.removeGuest(embedder, guestInstanceId)
delete guestInstances[guestInstanceId]
const key = `${embedder.id}-${guestInstance.elementInstanceId}`
2016-11-03 17:19:52 +00:00
delete embedderElementsMap[key]
}
// Once an embedder has had a guest attached we watch it for destruction to
// destroy any remaining guests.
const watchedEmbedders = new Set()
const watchEmbedder = function (embedder) {
if (watchedEmbedders.has(embedder)) {
return
}
watchedEmbedders.add(embedder)
// Forward embedder window visiblity change events to guest
const onVisibilityChange = function (visibilityState) {
for (const guestInstanceId in guestInstances) {
const guestInstance = guestInstances[guestInstanceId]
guestInstance.visibilityState = visibilityState
if (guestInstance.embedder === embedder) {
guestInstance.guest.send('ELECTRON_GUEST_INSTANCE_VISIBILITY_CHANGE', visibilityState)
}
}
}
embedder.on('-window-visibility-change', onVisibilityChange)
embedder.once('will-destroy', () => {
// Usually the guestInstances is cleared when guest is destroyed, but it
// may happen that the embedder gets manually destroyed earlier than guest,
// and the embedder will be invalid in the usual code path.
for (const guestInstanceId in guestInstances) {
const guestInstance = guestInstances[guestInstanceId]
if (guestInstance.embedder === embedder) {
detachGuest(embedder, parseInt(guestInstanceId))
}
}
// Clear the listeners.
embedder.removeListener('-window-visibility-change', onVisibilityChange)
watchedEmbedders.delete(embedder)
})
}
2016-01-12 02:40:23 +00:00
ipcMain.on('ELECTRON_GUEST_VIEW_MANAGER_CREATE_GUEST', function (event, params, requestId) {
2016-11-03 17:39:40 +00:00
event.sender.send(`ELECTRON_RESPONSE_${requestId}`, createGuest(event.sender, params))
})
2016-01-12 02:40:23 +00:00
ipcMain.on('ELECTRON_GUEST_VIEW_MANAGER_CREATE_GUEST_SYNC', function (event, params) {
event.returnValue = createGuest(event.sender, params)
})
ipcMain.on('ELECTRON_GUEST_VIEW_MANAGER_ATTACH_GUEST', function (event, embedderFrameId, elementInstanceId, guestInstanceId, params) {
attachGuest(event, embedderFrameId, elementInstanceId, guestInstanceId, params)
})
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Returns WebContents from its guest id.
2016-11-03 17:39:40 +00:00
const getGuest = function (guestInstanceId) {
const guestInstance = guestInstances[guestInstanceId]
if (guestInstance != null) return guestInstance.guest
}
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Returns the embedder of the guest.
const getEmbedder = function (guestInstanceId) {
const guestInstance = guestInstances[guestInstanceId]
if (guestInstance != null) return guestInstance.embedder
}
2016-11-03 17:39:40 +00:00
exports.getGuest = getGuest
exports.getEmbedder = getEmbedder