Package org.mozilla.geckoview

Class WebExtension

Object

org.mozilla.geckoview.WebExtension

public class WebExtension
extends Object

Represents a WebExtension that may be used by GeckoView.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	WebExtension.Action	Represents either a Browser Action or a Page Action from the WebExtension API.
static interface	WebExtension.ActionDelegate	Receives updates whenever a Browser action or a Page action has been defined by an extension.
static @interface	WebExtension.BlocklistState
static class	WebExtension.BlocklistStateFlags	Describes the blocklist state for a WebExtension.
static interface	WebExtension.BrowsingDataDelegate	This delegate is used to handle calls from the |browsingData| WebExtension API.
static @interface	WebExtension.BrowsingDataTypes
static @interface	WebExtension.ContextFlags
static class	WebExtension.CreateTabDetails	Provides details about creating a tab with tabs.create.
static class	WebExtension.DisabledFlags
static class	WebExtension.Download	Represents a download for downloads API Instantiate using WebExtensionController.createDownload(int)
static interface	WebExtension.DownloadDelegate
static class	WebExtension.DownloadInitData	Represents initial information on a download provided to Web Extension
static class	WebExtension.DownloadRequest	Represents Web Extension API specific download request
static @interface	WebExtension.EnabledFlags
static class	WebExtension.Flags
static class	WebExtension.InstallException	Extension thrown when an error occurs during extension installation.
static interface	WebExtension.MessageDelegate	Delegates that responds to messages sent from a WebExtension.
static class	WebExtension.MessageSender	Describes the sender of a message from a WebExtension.
class	WebExtension.MetaData	Provides information about a WebExtension.
static class	WebExtension.Port	Port object that can be used for bidirectional communication with a WebExtension.
static interface	WebExtension.PortDelegate	Delegate that handles communication from a WebExtension on a specific WebExtension.Port instance.
static class	WebExtension.SessionController
static interface	WebExtension.SessionTabDelegate	This delegate is invoked whenever an extension uses the `tabs` WebExtension API to modify the state of a tab.
static @interface	WebExtension.SignedState
static class	WebExtension.SignedStateFlags	Describes the signed status for a WebExtension.
static interface	WebExtension.TabDelegate	This delegate is invoked whenever an extension uses the `tabs` WebExtension API and the request is not specific to an existing tab, e.g.
static class	WebExtension.UpdateTabDetails	Provides details about upating a tab with tabs.update.
static @interface	WebExtension.WebExtensionFlags

Field Summary

Fields

Modifier and Type	Field	Description
final long	flags	WebExtension.Flags for this WebExtension.
final String	id	Unique identifier for this WebExtension
final boolean	isBuiltIn	Whether this extension is built-in.
final String	location	file: or resource: URI that points to the install location of this WebExtension.
final WebExtension.MetaData	metaData	Provides information about this WebExtension.

Method Summary

Modifier and Type	Method	Description
WebExtension.BrowsingDataDelegate	getBrowsingDataDelegate()
WebExtension.DownloadDelegate	getDownloadDelegate()	Get the download delegate for this extension.
WebExtension.TabDelegate	getTabDelegate()	Get the tab delegate for this extension.
void	setActionDelegate(WebExtension.ActionDelegate delegate)	Set the Action delegate for this WebExtension.
void	setBrowsingDataDelegate(WebExtension.BrowsingDataDelegate delegate)
void	setDownloadDelegate(WebExtension.DownloadDelegate delegate)	Set the download delegate for this extension.
void	setMessageDelegate(WebExtension.MessageDelegate messageDelegate, String nativeApp)	Defines the message delegate for a Native App.
void	setTabDelegate(WebExtension.TabDelegate delegate)	Set the tab delegate for this extension.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

location

@NonNull
public final String location

file: or resource: URI that points to the install location of this WebExtension. When the WebExtension is included with the APK the file can be specified using the resource://android alias. E.g.

      resource://android/assets/web_extensions/my_webextension/
 

Will point to folder /assets/web_extensions/my_webextension/ in the APK.

id

@NonNull
public final String id

Unique identifier for this WebExtension

flags

public final long flags

WebExtension.Flags for this WebExtension.

metaData

