webFrame.executeJavaScriptInIsolatedWorld isn't well documented.

[TheGoddessInari]

• Output of node_modules/.bin/electron --version: 2.0.8
• Operating System (Platform and Version): Windows 10 x64

Expected Behavior
executeJavaScriptInIsolatedWorld should be well documented

Actual behavior
executeJavaScriptInIsolatedWorld is barely documented

To Reproduce
Read the webFrame documentation.
Additional Information
If I enable contextIsolation in my app, how do I execute javascript into the correct context for a specific webview?

I understand that the JS needs to be akin to [{code: 'blahblahblah' }], but world_id doesn't seem to be the id from webContents, so what is it? Where do I obtain the correct id?

[TheGoddessInari]

According to the pull request, this is for 'isolated world', but the documentation says 'isolated context', which confused me.

[TheGoddessInari]

Shouldn't context isolation have its own (isolated) context per webview?

That's what all of the documentation alludes to, it even says you have access to window and document.

If I use 999, it simply executes in the global main-window JS, unisolated.

This doesn't seem right.

[TheGoddessInari]

Oh, I see. webFrame can't get a webview, webview can't get an appropriate webFrame. In my app, names are generated after what they're loading, and I (obviously) can't get routing ids. There seems to be no way to get the appropriate webFrame from the available functions and properties.

Is the real issue here that the API needs to bubble down sanely to webview/webContents like "executeJavaScript" already does?

Because the docs make it clear that I should be using contextIsolation for untrusted remote content, but there doesn't seem to be any way to actually execute javascript in the isolated contexts unless I somehow manually name my webFrames to match them later, which also appears undocumented.