org.mozilla.geckoview

Class ContentBlocking.Settings.Builder

Object

org.mozilla.geckoview.RuntimeSettings.Builder<ContentBlocking.Settings>

org.mozilla.geckoview.ContentBlocking.Settings.Builder

Enclosing class:

ContentBlocking.Settings

@AnyThread
public static class ContentBlocking.Settings.Builder
extends RuntimeSettings.Builder<ContentBlocking.Settings>

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
ContentBlocking.Settings.Builder	antiTracking(int cat) Set anti-tracking categories.
ContentBlocking.Settings.Builder	cookieBehavior(int behavior) Set cookie storage behavior.
ContentBlocking.Settings.Builder	cookieBehaviorPrivateMode(int behavior) Set cookie storage behavior in private browsing mode.
ContentBlocking.Settings.Builder	cookieLifetime(int lifetime) Set the cookie lifetime.
ContentBlocking.Settings.Builder	cookiePurging(boolean enabled) Set whether or not to automatically purge tracking cookies.
ContentBlocking.Settings.Builder	enhancedTrackingProtectionLevel(int level) Set the ETP behavior level.
protected ContentBlocking.Settings	newSettings(ContentBlocking.Settings settings) Create a default or copy settings object.
ContentBlocking.Settings.Builder	safeBrowsing(int cat) Set safe browsing categories.
ContentBlocking.Settings.Builder	safeBrowsingMalwareTable(String[] safeBrowsingMalwareTable) Set the safe browsing table for malware threats.
ContentBlocking.Settings.Builder	safeBrowsingPhishingTable(String[] safeBrowsingPhishingTable) Set the safe browsing table for phishing threats.
ContentBlocking.Settings.Builder	safeBrowsingProviders(ContentBlocking.SafeBrowsingProvider... providers) Set custom safe browsing providers.
ContentBlocking.Settings.Builder	strictSocialTrackingProtection(boolean enabled) Set whether or not strict social tracking protection is enabled.

Methods inherited from class org.mozilla.geckoview.RuntimeSettings.Builder

build, getSettings

Methods inherited from class Object

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

Constructor Detail

Builder

public Builder()

Method Detail

newSettings

@NonNull
protected ContentBlocking.Settings newSettings(@Nullable
                                                        ContentBlocking.Settings settings)

Description copied from class: RuntimeSettings.Builder

Create a default or copy settings object.

Specified by:

newSettings in class RuntimeSettings.Builder<ContentBlocking.Settings>

Parameters:

settings - Settings object to copy, null for default settings.

Returns:

The constructed settings object.

safeBrowsingProviders

@NonNull
public ContentBlocking.Settings.Builder safeBrowsingProviders(@NonNull
                                                                       ContentBlocking.SafeBrowsingProvider... providers)

Set custom safe browsing providers.

Parameters:

providers - one or more custom providers.

Returns:

This Builder instance.

See Also:

ContentBlocking.SafeBrowsingProvider

safeBrowsingPhishingTable

@NonNull
public ContentBlocking.Settings.Builder safeBrowsingPhishingTable(@NonNull
                                                                           String[] safeBrowsingPhishingTable)

Set the safe browsing table for phishing threats.

Parameters:

safeBrowsingPhishingTable - one or more lists for safe browsing phishing.

Returns:

This Builder instance.

See Also:

ContentBlocking.SafeBrowsingProvider

safeBrowsingMalwareTable

@NonNull
public ContentBlocking.Settings.Builder safeBrowsingMalwareTable(@NonNull
                                                                          String[] safeBrowsingMalwareTable)

Set the safe browsing table for malware threats.

Parameters:

safeBrowsingMalwareTable - one or more lists for safe browsing malware.

Returns:

This Builder instance.

See Also:

ContentBlocking.SafeBrowsingProvider

antiTracking

@NonNull
public ContentBlocking.Settings.Builder antiTracking(int cat)

Set anti-tracking categories.

Parameters:

cat - The categories of resources that should be blocked. Use one or more of the ContentBlocking.AntiTracking flags.

Returns:

This Builder instance.

safeBrowsing

@NonNull
public ContentBlocking.Settings.Builder safeBrowsing(int cat)

Set safe browsing categories.

Parameters:

cat - The categories of resources that should be blocked. Use one or more of the ContentBlocking.SafeBrowsing flags.

Returns:

This Builder instance.

cookieBehavior

@NonNull
public ContentBlocking.Settings.Builder cookieBehavior(int behavior)

Set cookie storage behavior.

Parameters:

behavior - The storage behavior that should be applied. Use one of the ContentBlocking.CookieBehavior flags.

Returns:

The Builder instance.

cookieBehaviorPrivateMode

@NonNull
public ContentBlocking.Settings.Builder cookieBehaviorPrivateMode(int behavior)

Set cookie storage behavior in private browsing mode.

Parameters:

behavior - The storage behavior that should be applied. Use one of the ContentBlocking.CookieBehavior flags.

Returns:

The Builder instance.

cookieLifetime

@NonNull
public ContentBlocking.Settings.Builder cookieLifetime(int lifetime)

Set the cookie lifetime.

Parameters:

lifetime - The enforced cookie lifetime. Use one of the ContentBlocking.CookieLifetime flags.

Returns:

The Builder instance.

enhancedTrackingProtectionLevel

@NonNull
public ContentBlocking.Settings.Builder enhancedTrackingProtectionLevel(int level)

Set the ETP behavior level.

Parameters:

level - The level of ETP blocking to use. Only takes effect if cookie behavior is set to ContentBlocking.CookieBehavior.ACCEPT_NON_TRACKERS or ContentBlocking.CookieBehavior.ACCEPT_FIRST_PARTY_AND_ISOLATE_OTHERS.

Returns:

The Builder instance.

strictSocialTrackingProtection

@NonNull
public ContentBlocking.Settings.Builder strictSocialTrackingProtection(boolean enabled)

Set whether or not strict social tracking protection is enabled. This will block resources from loading if they are on the social tracking protection list, rather than just blocking cookies as with normal social tracking protection.

Parameters:

enabled - A boolean indicating whether or not strict social tracking protection should be enabled.

Returns:

The builder instance.

cookiePurging

@NonNull
public ContentBlocking.Settings.Builder cookiePurging(boolean enabled)

Set whether or not to automatically purge tracking cookies. This will purge cookies from tracking sites that do not have recent user interaction provided that the cookie behavior is set to either ContentBlocking.CookieBehavior.ACCEPT_NON_TRACKERS or ContentBlocking.CookieBehavior.ACCEPT_FIRST_PARTY_AND_ISOLATE_OTHERS.

Parameters:

enabled - A boolean indicating whether or not cookie purging should be enabled.

Returns:

The builder instance.