@NonNull
public final WebExtension.MetaData metaData

Provides information about this WebExtension.

isBuiltIn

public final boolean isBuiltIn

Whether this extension is built-in. Built-in extension can be installed using WebExtensionController.installBuiltIn(java.lang.String).

Method Details

toString

public String toString()

Overrides:

toString in class Object

setMessageDelegate

@UiThread
public void setMessageDelegate(@Nullable
 WebExtension.MessageDelegate messageDelegate,
 @NonNull
 String nativeApp)

Defines the message delegate for a Native App.

This message delegate will receive messages from the background script for the native app specified in nativeApp.

For messages from content scripts, set a session-specific message delegate using WebExtension.SessionController.setMessageDelegate(org.mozilla.geckoview.WebExtension, org.mozilla.geckoview.WebExtension.MessageDelegate, java.lang.String).

See also WebExtensions/Native_messaging

Parameters:

messageDelegate - handles messaging between the WebExtension and the app. To send a message from the WebExtension use the runtime.sendNativeMessage WebExtension API: E.g.

        browser.runtime.sendNativeMessage(nativeApp,
              {message: "Hello from WebExtension!"});
      

For bidirectional communication, use runtime.connectNative. E.g. in a content script:

          let port = browser.runtime.connectNative(nativeApp);
          port.onMessage.addListener(message => {
              console.log("Message received from app");
          });
          port.postMessage("Ping from WebExtension");
      

The code above will trigger a WebExtension.MessageDelegate.onConnect(org.mozilla.geckoview.WebExtension.Port) call that will contain the corresponding WebExtension.Port object that can be used to send messages to the WebExtension. Note: the nativeApp specified in the WebExtension needs to match the nativeApp parameter of this method.

You can unset the message delegate by setting a null messageDelegate.

nativeApp - which native app id this message delegate will handle messaging for. Needs to match the application parameter of runtime.sendNativeMessage and runtime.connectNative.

See Also:

• WebExtension.SessionController.setMessageDelegate(org.mozilla.geckoview.WebExtension, org.mozilla.geckoview.WebExtension.MessageDelegate, java.lang.String)

getTabDelegate

@UiThread
@Nullable
public WebExtension.TabDelegate getTabDelegate()

Get the tab delegate for this extension.

See also WebExtensions/API/tabs.

Returns:

The WebExtension.TabDelegate instance for this extension.

setTabDelegate

@UiThread
public void setTabDelegate(@Nullable
 WebExtension.TabDelegate delegate)

Set the tab delegate for this extension. This delegate will be invoked whenever this extension tries to modify the tabs state using the `tabs` WebExtension API.

See also WebExtensions/API/tabs.

Parameters:

delegate - the WebExtension.TabDelegate instance for this extension.

getBrowsingDataDelegate

@UiThread
@Nullable
public WebExtension.BrowsingDataDelegate getBrowsingDataDelegate()

setBrowsingDataDelegate

@UiThread
public void setBrowsingDataDelegate(@Nullable
 WebExtension.BrowsingDataDelegate delegate)

setActionDelegate

@AnyThread
public void setActionDelegate(@Nullable
 WebExtension.ActionDelegate delegate)

Set the Action delegate for this WebExtension.

This delegate will receive updates every time the default Action value changes.

To listen for GeckoSession-specific updates, use WebExtension.SessionController.setActionDelegate(org.mozilla.geckoview.WebExtension, org.mozilla.geckoview.WebExtension.ActionDelegate)

Parameters:

delegate - WebExtension.ActionDelegate that will receive updates.

setDownloadDelegate

@UiThread
public void setDownloadDelegate(@Nullable
 WebExtension.DownloadDelegate delegate)

Set the download delegate for this extension. This delegate will be invoked whenever this extension tries to use the `downloads` WebExtension API.

See also WebExtensions/API/downloads.

Parameters:

delegate - the WebExtension.DownloadDelegate instance for this extension.

getDownloadDelegate

@UiThread
@Nullable
public WebExtension.DownloadDelegate getDownloadDelegate()

Get the download delegate for this extension.

See also WebExtensions downloads API.

Returns:

The WebExtension.DownloadDelegate instance for this extension.