mirror of https://github.com/electron/electron.git synced 2026-02-26 03:01:17 -05:00

Files

Samuel Attard 976c7d122a feat: add a new contextBridge module (#20789 )

* feat: add a new contextBridge module (#20307)

* feat: add a new contextBridge module

* chore: fix docs linting

* feat: add support for function arguments being proxied

* chore: ensure that contextBridge can only be used when contextIsolation is enabled

* docs: getReverseBinding can be null

* docs: fix broken links in md file

* feat: add support for promises in function parameters

* fix: linting failure for explicit constructor

* Update atom_api_context_bridge.cc

* chore: update docs and API design as per feedback

* refactor: remove reverse bindings and handle GC'able functions across the bridge

* chore: only expose debugGC in testing builds

* fix: do not proxy promises as objects

* spec: add complete spec coverage for contextBridge

* spec: add tests for null/undefined and the anti-overwrite logic

* chore: fix linting

* spec: add complex nested back-and-forth function calling

* fix: expose contextBridge in sandboxed renderers

* refactor: improve security of default_app using the new contextBridge module

* s/bindAPIInMainWorld/exposeInMainWorld

* chore: sorry for this commit, its a big one, I fixed like everything and refactored a lot

* chore: remove PassedValueCache as it is unused now

Values transferred from context A to context B are now cachde in the RenderFramePersistenceStore

* chore: move to anonymous namespace

* refactor: remove PassValueToOtherContextWithCache

* chore: remove commented unused code blocks

* chore: remove .only

* chore: remote commented code

* refactor: extract RenderFramePersistenceStore

* spec: ensure it works with numbered keys

* fix: handle number keys correctly

* fix: sort out the linter

* spec: update default_app asar spec for removed file

* refactor: change signatures to return v8 objects directly rather than the mate dictionary handle

* refactor: use the v8 serializer to support cloneable buffers and other object types

* chore: fix linting

* fix: handle hash collisions with a linked list in the map

* fix: enforce a recursion limit on the context bridge

* chore: fix linting

* chore: remove TODO

* chore: adapt for PR feedback

* chore: remove .only

* chore: clean up docs and clean up the proxy map when objects are released

* chore: ensure we cache object values that are cloned through the V8 serializer

* docs: mark contextBridge as experimental (#20638)

* docs: mark contextBridge as experimental

This commit didn't make it to the original PR, quick addition here

* Update context-bridge.md

* chore: update for 7-0-x differences

* chore: update callback header

* chore: add v8 serializer converter, cherry picked from 2fad53e66b

* chore: update for 7-0-x differences

2019-11-04 14:56:03 -08:00

api

feat: add a new contextBridge module (#20789 )

2019-11-04 14:56:03 -08:00

development

docs: Update the sccache name (#20860 )

2019-10-30 18:48:55 -04:00

fiddles/screen/fit-screen

docs: add exemplary fiddle for launch in fiddle feat (#19785 )

2019-08-16 08:56:18 -07:00

images

docs: Performance checklist (#20757 )

2019-10-28 09:56:55 -04:00

tutorial

docs: clean up performance checklist formatting (#20887 )

2019-10-31 09:52:42 -07:00

faq.md

docs: fix spelling and grammar errors (#18910 )

2019-06-21 16:19:21 -05:00

glossary.md

refactor: eliminate brightray (#15240 )

2018-10-24 12:49:10 +02:00

README.md

docs: add the performance doc to the table of contents (#20748 )

2019-10-28 10:27:35 -04:00

styleguide.md

docs: differentiate static/instance class props (#19196 )

2019-07-15 10:15:32 -07:00

README.md

Official Guides

Please make sure that you use the documents that match your Electron version. The version number should be a part of the page URL. If it's not, you are probably using the documentation of a development branch which may contain API changes that are not compatible with your Electron version. To view older versions of the documentation, you can browse by tag on GitHub by opening the "Switch branches/tags" dropdown and selecting the tag that matches your version.

FAQ

There are questions that are asked quite often. Check this out before creating an issue:

README.md

Official Guides

FAQ

Guides and Tutorials

Detailed Tutorials

API References

Custom DOM Elements:

Modules for the Main Process:

Modules for the Renderer Process (Web Page):

Modules for Both Processes:

Development