mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-12-03 02:25:34 +00:00
e5a63697bf
Make it a synced field on the top browsing context. This handling the propagation right and is much simpler. This should fix cases where we don't look at the top level docshell to figure out if we should suspend media. Differential Revision: https://phabricator.services.mozilla.com/D94878
1069 lines
42 KiB
C++
1069 lines
42 KiB
C++
/* -*- Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil; tab-width: 8 -*- */
|
|
/* vim: set sw=2 ts=8 et tw=80 ft=cpp : */
|
|
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
include protocol PColorPicker;
|
|
include protocol PContent;
|
|
#ifdef ACCESSIBILITY
|
|
include protocol PDocAccessible;
|
|
#endif
|
|
include protocol PFilePicker;
|
|
include protocol PPluginWidget;
|
|
include protocol PRemotePrintJob;
|
|
include protocol PChildToParentStream;
|
|
include protocol PParentToChildStream;
|
|
include protocol PFileDescriptorSet;
|
|
include protocol PRemoteLazyInputStream;
|
|
include protocol PPaymentRequest;
|
|
include protocol PWindowGlobal;
|
|
include protocol PBrowserBridge;
|
|
|
|
include DOMTypes;
|
|
include WindowGlobalTypes;
|
|
include IPCBlob;
|
|
include IPCStream;
|
|
include URIParams;
|
|
include PPrintingTypes;
|
|
include PTabContext;
|
|
include PBackgroundSharedTypes;
|
|
|
|
include "mozilla/AntiTrackingIPCUtils.h";
|
|
include "mozilla/dom/TabMessageUtils.h";
|
|
include "mozilla/GfxMessageUtils.h";
|
|
include "mozilla/LayoutMessageUtils.h";
|
|
include "mozilla/layers/LayersMessageUtils.h";
|
|
include "mozilla/ipc/TransportSecurityInfoUtils.h";
|
|
|
|
using mozilla::gfx::Matrix4x4 from "mozilla/gfx/Matrix.h";
|
|
using mozilla::gfx::MaybeMatrix4x4 from "mozilla/gfx/Matrix.h";
|
|
using mozilla::gfx::SurfaceFormat from "mozilla/gfx/Types.h";
|
|
using mozilla::LayoutDeviceIntPoint from "Units.h";
|
|
using mozilla::LayoutDevicePoint from "Units.h";
|
|
using mozilla::ScreenIntCoord from "Units.h";
|
|
using mozilla::ScreenIntMargin from "Units.h";
|
|
using mozilla::ScreenIntPoint from "Units.h";
|
|
using ScreenRect from "Units.h";
|
|
using struct mozilla::layers::ScrollableLayerGuid from "mozilla/layers/ScrollableLayerGuid.h";
|
|
using struct mozilla::layers::ZoomConstraints from "mozilla/layers/ZoomConstraints.h";
|
|
using mozilla::layers::LayersId from "mozilla/layers/LayersTypes.h";
|
|
using mozilla::layers::LayersObserverEpoch from "mozilla/layers/LayersTypes.h";
|
|
using mozilla::layers::MaybeZoomConstraints from "mozilla/layers/ZoomConstraints.h";
|
|
using mozilla::layers::GeckoContentController_TapType from "mozilla/layers/GeckoContentControllerTypes.h";
|
|
using ScrollableLayerGuid::ViewID from "mozilla/layers/ScrollableLayerGuid.h";
|
|
using struct mozilla::void_t from "ipc/IPCMessageUtils.h";
|
|
using mozilla::WindowsHandle from "ipc/IPCMessageUtils.h";
|
|
using class mozilla::WidgetCompositionEvent from "ipc/nsGUIEventIPC.h";
|
|
using struct mozilla::widget::IMENotification from "mozilla/widget/IMEData.h";
|
|
using struct mozilla::widget::IMENotificationRequests from "mozilla/widget/IMEData.h";
|
|
using struct mozilla::widget::IMEState from "mozilla/widget/IMEData.h";
|
|
using struct mozilla::widget::InputContext from "mozilla/widget/IMEData.h";
|
|
using struct mozilla::widget::InputContextAction from "mozilla/widget/IMEData.h";
|
|
using mozilla::gfx::IntSize from "mozilla/gfx/Point.h";
|
|
using mozilla::gfx::IntPoint from "mozilla/gfx/Point.h";
|
|
using class mozilla::ContentCache from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::WidgetKeyboardEvent from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::WidgetMouseEvent from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::WidgetWheelEvent from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::WidgetDragEvent from "ipc/nsGUIEventIPC.h";
|
|
using struct nsRect from "nsRect.h";
|
|
using class mozilla::WidgetSelectionEvent from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::WidgetTouchEvent from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::WidgetPluginEvent from "ipc/nsGUIEventIPC.h";
|
|
using struct mozilla::dom::RemoteDOMEvent from "mozilla/dom/TabMessageTypes.h";
|
|
using struct mozilla::layers::TextureFactoryIdentifier from "mozilla/layers/CompositorTypes.h";
|
|
using mozilla::layers::CompositorOptions from "mozilla/layers/CompositorOptions.h";
|
|
using mozilla::CSSToScreenScale from "Units.h";
|
|
using mozilla::CommandInt from "mozilla/EventForwards.h";
|
|
using nsIWidget::TouchPointerState from "nsIWidget.h";
|
|
using nsCursor from "nsIWidget.h";
|
|
using struct LookAndFeelInt from "mozilla/widget/WidgetMessageUtils.h";
|
|
using class mozilla::dom::MessagePort from "mozilla/dom/MessagePort.h";
|
|
using class mozilla::dom::ipc::StructuredCloneData from "mozilla/dom/ipc/StructuredCloneData.h";
|
|
using mozilla::EventMessage from "mozilla/EventForwards.h";
|
|
using nsEventStatus from "mozilla/EventForwards.h";
|
|
using mozilla::Modifiers from "mozilla/EventForwards.h";
|
|
using mozilla::widget::CandidateWindowPosition from "ipc/nsGUIEventIPC.h";
|
|
using class mozilla::NativeEventData from "ipc/nsGUIEventIPC.h";
|
|
using mozilla::FontRange from "ipc/nsGUIEventIPC.h";
|
|
using mozilla::a11y::IAccessibleHolder from "mozilla/a11y/IPCTypes.h";
|
|
using mozilla::OriginAttributes from "mozilla/ipc/BackgroundUtils.h";
|
|
using mozilla::dom::EffectsInfo from "mozilla/dom/EffectsInfo.h";
|
|
using mozilla::dom::TabId from "mozilla/dom/ipc/IdType.h";
|
|
using mozilla::ScrollAxis from "mozilla/PresShellForwards.h";
|
|
using mozilla::ScrollFlags from "mozilla/PresShellForwards.h";
|
|
using struct InputFormData from "mozilla/dom/SessionStoreMessageUtils.h";
|
|
using struct CollectedInputDataValue from "mozilla/dom/SessionStoreMessageUtils.h";
|
|
using mozilla::ContentBlockingNotifier::StorageAccessPermissionGrantedReason from "mozilla/ContentBlockingNotifier.h";
|
|
using CallerType from "mozilla/dom/BindingDeclarations.h";
|
|
using mozilla::dom::EmbedderElementEventType from "mozilla/dom/TabMessageTypes.h";
|
|
using refcounted class nsDocShellLoadState from "nsDocShellLoadState.h";
|
|
using mozilla::IntrinsicSize from "nsIFrame.h";
|
|
using mozilla::AspectRatio from "mozilla/AspectRatio.h";
|
|
|
|
namespace mozilla {
|
|
namespace dom {
|
|
|
|
struct WebProgressData
|
|
{
|
|
bool isTopLevel;
|
|
bool isLoadingDocument;
|
|
uint32_t loadType;
|
|
};
|
|
|
|
struct RequestData
|
|
{
|
|
nsIURI requestURI;
|
|
nsIURI originalRequestURI;
|
|
nsCString matchedList;
|
|
};
|
|
|
|
struct WebProgressStateChangeData
|
|
{
|
|
bool isNavigating;
|
|
bool mayEnableCharacterEncodingMenu;
|
|
bool charsetAutodetected;
|
|
|
|
// The following fields are only set when the aStateFlags param passed with
|
|
// this struct is |nsIWebProgress.STATE_STOP|.
|
|
nsString contentType;
|
|
nsString charset;
|
|
nsIURI documentURI;
|
|
};
|
|
|
|
struct WebProgressLocationChangeData
|
|
{
|
|
bool isNavigating;
|
|
bool isSyntheticDocument;
|
|
bool mayEnableCharacterEncodingMenu;
|
|
bool charsetAutodetected;
|
|
nsString contentType;
|
|
nsString title;
|
|
nsString charset;
|
|
nsIURI documentURI;
|
|
nsIPrincipal contentPrincipal;
|
|
nsIPrincipal contentPartitionedPrincipal;
|
|
nsIContentSecurityPolicy csp;
|
|
nsIReferrerInfo referrerInfo;
|
|
uint64_t? requestContextID;
|
|
};
|
|
|
|
/**
|
|
* If creating the print preview document or updating it with new print
|
|
* settings fails, sheetCount will be zero.
|
|
*/
|
|
struct PrintPreviewResultInfo
|
|
{
|
|
uint32_t sheetCount;
|
|
uint32_t totalPageCount;
|
|
bool hasSelection;
|
|
};
|
|
|
|
/**
|
|
* A PBrowser manages a maximal locally connected subtree of BrowsingContexts
|
|
* in a content process.
|
|
*
|
|
* See `dom/docs/Fission-IPC-Diagram.svg` for an overview of the DOM IPC
|
|
* actors.
|
|
*/
|
|
nested(upto inside_cpow) sync refcounted protocol PBrowser
|
|
{
|
|
manager PContent;
|
|
|
|
manages PColorPicker;
|
|
|
|
#ifdef ACCESSIBILITY
|
|
manages PDocAccessible;
|
|
#endif
|
|
|
|
manages PFilePicker;
|
|
manages PPluginWidget;
|
|
manages PPaymentRequest;
|
|
manages PWindowGlobal;
|
|
manages PBrowserBridge;
|
|
|
|
both:
|
|
async AsyncMessage(nsString aMessage, ClonedMessageData aData);
|
|
|
|
parent:
|
|
#ifdef ACCESSIBILITY
|
|
/**
|
|
* Tell the parent process a new accessible document has been created.
|
|
* aParentDoc is the accessible document it was created in if any, and
|
|
* aParentAcc is the id of the accessible in that document the new document
|
|
* is a child of. aMsaaID is the MSAA id for this content process, and
|
|
* is only valid on Windows. Set to 0 on other platforms. aDocCOMProxy
|
|
* is also Windows-specific and should be set to 0 on other platforms.
|
|
*/
|
|
async PDocAccessible(nullable PDocAccessible aParentDoc, uint64_t aParentAcc,
|
|
uint32_t aMsaaID, IAccessibleHolder aDocCOMProxy);
|
|
#endif
|
|
|
|
/*
|
|
* Creates a new remoted nsIWidget connection for windowed plugins
|
|
* in e10s mode. This is always initiated from the child in response
|
|
* to windowed plugin creation.
|
|
*/
|
|
sync PPluginWidget();
|
|
|
|
async PPaymentRequest();
|
|
|
|
/**
|
|
* Sends an NS_NATIVE_CHILD_OF_SHAREABLE_WINDOW to be adopted by the
|
|
* widget's shareable window on the chrome side. Only used on Windows.
|
|
*/
|
|
async SetNativeChildOfShareableWindow(uintptr_t childWindow);
|
|
|
|
/**
|
|
* When content moves focus from a native plugin window that's a child
|
|
* of the native browser window we need to move native focus to the
|
|
* browser. Otherwise the plugin window will never relinquish focus.
|
|
*/
|
|
sync DispatchFocusToTopLevelWindow();
|
|
|
|
parent:
|
|
/**
|
|
* When child sends this message, parent should move focus to
|
|
* the next or previous focusable element or document.
|
|
*/
|
|
async MoveFocus(bool forward, bool forDocumentNavigation);
|
|
|
|
/**
|
|
* SizeShellTo request propagation to parent.
|
|
*
|
|
* aFlag Can indicate if one of the dimensions should be ignored.
|
|
* If only one dimension has changed it has to be indicated
|
|
* by the nsIEmbeddingSiteWindow::DIM_FLAGS_IGNORE_* flags.
|
|
* aShellItemWidth,
|
|
* aShellItemHeight On parent side we won't be able to decide the dimensions
|
|
* of the shell item parameter in the original SizeShellTo
|
|
* call so we send over its dimensions that will be used
|
|
* for the actual resize.
|
|
**/
|
|
async SizeShellTo(uint32_t aFlag, int32_t aWidth, int32_t aHeight,
|
|
int32_t aShellItemWidth, int32_t aShellItemHeight);
|
|
|
|
/**
|
|
* Called by the child to inform the parent that links are dropped into
|
|
* content area.
|
|
*
|
|
* aLinks A flat array of url, name, and type for each link
|
|
*/
|
|
async DropLinks(nsString[] aLinks);
|
|
|
|
async Event(RemoteDOMEvent aEvent);
|
|
|
|
sync SyncMessage(nsString aMessage, ClonedMessageData aData)
|
|
returns (StructuredCloneData[] retval);
|
|
|
|
/**
|
|
* Notifies chrome that there is a focus change involving an editable
|
|
* object (input, textarea, document, contentEditable. etc.)
|
|
*
|
|
* contentCache Cache of content
|
|
* notification Whole data of the notification
|
|
* requests Requests of notification for IME of the native widget
|
|
*/
|
|
nested(inside_cpow) async NotifyIMEFocus(ContentCache contentCache,
|
|
IMENotification notification)
|
|
returns (IMENotificationRequests requests);
|
|
|
|
/**
|
|
* Notifies chrome that there has been a change in text content
|
|
* One call can encompass both a delete and an insert operation
|
|
* Only called when NotifyIMEFocus returns PR_TRUE for mWantUpdates
|
|
*
|
|
* contentCache Cache of content
|
|
* notification Whole data of the notification
|
|
*/
|
|
nested(inside_cpow) async NotifyIMETextChange(ContentCache contentCache,
|
|
IMENotification notification);
|
|
|
|
/**
|
|
* Notifies chrome that there is a IME compostion rect updated
|
|
*
|
|
* contentCache Cache of content
|
|
*/
|
|
nested(inside_cpow) async NotifyIMECompositionUpdate(ContentCache contentCache,
|
|
IMENotification notification);
|
|
|
|
/**
|
|
* Notifies chrome that there has been a change in selection
|
|
* Only called when NotifyIMEFocus returns PR_TRUE for mWantUpdates
|
|
*
|
|
* contentCache Cache of content
|
|
* notification Whole data of the notification
|
|
*/
|
|
nested(inside_cpow) async NotifyIMESelection(ContentCache contentCache,
|
|
IMENotification notification);
|
|
|
|
/**
|
|
* Notifies chrome of updating its content cache.
|
|
* This is useful if content is modified but we don't need to notify IME.
|
|
*
|
|
* contentCache Cache of content
|
|
*/
|
|
nested(inside_cpow) async UpdateContentCache(ContentCache contentCache);
|
|
|
|
/**
|
|
* Notifies IME of mouse button event on a character in focused editor.
|
|
*
|
|
* Returns true if the mouse button event is consumed by IME.
|
|
*/
|
|
nested(inside_cpow) sync NotifyIMEMouseButtonEvent(IMENotification notification)
|
|
returns (bool consumedByIME);
|
|
|
|
/**
|
|
* Notifies chrome to position change
|
|
*
|
|
* contentCache Cache of content
|
|
*/
|
|
nested(inside_cpow) async NotifyIMEPositionChange(ContentCache contentCache,
|
|
IMENotification notification);
|
|
|
|
/**
|
|
* Requests chrome to commit or cancel composition of IME.
|
|
*
|
|
* cancel Set true if composition should be cancelled.
|
|
*
|
|
* isCommitted Returns true if the request causes composition
|
|
* being committed synchronously.
|
|
* committedString Returns committed string. The may be non-empty
|
|
* string even if cancel is true because IME may
|
|
* try to restore selected string which was
|
|
* replaced with the composition.
|
|
*/
|
|
nested(inside_cpow) sync RequestIMEToCommitComposition(bool cancel)
|
|
returns (bool isCommitted, nsString committedString);
|
|
|
|
/**
|
|
* OnEventNeedingAckHandled() is called after a child process dispatches a
|
|
* composition event or a selection event which is sent from the parent
|
|
* process.
|
|
*
|
|
* message The message value of the handled event.
|
|
*/
|
|
nested(inside_cpow) async OnEventNeedingAckHandled(EventMessage message);
|
|
|
|
/**
|
|
* Tells chrome to start plugin IME. If this results in a string getting
|
|
* committed, the result is in aCommitted (otherwise aCommitted is empty).
|
|
*
|
|
* aKeyboardEvent The event with which plugin IME is to be started
|
|
* panelX and panelY Location in screen coordinates of the IME input panel
|
|
* (should be just under the plugin)
|
|
* aCommitted The string committed during IME -- otherwise empty
|
|
*/
|
|
nested(inside_cpow) sync StartPluginIME(WidgetKeyboardEvent aKeyboardEvent,
|
|
int32_t panelX, int32_t panelY)
|
|
returns (nsString aCommitted);
|
|
|
|
/**
|
|
* Tells chrome (and specifically the appropriate widget) whether or not
|
|
* a plugin (inside the widget) has the keyboard focus. Should be sent
|
|
* when the keyboard focus changes too or from a plugin.
|
|
*
|
|
* aFocused Whether or not a plugin is focused
|
|
*/
|
|
nested(inside_cpow) async SetPluginFocused(bool aFocused);
|
|
|
|
/**
|
|
* Set IME candidate window by windowless plugin if plugin has focus.
|
|
*/
|
|
async SetCandidateWindowForPlugin(CandidateWindowPosition aPosition);
|
|
|
|
/**
|
|
* Enable or Disable IME by windowless plugin if plugin has focus.
|
|
*/
|
|
async EnableIMEForPlugin(bool aEnable);
|
|
|
|
/**
|
|
* Notifies the parent process of native key event data received in a
|
|
* plugin process directly.
|
|
*
|
|
* aKeyEventData The native key event data. The actual type copied into
|
|
* NativeEventData depending on the caller. Please check
|
|
* PluginInstanceChild.
|
|
*/
|
|
nested(inside_cpow) async OnWindowedPluginKeyEvent(NativeEventData aKeyEventData);
|
|
|
|
/**
|
|
* When plugin event isn't consumed, call this
|
|
*/
|
|
async DefaultProcOfPluginEvent(WidgetPluginEvent aEvent);
|
|
|
|
/**
|
|
* Request that the parent process move focus to the browser's frame. If
|
|
* canRaise is true, the window can be raised if it is inactive.
|
|
*/
|
|
async RequestFocus(bool canRaise, CallerType aCallerType);
|
|
|
|
/**
|
|
* Sends a mouse wheel zoom change to the parent process, to be handled by
|
|
* the front end as needed.
|
|
*/
|
|
async WheelZoomChange(bool increase);
|
|
|
|
/**
|
|
* Indicate, based on the current state, that some commands are enabled and
|
|
* some are disabled.
|
|
*/
|
|
async EnableDisableCommands(MaybeDiscardedBrowsingContext bc,
|
|
nsString action,
|
|
nsCString[] enabledCommands,
|
|
nsCString[] disabledCommands);
|
|
|
|
nested(inside_cpow) sync GetInputContext() returns (IMEState state);
|
|
|
|
nested(inside_cpow) async SetInputContext(InputContext context,
|
|
InputContextAction action);
|
|
|
|
/**
|
|
* Set the native cursor.
|
|
* @param value
|
|
* The widget cursor to set.
|
|
* @param hasCustomCursor
|
|
* Whether there's any custom cursor represented by cursorData and
|
|
* company.
|
|
* @param customCursorData
|
|
* Serialized image data.
|
|
* @param width
|
|
* Width of the image.
|
|
* @param height
|
|
* Height of the image.
|
|
* @param stride
|
|
* Stride used in the image data.
|
|
* @param format
|
|
* Image format, see gfx::SurfaceFormat for possible values.
|
|
* @param hotspotX
|
|
* Horizontal hotspot of the image, as specified by the css cursor property.
|
|
* @param hotspotY
|
|
* Vertical hotspot of the image, as specified by the css cursor property.
|
|
* @param force
|
|
* Invalidate any locally cached cursor settings and force an
|
|
* update.
|
|
*/
|
|
async SetCursor(nsCursor value,
|
|
bool hasCustomCursor,
|
|
nsCString customCursorData,
|
|
uint32_t width, uint32_t height,
|
|
uint32_t stride, SurfaceFormat format,
|
|
uint32_t hotspotX, uint32_t hotspotY, bool force);
|
|
|
|
/**
|
|
* Used to set the current text of the status tooltip.
|
|
* Nowadays this is only used for link locations on hover.
|
|
*/
|
|
async SetLinkStatus(nsString status);
|
|
|
|
/**
|
|
* Show/hide a tooltip when the mouse hovers over an element in the content
|
|
* document.
|
|
*/
|
|
async ShowTooltip(uint32_t x, uint32_t y, nsString tooltip, nsString direction);
|
|
async HideTooltip();
|
|
|
|
/**
|
|
* Create an asynchronous color picker on the parent side,
|
|
* but don't open it yet.
|
|
*/
|
|
async PColorPicker(nsString title, nsString initialColor);
|
|
|
|
async PFilePicker(nsString aTitle, int16_t aMode);
|
|
|
|
/**
|
|
* Initiates an asynchronous request for one of the special indexedDB
|
|
* permissions for the provided principal.
|
|
*
|
|
* @param principal
|
|
* The principal of the request.
|
|
*
|
|
* NOTE: The principal is untrusted in the parent process. Only
|
|
* principals that can live in the content process should
|
|
* provided.
|
|
*/
|
|
async IndexedDBPermissionRequest(nsIPrincipal aPrincipal) returns (uint32_t permission);
|
|
|
|
/**
|
|
* Tells the containing widget whether the given input block results in a
|
|
* swipe. Should be called in response to a WidgetWheelEvent that has
|
|
* mFlags.mCanTriggerSwipe set on it.
|
|
*/
|
|
async RespondStartSwipeEvent(uint64_t aInputBlockId, bool aStartSwipe);
|
|
|
|
/**
|
|
* Brings up the auth prompt dialog.
|
|
* Called when this is the PBrowserParent for a nested remote iframe.
|
|
* aCallbackId corresponds to an nsIAuthPromptCallback that lives in the
|
|
* root process. It will be passed back to the root process with either the
|
|
* OnAuthAvailable or OnAuthCancelled message.
|
|
*/
|
|
async AsyncAuthPrompt(nsCString uri, nsString realm, uint64_t aCallbackId);
|
|
|
|
/**
|
|
* Look up dictionary by selected word for OSX
|
|
*
|
|
* @param aText The word to look up
|
|
* @param aFontRange Text decoration of aText
|
|
* @param aIsVertical true if vertical layout
|
|
*/
|
|
async LookUpDictionary(nsString aText, FontRange[] aFontRangeArray,
|
|
bool aIsVertical, LayoutDeviceIntPoint aPoint);
|
|
|
|
async __delete__();
|
|
|
|
async ReplyKeyEvent(WidgetKeyboardEvent event);
|
|
|
|
/**
|
|
* Retrieves edit commands for the key combination represented by aEvent.
|
|
*
|
|
* @param aType One of nsIWidget::NativeKeyBindingsType.
|
|
* @param aEvent KeyboardEvent which represents a key combination.
|
|
* Note that this must be a trusted event.
|
|
* @return Array of edit commands which should be executed in
|
|
* editor of native applications.
|
|
*/
|
|
sync RequestNativeKeyBindings(uint32_t aType, WidgetKeyboardEvent aEvent)
|
|
returns (CommandInt[] commands);
|
|
|
|
async SynthesizeNativeKeyEvent(int32_t aNativeKeyboardLayout,
|
|
int32_t aNativeKeyCode,
|
|
uint32_t aModifierFlags,
|
|
nsString aCharacters,
|
|
nsString aUnmodifiedCharacters,
|
|
uint64_t aObserverId);
|
|
async SynthesizeNativeMouseEvent(LayoutDeviceIntPoint aPoint,
|
|
uint32_t aNativeMessage,
|
|
uint32_t aModifierFlags,
|
|
uint64_t aObserverId);
|
|
async SynthesizeNativeMouseMove(LayoutDeviceIntPoint aPoint,
|
|
uint64_t aObserverId);
|
|
async SynthesizeNativeMouseScrollEvent(LayoutDeviceIntPoint aPoint,
|
|
uint32_t aNativeMessage,
|
|
double aDeltaX,
|
|
double aDeltaY,
|
|
double aDeltaZ,
|
|
uint32_t aModifierFlags,
|
|
uint32_t aAdditionalFlags,
|
|
uint64_t aObserverId);
|
|
async SynthesizeNativeTouchPoint(uint32_t aPointerId,
|
|
TouchPointerState aPointerState,
|
|
LayoutDeviceIntPoint aPoint,
|
|
double aPointerPressure,
|
|
uint32_t aPointerOrientation,
|
|
uint64_t aObserverId);
|
|
async SynthesizeNativeTouchTap(LayoutDeviceIntPoint aPoint,
|
|
bool aLongTap,
|
|
uint64_t aObserverId);
|
|
async ClearNativeTouchSequence(uint64_t aObserverId);
|
|
|
|
async AccessKeyNotHandled(WidgetKeyboardEvent event);
|
|
|
|
async RegisterProtocolHandler(nsString scheme, nsIURI handlerURI, nsString title,
|
|
nsIURI documentURI);
|
|
|
|
async OnStateChange(WebProgressData? aWebProgressData,
|
|
RequestData aRequestData, uint32_t aStateFlags,
|
|
nsresult aStatus,
|
|
WebProgressStateChangeData? aStateChangeData);
|
|
|
|
async OnProgressChange(WebProgressData? aWebProgressData,
|
|
RequestData aRequestData, int32_t aCurSelfProgress,
|
|
int32_t aMaxSelfProgress, int32_t aCurTotalProgress,
|
|
int32_t aMaxTotalProgress);
|
|
|
|
async OnLocationChange(WebProgressData? aWebProgressData,
|
|
RequestData aRequestData, nsIURI aLocation,
|
|
uint32_t aFlags, bool aCanGoBack,
|
|
bool aCanGoForward,
|
|
WebProgressLocationChangeData? aLocationChangeData);
|
|
|
|
async OnStatusChange(WebProgressData? aWebProgressData,
|
|
RequestData aRequestData, nsresult aStatus,
|
|
nsString aMessage);
|
|
|
|
async NotifyContentBlockingEvent(uint32_t aEvent, RequestData aRequestData,
|
|
bool aBlocked, nsCString aTrackingOrigin,
|
|
nsCString[] aTrackingFullHashes,
|
|
StorageAccessPermissionGrantedReason? aReason);
|
|
|
|
async NavigationFinished();
|
|
|
|
async SessionStoreUpdate(nsCString? aDocShellCaps, bool? aPrivatedMode,
|
|
nsCString[] aPositions, int32_t[] aPositionDescendants,
|
|
InputFormData[] aInputs, CollectedInputDataValue[] aIdVals,
|
|
CollectedInputDataValue[] aXPathVals,
|
|
nsCString[] aOrigins, nsString[] aKeys,
|
|
nsString[] aValues, bool aIsFullStorage,
|
|
bool aNeedCollectSHistory, uint32_t aFlushId,
|
|
bool aIsFinal, uint32_t aEpoch);
|
|
|
|
async IntrinsicSizeOrRatioChanged(IntrinsicSize? aIntrinsicSize,
|
|
AspectRatio? aIntrinsicRatio);
|
|
|
|
/**
|
|
* Child informs the parent that a pointer lock has requested/released.
|
|
*/
|
|
async RequestPointerLock() returns (nsCString error);
|
|
async ReleasePointerLock();
|
|
|
|
/**
|
|
* Child informs the parent that a pointer capture has requested/released.
|
|
*/
|
|
async RequestPointerCapture(uint32_t aPointerId) returns (bool aSuccess);
|
|
async ReleasePointerCapture(uint32_t aPointerId);
|
|
|
|
child:
|
|
async NativeSynthesisResponse(uint64_t aObserverId, nsCString aResponse);
|
|
async FlushTabState(uint32_t aFlushId, bool aIsFinal);
|
|
async UpdateEpoch(uint32_t aEpoch);
|
|
async UpdateSHistory(bool aImmediately);
|
|
async CloneDocumentTreeIntoSelf(MaybeDiscardedBrowsingContext aBc);
|
|
|
|
/**
|
|
* Parent informs the child to release all pointer capture.
|
|
*/
|
|
async ReleaseAllPointerCapture();
|
|
|
|
parent:
|
|
|
|
/**
|
|
* Child informs the parent that the graphics objects are ready for
|
|
* compositing. This is sent when all pending changes have been
|
|
* sent to the compositor and are ready to be shown on the next composite.
|
|
* @see PCompositor
|
|
* @see RequestNotifyAfterRemotePaint
|
|
*/
|
|
async RemotePaintIsReady();
|
|
|
|
/**
|
|
* Child informs the parent that the content is ready to handle input
|
|
* events. This is sent when the BrowserChild is created.
|
|
*/
|
|
async RemoteIsReadyToHandleInputEvents();
|
|
|
|
/**
|
|
* Child informs the parent that the layer tree is already available.
|
|
*/
|
|
async PaintWhileInterruptingJSNoOp(LayersObserverEpoch aEpoch);
|
|
|
|
child:
|
|
/**
|
|
* Parent informs the child of graphical effects that are being applied
|
|
* to the child browser.
|
|
*/
|
|
async UpdateEffects(EffectsInfo aEffects);
|
|
|
|
parent:
|
|
|
|
/**
|
|
* Sent by the child to the parent to inform it that an update to the
|
|
* dimensions has been requested, likely through win.moveTo or resizeTo
|
|
*/
|
|
async SetDimensions(uint32_t aFlags, int32_t aX, int32_t aY,
|
|
int32_t aCx, int32_t aCy, double aScale);
|
|
|
|
nested(inside_sync) sync DispatchWheelEvent(WidgetWheelEvent event);
|
|
nested(inside_sync) sync DispatchMouseEvent(WidgetMouseEvent event);
|
|
nested(inside_sync) sync DispatchKeyboardEvent(WidgetKeyboardEvent event);
|
|
|
|
async InvokeDragSession(IPCDataTransfer[] transfers, uint32_t action,
|
|
Shmem? visualData,
|
|
uint32_t stride, SurfaceFormat format,
|
|
LayoutDeviceIntRect dragRect,
|
|
nsIPrincipal principal, nsIContentSecurityPolicy csp);
|
|
|
|
// After a compositor reset, it is necessary to reconnect each layers ID to
|
|
// the compositor of the widget that will render those layers. Note that
|
|
// this is sync so we can ensure that messages to the window compositor
|
|
// arrive before the BrowserChild attempts to use its cross-process compositor
|
|
// bridge.
|
|
sync EnsureLayersConnected() returns (CompositorOptions compositorOptions);
|
|
|
|
/**
|
|
* This function is used to notify the parent that it should display a
|
|
* canvas permission prompt.
|
|
*
|
|
* @param aOrigin origin string of the document that is requesting access.
|
|
*/
|
|
async ShowCanvasPermissionPrompt(nsCString aOrigin,
|
|
bool aHideDoorHanger);
|
|
|
|
sync SetSystemFont(nsCString aFontName);
|
|
sync GetSystemFont() returns (nsCString retval);
|
|
|
|
/**
|
|
* Called once this PBrowser's OOP subdoc no longer blocks its
|
|
* embedding element's and embedding doc's 'load' events.
|
|
*/
|
|
async MaybeFireEmbedderLoadEvents(EmbedderElementEventType aFireEventAtEmbeddingElement);
|
|
|
|
async ScrollRectIntoView(nsRect aRect, ScrollAxis aVertical,
|
|
ScrollAxis aHorizontal, ScrollFlags aScrollFlags,
|
|
int32_t aAppUnitsPerDevPixel);
|
|
|
|
async SetAllowDeprecatedTls(bool value);
|
|
|
|
child:
|
|
/**
|
|
* Notify the remote browser that it has been Show()n on this side. This
|
|
* message is expected to trigger creation of the remote browser's "widget".
|
|
*/
|
|
async Show(ParentShowInfo parentInfo, OwnerShowInfo childInfo);
|
|
|
|
/**
|
|
* Sending an activate message moves focus to the child.
|
|
*/
|
|
async Activate();
|
|
|
|
async Deactivate();
|
|
|
|
async ScrollbarPreferenceChanged(ScrollbarPreference pref);
|
|
|
|
async InitRendering(TextureFactoryIdentifier textureFactoryIdentifier,
|
|
LayersId layersId,
|
|
CompositorOptions compositorOptions,
|
|
bool layersConnected);
|
|
|
|
async CompositorOptionsChanged(CompositorOptions newOptions);
|
|
|
|
async LoadURL(nsDocShellLoadState loadState, ParentShowInfo info);
|
|
|
|
async ResumeLoad(uint64_t pendingSwitchID, ParentShowInfo info);
|
|
|
|
async UpdateDimensions(DimensionInfo dimensions) compressall;
|
|
|
|
async SizeModeChanged(nsSizeMode sizeMode);
|
|
|
|
async ChildToParentMatrix(MaybeMatrix4x4 aMatrix,
|
|
ScreenRect aRemoteDocumentRect);
|
|
|
|
async SetIsUnderHiddenEmbedderElement(bool aIsUnderHiddenEmbedderElement);
|
|
|
|
async DynamicToolbarMaxHeightChanged(ScreenIntCoord height);
|
|
|
|
async DynamicToolbarOffsetChanged(ScreenIntCoord height);
|
|
|
|
async ParentActivated(bool aActivated);
|
|
|
|
async SetKeyboardIndicators(UIStateChangeType showFocusRings);
|
|
|
|
/**
|
|
* StopIMEStateManagement() is called when the process loses focus and
|
|
* should stop managing IME state.
|
|
*/
|
|
async StopIMEStateManagement();
|
|
|
|
/**
|
|
* @see nsIDOMWindowUtils sendMouseEvent.
|
|
*/
|
|
async MouseEvent(nsString aType,
|
|
float aX,
|
|
float aY,
|
|
int32_t aButton,
|
|
int32_t aClickCount,
|
|
int32_t aModifiers);
|
|
|
|
/**
|
|
* When two consecutive mouse move events would be added to the message queue,
|
|
* they are 'compressed' by dumping the oldest one.
|
|
*/
|
|
prio(input) async RealMouseMoveEvent(WidgetMouseEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId) compress;
|
|
|
|
async NormalPriorityRealMouseMoveEvent(WidgetMouseEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId) compress;
|
|
|
|
/**
|
|
* Mouse move events with |reason == eSynthesized| are sent via a separate
|
|
* message because they do not generate DOM 'mousemove' events, and the
|
|
* 'compress' attribute on RealMouseMoveEvent() could result in a
|
|
* |reason == eReal| event being dropped in favour of an |eSynthesized|
|
|
* event, and thus a DOM 'mousemove' event to be lost.
|
|
*/
|
|
prio(input) async SynthMouseMoveEvent(WidgetMouseEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
async NormalPrioritySynthMouseMoveEvent(WidgetMouseEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
|
|
prio(input) async RealMouseButtonEvent(WidgetMouseEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
async NormalPriorityRealMouseButtonEvent(WidgetMouseEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
|
|
prio(input) async RealKeyEvent(WidgetKeyboardEvent event);
|
|
async NormalPriorityRealKeyEvent(WidgetKeyboardEvent event);
|
|
|
|
prio(input) async MouseWheelEvent(WidgetWheelEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
async NormalPriorityMouseWheelEvent(WidgetWheelEvent event,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
|
|
prio(input) async RealTouchEvent(WidgetTouchEvent aEvent,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId,
|
|
nsEventStatus aApzResponse);
|
|
async NormalPriorityRealTouchEvent(WidgetTouchEvent aEvent,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId,
|
|
nsEventStatus aApzResponse);
|
|
|
|
prio(input) async HandleTap(GeckoContentController_TapType aType, LayoutDevicePoint point,
|
|
Modifiers aModifiers, ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
async NormalPriorityHandleTap(GeckoContentController_TapType aType, LayoutDevicePoint point,
|
|
Modifiers aModifiers, ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId);
|
|
|
|
prio(input) async RealTouchMoveEvent(WidgetTouchEvent aEvent,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId,
|
|
nsEventStatus aApzResponse) compress;
|
|
async NormalPriorityRealTouchMoveEvent(WidgetTouchEvent aEvent,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId,
|
|
nsEventStatus aApzResponse) compress;
|
|
prio(input) async RealTouchMoveEvent2(WidgetTouchEvent aEvent,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId,
|
|
nsEventStatus aApzResponse) compress;
|
|
async NormalPriorityRealTouchMoveEvent2(WidgetTouchEvent aEvent,
|
|
ScrollableLayerGuid aGuid,
|
|
uint64_t aInputBlockId,
|
|
nsEventStatus aApzResponse) compress;
|
|
|
|
/*
|
|
* We disable the input event queue when there is an active dnd session. We
|
|
* don't need support RealDragEvent with input priority.
|
|
*/
|
|
async RealDragEvent(WidgetDragEvent aEvent, uint32_t aDragAction,
|
|
uint32_t aDropEffect, nsIPrincipal aPrincipal,
|
|
nsIContentSecurityPolicy csp);
|
|
|
|
async PluginEvent(WidgetPluginEvent aEvent);
|
|
|
|
prio(input) async CompositionEvent(WidgetCompositionEvent event);
|
|
async NormalPriorityCompositionEvent(WidgetCompositionEvent event);
|
|
|
|
prio(input) async SelectionEvent(WidgetSelectionEvent event);
|
|
async NormalPrioritySelectionEvent(WidgetSelectionEvent event);
|
|
|
|
/**
|
|
* Call PasteTransferable via a controller on the content process
|
|
* to handle the command content event, "pasteTransferable".
|
|
*/
|
|
async PasteTransferable(IPCDataTransfer aDataTransfer,
|
|
bool aIsPrivateData,
|
|
nsIPrincipal aRequestingPrincipal,
|
|
uint32_t aContentPolicyType);
|
|
|
|
/**
|
|
* Activate event forwarding from client to parent.
|
|
*/
|
|
async ActivateFrameEvent(nsString aType, bool capture);
|
|
|
|
async LoadRemoteScript(nsString aURL, bool aRunInGlobalScope);
|
|
|
|
/**
|
|
* Sent by the chrome process when it no longer wants this remote
|
|
* <browser>. The child side cleans up in response, then
|
|
* finalizing its death by sending back __delete__() to the
|
|
* parent.
|
|
*/
|
|
async Destroy();
|
|
|
|
/**
|
|
* Update the child side docShell active (resource use) state.
|
|
*
|
|
* @param aIsActive
|
|
* Whether to activate or deactivate the docshell.
|
|
* @param aPreserveLayers
|
|
* Whether layer trees should be preserved for inactive docshells.
|
|
*/
|
|
async SetDocShellIsActive(bool aIsActive);
|
|
|
|
/**
|
|
* If aEnabled is true, tells the child to paint and upload layers to
|
|
* the compositor. If aEnabled is false, the child stops painting and
|
|
* clears the layers from the compositor.
|
|
*
|
|
* @param aEnabled
|
|
* True if the child should render and upload layers, false if the
|
|
* child should clear layers.
|
|
* @param aEpoch
|
|
* The layer observer epoch for this activation. This message should be
|
|
* ignored if this epoch has already been observed (via
|
|
* PaintWhileInterruptingJS).
|
|
*/
|
|
async RenderLayers(bool aEnabled, LayersObserverEpoch aEpoch);
|
|
child:
|
|
/**
|
|
* Notify the child that it shouldn't paint the offscreen displayport.
|
|
* This is useful to speed up interactive operations over async
|
|
* scrolling performance like resize, tabswitch, pageload.
|
|
*
|
|
* Each enable call must be matched with a disable call. The child
|
|
* will remain in the suppress mode as long as there's
|
|
* a single unmatched call.
|
|
*/
|
|
async SuppressDisplayport(bool aEnabled);
|
|
|
|
/**
|
|
* Navigate by key (Tab/Shift+Tab/F6/Shift+f6).
|
|
*/
|
|
async NavigateByKey(bool aForward, bool aForDocumentNavigation);
|
|
|
|
/**
|
|
* The parent (chrome thread) requests that the child inform it when
|
|
* the graphics objects are ready to display.
|
|
* @see PCompositor
|
|
* @see RemotePaintIsReady
|
|
*/
|
|
async RequestNotifyAfterRemotePaint();
|
|
|
|
/**
|
|
* Tell the child that the UI resolution changed for the containing
|
|
* window.
|
|
* To avoid some sync messages from child to parent, we also send the dpi
|
|
* and default scale with the notification.
|
|
* If we don't know the dpi and default scale, we just pass in a negative
|
|
* value (-1) but in the majority of the cases this saves us from two
|
|
* sync requests from the child to the parent.
|
|
*/
|
|
async UIResolutionChanged(float dpi, int32_t rounding, double scale);
|
|
|
|
/**
|
|
* Tell the child that the safe area of widget has changed.
|
|
*
|
|
*/
|
|
async SafeAreaInsetsChanged(ScreenIntMargin aSafeAreaInsets);
|
|
|
|
/**
|
|
* Tell the browser that its frame loader has been swapped
|
|
* with another.
|
|
*/
|
|
async SwappedWithOtherRemoteLoader(IPCTabContext context);
|
|
|
|
/**
|
|
* A potential accesskey was just pressed. Look for accesskey targets
|
|
* using the list of provided charCodes.
|
|
*
|
|
* @param event keyboard event
|
|
* @param isTrusted true if triggered by a trusted key event
|
|
*/
|
|
async HandleAccessKey(WidgetKeyboardEvent event,
|
|
uint32_t[] charCodes);
|
|
|
|
/**
|
|
* HandledWindowedPluginKeyEvent() is always called after posting a native
|
|
* key event with OnWindowedPluginKeyEvent().
|
|
*
|
|
* @param aKeyEventData The key event which was posted to the parent
|
|
* process.
|
|
* @param aIsConsumed true if aKeyEventData is consumed in the
|
|
* parent process. Otherwise, false.
|
|
*/
|
|
async HandledWindowedPluginKeyEvent(NativeEventData aKeyEventData,
|
|
bool aIsConsumed);
|
|
|
|
/**
|
|
* Tell the child to create a print preview document in this browser, or
|
|
* to update the existing print preview document with new print settings.
|
|
*
|
|
* @param aPrintData The serialized print settings to use to layout the
|
|
* print preview document.
|
|
* @param aSourceOuterWindowID Optionally, the ID of the nsGlobalWindowOuter
|
|
* that contains the document from which the print preview is to be
|
|
* generated. This should only be passed on the first call. It should
|
|
* not be passed for any subsequent calls that are made to update the
|
|
* existing print preview document with a new print settings object.
|
|
*/
|
|
async PrintPreview(PrintData aPrintData,
|
|
uint64_t? aSourceOuterWindowID) returns (PrintPreviewResultInfo aInfo);
|
|
|
|
/**
|
|
* Inform the print preview document that we're done with it.
|
|
*/
|
|
async ExitPrintPreview();
|
|
|
|
/**
|
|
* Tell the child to print the current page with the given settings.
|
|
*
|
|
* @param aOuterWindowID the ID of the outer window to print
|
|
* @param aPrintData the serialized settings to print with
|
|
*/
|
|
async Print(uint64_t aOuterWindowID, PrintData aPrintData);
|
|
|
|
/**
|
|
* Update the child with the tab's current top-level native window handle.
|
|
* This is used by a11y objects who must expose their native window.
|
|
*
|
|
* @param aNewHandle The native window handle of the tab's top-level window.
|
|
*/
|
|
async UpdateNativeWindowHandle(uintptr_t aNewHandle);
|
|
|
|
/**
|
|
* Tell the BrowserChild to allow scripts in the docshell to close the window.
|
|
*/
|
|
async AllowScriptsToClose();
|
|
|
|
/**
|
|
* Pass the current handle for the current native widget to the content
|
|
* process, so it can be used by PuppetWidget.
|
|
*/
|
|
async SetWidgetNativeData(WindowsHandle aHandle);
|
|
|
|
async WillChangeProcess() returns (bool success);
|
|
|
|
parent:
|
|
/**
|
|
* Fetches whether this window supports protected media, which is sent back in response.
|
|
*/
|
|
async IsWindowSupportingProtectedMedia(uint64_t aOuterWindowID) returns(bool isSupported);
|
|
|
|
/**
|
|
* Fetches whether this window supports WebVR, which is sent back in response.
|
|
*/
|
|
async IsWindowSupportingWebVR(uint64_t aOuterWindowID) returns(bool isSupported);
|
|
|
|
/** Records a history visit. */
|
|
async VisitURI(nsIURI aURI, nsIURI aLastVisitedURI,
|
|
uint32_t aFlags);
|
|
|
|
/** Fetches the visited status for an array of URIs (Android-only). */
|
|
async QueryVisitedState(nsIURI[] aURIs);
|
|
|
|
/**
|
|
* Construct a new WindowGlobal for an existing global in the content process
|
|
*/
|
|
async NewWindowGlobal(ManagedEndpoint<PWindowGlobalParent> aEndpoint,
|
|
WindowGlobalInit aInit);
|
|
|
|
/*
|
|
* FIXME: write protocol!
|
|
|
|
state LIVE:
|
|
send LoadURL goto LIVE;
|
|
//etc.
|
|
send Destroy goto DYING;
|
|
|
|
state DYING:
|
|
discard send blah;
|
|
// etc.
|
|
recv __delete__;
|
|
*/
|
|
};
|
|
|
|
}
|
|
}
|