diff --git a/extension/docs/Architecture.md b/extension/docs/Architecture.md index db7529e9..1c8137e1 100644 --- a/extension/docs/Architecture.md +++ b/extension/docs/Architecture.md @@ -2,28 +2,36 @@ This document exists to keep track of how the different parts of the Redux DevTools interact, since it's easy to forget how it all works together. This is intended for internal purposes and is just a collection of notes to myself. -## Scripts +## Entry Points -### Window View +### Window This is the default view that is shown in the Redux DevTools popup, the Chrome DevTools tab (if direct access to the background page is available), and new popup windows that are created. It has direct access to the background page via `chrome.runtime.getBackgroundPage`. -### DevPanel View +### DevPanel This is the view that is shown in the Chrome DevTools tab if direct access to the background page is not available. Initially this was the view that was always used for the Chrome DevTools tab, but when support to directly access the background page from the DevTools tab was added, [the Window View became the preferred view](https://github.com/zalmoxisus/redux-devtools-extension/pull/580). -### Remote View +### Remote This does not interact with the other parts of the extension at all, it just renders the `App` component from `@redux-devtools/app`. It can be triggered by hitting the "Remote" button in any of the other views, which calls `chrome.windows.create` and creates a new window. -### Devtools Script +### DevTools This is the script that adds the Redux panel in the Chrome DevTools using `chrome.devtools.panels.create`. It creates a Window View if it has direct access to the background page, otherwise it creates a DevPanel View. Note that this used to always show the DevPanel View, but [started using the Window View by default](https://github.com/zalmoxisus/redux-devtools-extension/pull/580) once direct access to the background page was added to Chrome DevTools tabs. + +### Content Script + +Passes messages between the injected page script and the background page. + +It listens for messages from the injected page script using `window.addEventListener('message', ...)`. It knows the message is from the injected page script if `message.source` is `'@devtools-page'`. See the Chrome DevTools docs where this approach [is documented](https://developer.chrome.com/docs/extensions/how-to/devtools/extend-devtools#evaluated-scripts-to-devtools). + +It creates a connection to the background page using `chrome.runtime.connect` with the name `'tab'` when it receives the first message from the injected page script.