3dfef4a376
* chore: Add new webFrame IsolatedWorldInfo API and deprecate * Flag deprecated methods in documentation * address comments * Address review comments * remove unused variable * Update based on review
85 lines
2.4 KiB
JavaScript
85 lines
2.4 KiB
JavaScript
'use strict'
|
|
|
|
const { EventEmitter } = require('events')
|
|
const binding = process.atomBinding('web_frame')
|
|
const { deprecate } = require('electron')
|
|
|
|
class WebFrame extends EventEmitter {
|
|
constructor (context) {
|
|
super()
|
|
|
|
this.context = context
|
|
// Lots of webview would subscribe to webFrame's events.
|
|
this.setMaxListeners(0)
|
|
}
|
|
|
|
findFrameByRoutingId (...args) {
|
|
return getWebFrame(binding._findFrameByRoutingId(this.context, ...args))
|
|
}
|
|
|
|
getFrameForSelector (...args) {
|
|
return getWebFrame(binding._getFrameForSelector(this.context, ...args))
|
|
}
|
|
|
|
findFrameByName (...args) {
|
|
return getWebFrame(binding._findFrameByName(this.context, ...args))
|
|
}
|
|
|
|
get opener () {
|
|
return getWebFrame(binding._getOpener(this.context))
|
|
}
|
|
|
|
get parent () {
|
|
return getWebFrame(binding._getParent(this.context))
|
|
}
|
|
|
|
get top () {
|
|
return getWebFrame(binding._getTop(this.context))
|
|
}
|
|
|
|
get firstChild () {
|
|
return getWebFrame(binding._getFirstChild(this.context))
|
|
}
|
|
|
|
get nextSibling () {
|
|
return getWebFrame(binding._getNextSibling(this.context))
|
|
}
|
|
|
|
get routingId () {
|
|
return binding._getRoutingId(this.context)
|
|
}
|
|
|
|
// Deprecations
|
|
// TODO(nitsakh): Remove in 6.0
|
|
setIsolatedWorldSecurityOrigin (worldId, securityOrigin) {
|
|
deprecate.warn('webFrame.setIsolatedWorldSecurityOrigin', 'webFrame.setIsolatedWorldInfo')
|
|
binding._setIsolatedWorldSecurityOrigin(this.context, worldId, securityOrigin)
|
|
}
|
|
|
|
setIsolatedWorldContentSecurityPolicy (worldId, csp) {
|
|
deprecate.warn('webFrame.setIsolatedWorldContentSecurityPolicy', 'webFrame.setIsolatedWorldInfo')
|
|
binding._setIsolatedWorldContentSecurityPolicy(this.context, worldId, csp)
|
|
}
|
|
|
|
setIsolatedWorldHumanReadableName (worldId, name) {
|
|
deprecate.warn('webFrame.setIsolatedWorldHumanReadableName', 'webFrame.setIsolatedWorldInfo')
|
|
binding._setIsolatedWorldHumanReadableName(this.context, worldId, name)
|
|
}
|
|
}
|
|
|
|
// Populate the methods.
|
|
for (const name in binding) {
|
|
if (!name.startsWith('_')) { // some methods are manully populated above
|
|
WebFrame.prototype[name] = function (...args) {
|
|
return binding[name](this.context, ...args)
|
|
}
|
|
}
|
|
}
|
|
|
|
// Helper to return WebFrame or null depending on context.
|
|
// TODO(zcbenz): Consider returning same WebFrame for the same frame.
|
|
function getWebFrame (context) {
|
|
return context ? new WebFrame(context) : null
|
|
}
|
|
|
|
module.exports = new WebFrame(window)
|